AccessibilityNodeProviderCompat

Kotlin |Java

open class AccessibilityNodeProviderCompat

kotlin.Any
↳	androidx.core.view.accessibility.AccessibilityNodeProviderCompat

Helper for accessing android.view.accessibility.AccessibilityNodeProvider.

Summary

Constants
static Int	HOST_VIEW_ID The virtual id for the hosting View.

Public constructors
<init>() Creates a new instance.
<init>(provider: Any!) Creates a new instance wrapping an android.view.accessibility.AccessibilityNodeProvider.

Public methods
open Unit	addExtraDataToAccessibilityNodeInfo(virtualViewId: Int, @NonNull info: AccessibilityNodeInfoCompat, @NonNull extraDataKey: String, @Nullable arguments: Bundle?) Adds extra data to an AccessibilityNodeInfoCompat based on an explicit request for the additional data.
open AccessibilityNodeInfoCompat?	createAccessibilityNodeInfo(virtualViewId: Int) Returns an AccessibilityNodeInfoCompat representing a virtual view, i.
open MutableList<AccessibilityNodeInfoCompat!>?	findAccessibilityNodeInfosByText(text: String!, virtualViewId: Int) Finds AccessibilityNodeInfoCompats by text.
open AccessibilityNodeInfoCompat?	findFocus(focus: Int) Find the virtual view, i.
open Any!	getProvider()
open Boolean	performAction(virtualViewId: Int, action: Int, arguments: Bundle!) Performs an accessibility action on a virtual view, i.

Constants

HOST_VIEW_ID

static val HOST_VIEW_ID: Int

The virtual id for the hosting View.

Value: -1

Public constructors

<init>

AccessibilityNodeProviderCompat()

Creates a new instance.

<init>

AccessibilityNodeProviderCompat(provider: Any!)

Creates a new instance wrapping an android.view.accessibility.AccessibilityNodeProvider.

Parameters
provider	Any!: The provider.

Public methods

addExtraDataToAccessibilityNodeInfo

open fun addExtraDataToAccessibilityNodeInfo(
    virtualViewId: Int, 
    @NonNull info: AccessibilityNodeInfoCompat, 
    @NonNull extraDataKey: String, 
    @Nullable arguments: Bundle?
): Unit

Adds extra data to an AccessibilityNodeInfoCompat based on an explicit request for the additional data.

This method only needs to be implemented if a virtual view offers to provide additional data.

Parameters
virtualViewId	Int: The virtual view id used to create the node
info	AccessibilityNodeInfoCompat: The info to which to add the extra data
extraDataKey	String: A key specifying the type of extra data to add to the info. The extra data should be added to the Bundle returned by the info's AccessibilityNodeInfoCompat#getExtras method.
arguments	Bundle?: A Bundle holding any arguments relevant for this request.

See Also

• AccessibilityNodeInfo#setAvailableExtraData(List)

createAccessibilityNodeInfo

@Nullable open fun createAccessibilityNodeInfo(virtualViewId: Int): AccessibilityNodeInfoCompat?

Returns an AccessibilityNodeInfoCompat representing a virtual view, i.e. a descendant of the host View, with the given virtualViewId or the host View itself if virtualViewId equals to HOST_VIEW_ID.

A virtual descendant is an imaginary View that is reported as a part of the view hierarchy for accessibility purposes. This enables custom views that draw complex content to report them selves as a tree of virtual views, thus conveying their logical structure.

The implementer is responsible for obtaining an accessibility node info from the pool of reusable instances and setting the desired properties of the node info before returning it.

Parameters
virtualViewId	Int: A client defined virtual view id.

Return
AccessibilityNodeInfoCompat?	A populated AccessibilityNodeInfoCompat for a virtual descendant or the host View.

See Also

• AccessibilityNodeInfoCompat

findAccessibilityNodeInfosByText