View.AccessibilityDelegate 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此类表示可以在一个 View 委托中注册,以通过组合而不是通过继承来增强辅助功能支持。
[Android.Runtime.Register("android/view/View$AccessibilityDelegate", DoNotGenerateAcw=true)]
public class View.AccessibilityDelegate : Java.Lang.Object
[<Android.Runtime.Register("android/view/View$AccessibilityDelegate", DoNotGenerateAcw=true)>]
type View.AccessibilityDelegate = class
inherit Object
- 继承
- 属性
注解
此类表示可以在一个 View 委托中注册,以通过组合而不是通过继承来增强辅助功能支持。 它专门针对扩展基本视图类(即 package android.view 中的类)的小组件开发人员,这些类希望其应用程序向后兼容。
<div class=“special reference”><h3>Developer Guides</h3>
有关使应用程序易于访问的详细信息,请阅读 辅助功能 开发人员指南。
</Div>
开发人员希望使用辅助功能委托的方案是替代在更高 API 版本中引入的方法,而不是应用程序支持的最小 API 版本。 例如,首次引入辅助功能 API 时,该方法 View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo) 在 API 版本 4 中不可用。 如果开发人员希望其应用程序在 API 版本 4 设备上运行(假设应用程序使用的其他所有 API 都是版本 4 或更低版本),并利用此方法,而不是重写会破坏应用程序的向后兼容性的方法,则可以覆盖此委托中的相应方法,并在目标视图中注册委托(如果系统的 API 版本足够高,请在目标视图中注册委托), 即 API 版本与引入 View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)的 API 版本相同或更高。
下面是一个示例实现:
<pre><p> if (Build.VERSION.SDK_INT >= 14) { // If the API version is equal of higher than the version in // which onInitializeAccessibilityNodeInfo was introduced we // register a delegate with a customized implementation. View view = findViewById(R.id.view_id); view.setAccessibilityDelegate(new AccessibilityDelegate() { public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) { // Let the default implementation populate the info. super.onInitializeAccessibilityNodeInfo(host, info); // Set some other information. info.setEnabled(host.isEnabled()); } }); }
</pre></p>
此委托包含与 View 中的辅助功能方法相对应的方法。 如果指定了委托,则 View 中的实现将处理移交给此委托中的相应方法。 对于未设置辅助功能委托的情况,委托方法的默认实现的行为与 View 中的相应方法完全相同。 因此,若要自定义 View 方法的行为,客户端只能重写相应的委托方法,而无需更改主机视图的其余辅助功能相关方法的行为。
<strong Note:>/strong<> On platform versions beforeandroid.os.Build.VERSION_CODES#M API 23, delegate methods on the views in the android.widget.* package are called before host methods. 这样可以防止某些属性(如类名)被重写 AccessibilityDelegate#onInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfo)修改,因为主机类将覆盖任何更改。
从
Java文档android.view.View.AccessibilityDelegate。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| View.AccessibilityDelegate() |
初始化 View.AccessibilityDelegate 的新实例。 |
| View.AccessibilityDelegate(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
此类表示可以在一个 |
| JniPeerMembers |
获取用于 Android 绑定运行时的.NET使用的 JNI 对等元数据。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
获取.NET用于 Android 绑定运行时的 JNI 类句柄。 |
| ThresholdType |
获取 android 绑定运行时.NET使用的托管类型。 |
方法
| 名称 | 说明 |
|---|---|
| AddExtraDataToAccessibilityNodeInfo(View, AccessibilityNodeInfo, String, Bundle) |
将请求的辅助功能数据添加到辅助功能节点。 |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
此类表示可以在一个 |
| DispatchPopulateAccessibilityEvent(View, AccessibilityEvent) |
先向主机 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
此类表示可以在一个 |
| Equals(Object) |
此类表示可以在一个 |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetAccessibilityNodeProvider(View) |
获取用于管理此视图的虚拟视图层次结构的提供程序,并将其报告为 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| OnInitializeAccessibilityEvent(View, AccessibilityEvent) |
使用 |
| OnInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfo) |
使用有关主机视图的信息初始化。 |
| OnPopulateAccessibilityEvent(View, AccessibilityEvent) |
使主机视图有机会使用其文本内容填充辅助功能事件。 |
| OnRequestSendAccessibilityEvent(ViewGroup, View, AccessibilityEvent) |
当主机视图的子级请求发送 |
| PerformAccessibilityAction(View, Action, Bundle) |
对视图执行指定的辅助功能操作。 |
| PerformAccessibilityAction(View, GlobalAction, Bundle) |
已过时.
对视图执行指定的辅助功能操作。 |
| SendAccessibilityEvent(View, EventTypes) |
发送给定类型的辅助功能事件。 |
| SendAccessibilityEventUnchecked(View, AccessibilityEvent) |
发送辅助功能事件。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
此类表示可以在一个 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
此类表示可以在一个 |
| IJavaPeerable.Finalized() |
此类表示可以在一个 |
| IJavaPeerable.JniObjectReferenceControlBlock |
此类表示可以在一个 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
此类表示可以在一个 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
此类表示可以在一个 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
此类表示可以在一个 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
此类表示可以在一个 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |