to top
Android APIs
public class

AccessibilityNodeProviderCompat

extends Object
java.lang.Object
   ↳ android.support.v4.view.accessibility.AccessibilityNodeProviderCompat

Class Overview

Helper for accessing AccessibilityNodeProvider introduced after API level 4 in a backwards compatible fashion.

Summary

Public Constructors
AccessibilityNodeProviderCompat()
Creates a new instance.
AccessibilityNodeProviderCompat(Object provider)
Creates a new instance wrapping an AccessibilityNodeProvider.
Public Methods
AccessibilityNodeInfoCompat createAccessibilityNodeInfo(int virtualViewId)
Returns an AccessibilityNodeInfoCompat representing a virtual view, i.e.
List<AccessibilityNodeInfoCompat> findAccessibilityNodeInfosByText(String text, int virtualViewId)
AccessibilityNodeInfoCompat findFocus(int focus)
Find the virtual view, i.e.
Object getProvider()
boolean performAction(int virtualViewId, int action, Bundle arguments)
Performs an accessibility action on a virtual view, i.e.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public AccessibilityNodeProviderCompat ()

Creates a new instance.

public AccessibilityNodeProviderCompat (Object provider)

Creates a new instance wrapping an AccessibilityNodeProvider.

Parameters
provider The provider.

Public Methods

public AccessibilityNodeInfoCompat createAccessibilityNodeInfo (int virtualViewId)

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 NO_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 A client defined virtual view id.
Returns

public List<AccessibilityNodeInfoCompat> findAccessibilityNodeInfosByText (String text, int virtualViewId)

Finds AccessibilityNodeInfoCompats by text. The match is case insensitive containment. The search is relative to the virtual view, i.e. a descendant of the host View, with the given virtualViewId or the host View itself virtualViewId equals to NO_ID.

Parameters
text The searched text.
virtualViewId A client defined virtual view id which defined the root of the tree in which to perform the search.
Returns
  • A list of node info.

public AccessibilityNodeInfoCompat findFocus (int focus)

Find the virtual view, i.e. a descendant of the host View, that has the specified focus type.

Parameters
focus The focus to find. One of FOCUS_INPUT or FOCUS_ACCESSIBILITY.
Returns
  • The node info of the focused view or null.

public Object getProvider ()

Returns

public boolean performAction (int virtualViewId, int action, Bundle arguments)

Performs an accessibility action on a virtual view, i.e. a descendant of the host View, with the given virtualViewId or the host View itself if virtualViewId equals to NO_ID.

Parameters
virtualViewId A client defined virtual view id.
action The action to perform.
arguments Optional arguments.
Returns
  • True if the action was performed.