View.AccessibilityLiveRegion 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
會看到這個視角的即時區域模式。
public virtual Android.Views.AccessibilityLiveRegion AccessibilityLiveRegion { [Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")] get; [Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")] set; }[<get: Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")>]
[<set: Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")>]
member this.AccessibilityLiveRegion : Android.Views.AccessibilityLiveRegion with get, set屬性值
視圖的即時區域模式。
- 屬性
備註
財產取得者文件：
會看到這個視角的即時區域模式。
的 android.view.View.getAccessibilityLiveRegion()Java 檔。
屬性設定文件：
設定此視角的即時區域模式。 這指示無障礙服務是否應該自動通知使用者檢視內容描述或文字的變更，或是檢視子節點的內容描述或文字（如適用）。
有不同的優先權等級： <ul><li>#ACCESSIBILITY_LIVE_REGION_POLITE：表示該區域的更新應該呈現給使用者。 大多數情況下，適合在應用程式內容中進行顯著的更新，且不需要使用者立即關注。
</li><li>#ACCESSIBILITY_LIVE_REGION_ASSERTIVE：表示該區域的更新優先權最高，應立即呈現給使用者。 這可能導致無障礙服務發出干擾性通知，可能中斷其他回饋或使用者操作，因此通常應僅用於關鍵且時間敏感的資訊。
</li><li>#ACCESSIBILITY_LIVE_REGION_NONE：關閉變更公告（大多數觀看次數的預設）。
</li></ul>
範例： <ul><li> 在下拉選單中選擇選項，會更新下方面板並更新更新內容。 此面板可能標示為即時區域 #ACCESSIBILITY_LIVE_REGION_POLITE ，以通知用戶變更。 螢幕閱讀器可能會將變更排成不干擾對話的公告。
</li><li> 可能會標示緊急 #ACCESSIBILITY_LIVE_REGION_ASSERTIVE 警報，立即通知使用者緊急狀況。
</li></ul>
對於錯誤通知，例如登入畫面出現的「密碼錯誤」警告，檢視應該會傳送 AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGEDAccessibilityEvent 包含內容變更類型 AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR 並設定 AccessibilityNodeInfo#setError(CharSequence)的 。 自訂小工具應提供支援無障礙的錯誤設定方法。 例如，使用 android.widget.TextView#setError(CharSequence) 而非明確傳送事件。
不要用即時區域來頻繁更新 UI 元素（例如進度條），因為這會讓使用者因為無障礙服務的反饋而感到不堪負荷。 如有需要，可用 AccessibilityNodeInfo#setMinDurationBetweenContentChanges(Duration) 來限制回饋並減少干擾。
<旁白><b>註：</b> 用於 androidx.core.view.ViewCompat#setAccessibilityLiveRegion(View, int) 向下相容。
</旁白>
的 android.view.View.setAccessibilityLiveRegion(int)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。