语言

View.AccessibilityDelegate 类

定义

此类表示可以在一个 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.AccessibilityDelegate
特性

注解

此类表示可以在一个 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 方法的行为,客户端只能重写相应的委托方法,而无需更改主机视图的其余辅助功能相关方法的行为。

注意:在之前的android.os.Build.VERSION_CODES#M API 23平台版本中,在主机方法之前调用包中android.widget.*视图的委托方法。 这样可以防止某些属性(如类名)被重写 AccessibilityDelegate#onInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfo)修改,因为主机类将覆盖任何更改。

从 /> 开始,委托方法在主机方法之后调用,这些方法将在主机方法 后 进行修改,而不会被主机类覆盖。 “注意”>注意: 使用 <c>androidx.core.view.AccessibilityDelegateCompat</c> 包装器而不是此类实现向后兼容性。 </aside>

Java文档android.view.View.AccessibilityDelegate。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
View.AccessibilityDelegate()

初始化 View.AccessibilityDelegate 的新实例。

View.AccessibilityDelegate(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
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)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
DispatchPopulateAccessibilityEvent(View, AccessibilityEvent)

先向主机AccessibilityEvent调度一个View,然后调度到其子级,以便将其文本内容添加到事件。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetAccessibilityNodeProvider(View)

获取用于管理此视图的虚拟视图层次结构的提供程序,并将其报告为 android.accessibilityservice.AccessibilityService浏览窗口内容的提供程序。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
OnInitializeAccessibilityEvent(View, AccessibilityEvent)

使用 AccessibilityEvent 有关作为事件源的主机视图的信息初始化。

OnInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfo)

使用有关主机视图的信息初始化。AccessibilityNodeInfo

OnPopulateAccessibilityEvent(View, AccessibilityEvent)

使主机视图有机会使用其文本内容填充辅助功能事件。

OnRequestSendAccessibilityEvent(ViewGroup, View, AccessibilityEvent)

当主机视图的子级请求发送 AccessibilityEvent 并有机会让父级(主机)增加事件时调用。

PerformAccessibilityAction(View, Action, Bundle)

对视图执行指定的辅助功能操作。

PerformAccessibilityAction(View, GlobalAction, Bundle)
已过时.

对视图执行指定的辅助功能操作。

SendAccessibilityEvent(View, EventTypes)

发送给定类型的辅助功能事件。

SendAccessibilityEventUnchecked(View, AccessibilityEvent)

发送辅助功能事件。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于