View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
向 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
参数
事件。
返回
如此 如果事件填充已完成。
- 特性
注解
向 AccessibilityEvent 调度一个View以添加视图及其子级的文本内容。
注意: 此方法应仅用于 event.setText()。 避免在此方法中改变其他事件状态。 通常,在节点中放置 UI 元数据,以便服务轻松查询。
<ul><li> 如果要修改其他事件属性,则可能要消除语义辅助功能服务。 而是使用 #sendAccessibilityEvent(int) 和重写 #onInitializeAccessibilityEvent(AccessibilityEvent)单独发送事件。
</li li><>如果你正在检查类型AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED以生成窗口/游戏公告,则可能会导致中断性公告(或根本没有公告)。 请遵循上述 View#announceForAccessibility(CharSequence)做法。
注意: 这不是建议调用 announceForAccessibility(),而是使用文档中列出的建议。
</li li><>如果你正在根据辅助功能的状态进行更改,例如检查事件类型以触发 UI 更新,而意图良好,则你正在创建适用于某些用户但不适用于其他用户的脆弱、维护较少的代码。 相反,利用现有代码获得公平体验和更少的技术债务。 有关示例,请参阅 AccessibilityManager#isEnabled() 。
</li></ul>
请注意,事件文本在单独的调度路径(#onPopulateAccessibilityEvent(AccessibilityEvent))中填充,因为我们不仅添加到事件中的源文本,而且填充了其所有后代的文本。
典型的实现将调用 #onPopulateAccessibilityEvent(AccessibilityEvent) 此视图,然后调用 #dispatchPopulateAccessibilityEvent(AccessibilityEvent) 每个子级或可见的第一个子级。 如果需要事件文本内容的自定义填充,请重写此方法。
如果已通过调用AccessibilityDelegate指定,#setAccessibilityDelegate(AccessibilityDelegate)则它AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent)负责处理此调用。
如果此视图设置 #isAccessibilityDataSensitive() ,则此视图应仅将敏感信息追加到同时设置 AccessibilityEvent#isAccessibilityDataSensitive()的事件。
注意: 不调度某些类型的辅助功能事件,以便通过此方法填充事件文本。 有关详细信息, AccessibilityEvent请参阅 。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。