語言

View.AnnounceForAccessibility 方法

定義

命名空間:
Android.Views
組件:
Mono.Android.dll

多載

名稱 Description
AnnounceForAccessibility(ICharSequence)

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。
AnnounceForAccessibility(String)

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。

AnnounceForAccessibility(ICharSequence)

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。

[Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")]
public virtual void AnnounceForAccessibility(Java.Lang.ICharSequence? text);
[<Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")>]
abstract member AnnounceForAccessibility : Java.Lang.ICharSequence -> unit
override this.AnnounceForAccessibility : Java.Lang.ICharSequence -> unit

參數

text
ICharSequence

公告簡訊。

屬性
RegisterAttribute

備註

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。

注意：此 API 產生的事件不具語意意義，僅在特殊情況下適用。 應用程式通常可以透過準確提供使用者介面的語意來達成無障礙行為。 他們不應該明確說明要向使用者宣布什麼。

一般來說，只宣告轉換，不要對像按鍵這種簡單動作產生確認訊息。 請簡潔且精確地標示你的控制項，對於重大的使用者介面變更，例如視窗變更、使用 android.app.Activity#setTitle(CharSequence)#setAccessibilityPaneTitle(CharSequence)和 。

用來 #setAccessibilityLiveRegion(int) 通知使用者介面中關鍵檢視的變更。 這些訊息仍應謹慎使用，因為每次檢視更新時可能會產生公告。

若通知使用者錯誤，例如登入畫面顯示「密碼錯誤」通知，該視圖應該會傳送類型為 AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR 和 set AccessibilityNodeInfo#setError(CharSequence) 的 AccessibilityEvent。 自訂小工具應該會自動提供支援無障礙功能的錯誤設定方法。 例如，使用 TextView 時，不要明確傳送此事件，而是使用 android.widget.TextView#setError(CharSequence)。

用於 #setStateDescription(CharSequence) 傳達使用者介面中視圖的狀態變更。 雖然一個活區域可能會傳送由視圖產生的不同類型的事件，但狀態描述會傳送 AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED 類型 AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION為 的事件。

的 android.view.View.announceForAccessibility(java.lang.CharSequence)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

AnnounceForAccessibility(String)

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。

public void AnnounceForAccessibility(string? text);
member this.AnnounceForAccessibility : string -> unit

參數

text
String

公告簡訊。

備註

發送便利 AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent 方法，建議無障礙服務向使用者公告指定文字。

注意：此 API 產生的事件不具語意意義，僅在特殊情況下適用。 應用程式通常可以透過準確提供使用者介面的語意來達成無障礙行為。 他們不應該明確說明要向使用者宣布什麼。

一般來說，只宣告轉換，不要對像按鍵這種簡單動作產生確認訊息。 請簡潔且精確地標示你的控制項，對於重大的使用者介面變更，例如視窗變更、使用 android.app.Activity#setTitle(CharSequence)#setAccessibilityPaneTitle(CharSequence)和 。

用來 #setAccessibilityLiveRegion(int) 通知使用者介面中關鍵檢視的變更。 這些訊息仍應謹慎使用，因為每次檢視更新時可能會產生公告。

若通知使用者錯誤，例如登入畫面顯示「密碼錯誤」通知，該視圖應該會傳送類型為 AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR 和 set AccessibilityNodeInfo#setError(CharSequence) 的 AccessibilityEvent。 自訂小工具應該會自動提供支援無障礙功能的錯誤設定方法。 例如，使用 TextView 時，不要明確傳送此事件，而是使用 android.widget.TextView#setError(CharSequence)。

用於 #setStateDescription(CharSequence) 傳達使用者介面中視圖的狀態變更。 雖然一個活區域可能會傳送由視圖產生的不同類型的事件，但狀態描述會傳送 AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED 類型 AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION為 的事件。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於