View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) 方法

定義

命名空間:

Android.Views

組件:

Mono.Android.dll

派遣 an AccessibilityEvent 到 以 View 新增檢視及其子節點的文字內容。

[Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")]
public virtual bool DispatchPopulateAccessibilityEvent(Android.Views.Accessibility.AccessibilityEvent? e);

[<Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")>]
abstract member DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool
override this.DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool

參數

e

AccessibilityEvent

事件。

傳回

Boolean

如果事件人口已經完成，這點是真的。

屬性

RegisterAttribute

備註

派遣 an AccessibilityEvent 到 以 View 新增檢視及其子節點的文字內容。

<b>注意：</b> 此方法僅應用於 event.setText（）。 避免在此方法中突變其他事件狀態。 一般來說，在節點放置 UI 元資料，方便服務查詢。 <ul><li> 如果你正在修改其他事件屬性，可能會排除服務可能要求的語意。 相反地，請用 並#sendAccessibilityEvent(int)#onInitializeAccessibilityEvent(AccessibilityEvent)覆蓋 發送一個獨立事件。 </li><li>如果你在檢查字體 AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED 來產生視窗/標題公告，可能會造成干擾性的公告（或根本沒有公告）。 相反地，請遵循文中 View#announceForAccessibility(CharSequence)所述的做法。 <b>注意：</b> 這並不建議呼叫 announceForAccessibility（），而是使用其文件中列出的建議。 </li><li>如果你根據無障礙狀態做改動，例如檢查事件類型觸發 UI 更新，雖然出於好意，你其實是在創造脆弱且維護較差的程式碼，對某些使用者有效，對其他人則無效。 相反地，利用現有程式碼來獲得公平的體驗，並減少技術債務。 請參考 AccessibilityManager#isEnabled() 範例。 </li></ul>

請注意，事件文本會被填充在獨立的派遣路徑（#onPopulateAccessibilityEvent(AccessibilityEvent)），因為我們不僅加入了原始碼的文字，還會加入所有後代的文字。

典型的實作會呼叫#onPopulateAccessibilityEvent(AccessibilityEvent)此視圖，然後對每個子節點或第一個可見子節點呼叫。#dispatchPopulateAccessibilityEvent(AccessibilityEvent) 如果需要自訂事件文字內容的人口，則可覆寫此方法。

如果 是 AccessibilityDelegate 透過呼叫 #setAccessibilityDelegate(AccessibilityDelegate) 指定，則 AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent) 負責處理此呼叫。

若此視圖設定， #isAccessibilityDataSensitive() 則該視圖僅應將敏感資訊附加於同樣設定 AccessibilityEvent#isAccessibilityDataSensitive()的事件。

<em>注意：</em> 某些類型的無障礙事件不會被派遣以使用此方法填充事件文本。 如需詳細資訊， AccessibilityEvent請參閱 。

Java 文件 android.view.View.dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。