# Print output for @column tags ?> AccessibilityEvent - Android SDK | Android Developers
Developer Console

Most visited

Recently visited

Results for

AccessibilityEvent

public final class AccessibilityEvent
extends AccessibilityRecord implements Parcelable

java.lang.Object
   ↳ android.view.accessibility.AccessibilityRecord
     ↳ android.view.accessibility.AccessibilityEvent

This class represents accessibility events that are sent by the system when something notable happens in the user interface. For example, when a Button is clicked, a View is focused, etc.

An accessibility event is fired by an individual view which populates the event with data for its state and requests from its parent to send the event to interested parties. The parent can optionally modify or even block the event based on its broader understanding of the user interface's context.

The main purpose of an accessibility event is to communicate changes in the UI to an AccessibilityService. The service may then inspect, if needed the user interface by examining the View hierarchy, as represented by a tree of AccessibilityNodeInfos (snapshot of a View state) which can be used for exploring the window content. Note that the privilege for accessing an event's source, thus the window content, has to be explicitly requested. For more details refer to AccessibilityService. If an accessibility service has not requested to retrieve the window content the event will not contain reference to its source. Also for events of type TYPE_NOTIFICATION_STATE_CHANGED the source is never available.

This class represents various semantically different accessibility event types. Each event type has an associated set of related properties. In other words, each event type is characterized via a subset of the properties exposed by this class. For each event type there is a corresponding constant defined in this class. Follows a specification of the event types and their associated properties:

Developer Guides

For more information about creating and processing AccessibilityEvents, read the Accessibility developer guide.

VIEW TYPES

View clicked - represents the event of clicking on a View like Button, CompoundButton, etc.
Type:TYPE_VIEW_CLICKED
Properties:

View long clicked - represents the event of long clicking on a View like Button, CompoundButton, etc
Type:TYPE_VIEW_LONG_CLICKED
Properties:

View selected - represents the event of selecting an item usually in the context of an AdapterView.
Type: TYPE_VIEW_SELECTED
Properties:

View focused - represents the event of focusing a View.
Type: TYPE_VIEW_FOCUSED
Properties:

View text changed - represents the event of changing the text of an EditText.
Type: TYPE_VIEW_TEXT_CHANGED
Properties:

View text selection changed - represents the event of changing the text selection of an EditText.
Type: TYPE_VIEW_TEXT_SELECTION_CHANGED
Properties:

View text traversed at movement granularity - represents the event of traversing the text of a view at a given granularity. For example, moving to the next word.
Type: TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY
Properties:

View scrolled - represents the event of scrolling a view.
Type: TYPE_VIEW_SCROLLED
Properties:

TRANSITION TYPES

Window state changed - represents the event of a change to a section of the user interface that is visually distinct. Should be sent from either the root view of a window or from a view that is marked as a pane View.setAccessibilityPaneTitle(CharSequence). Not that changes to true windows are represented by TYPE_WINDOWS_CHANGED.
Type: TYPE_WINDOW_STATE_CHANGED
Properties:

Window content changed - represents the event of change in the content of a window. This change can be adding/removing view, changing a view size, etc.

Type: TYPE_WINDOW_CONTENT_CHANGED
Properties:

Windows changed - represents a change in the windows shown on the screen such as a window appeared, a window disappeared, a window size changed, a window layer changed, etc. These events should only come from the system, which is responsible for managing windows. The list of windows is available from AccessibilityService.getWindows(). For regions of the user interface that are presented as windows but are controlled by an app's process, use TYPE_WINDOW_STATE_CHANGED.
Type: TYPE_WINDOWS_CHANGED
Properties:

Note: You can retrieve the AccessibilityWindowInfo for the window source of the event by looking through the list returned by AccessibilityService.getWindows() for the window whose ID matches AccessibilityRecord.getWindowId().

NOTIFICATION TYPES

Notification state changed - represents the event showing a transient piece of information to the user. This information may be a Notification or Toast.
Type: TYPE_NOTIFICATION_STATE_CHANGED
Properties:

EXPLORATION TYPES

View hover enter - represents the event of beginning to hover over a View. The hover may be generated via exploring the screen by touch or via a pointing device.
Type: TYPE_VIEW_HOVER_ENTER
Properties:

View hover exit - represents the event of stopping to hover over a View. The hover may be generated via exploring the screen by touch or via a pointing device.
Type: TYPE_VIEW_HOVER_EXIT
Properties:

Touch interaction start - represents the event of starting a touch interaction, which is the user starts touching the screen.
Type: TYPE_TOUCH_INTERACTION_START
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

Touch interaction end - represents the event of ending a touch interaction, which is the user stops touching the screen.
Type: TYPE_TOUCH_INTERACTION_END
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

Touch exploration gesture start - represents the event of starting a touch exploring gesture.
Type: TYPE_TOUCH_EXPLORATION_GESTURE_START
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

Touch exploration gesture end - represents the event of ending a touch exploring gesture.
Type: TYPE_TOUCH_EXPLORATION_GESTURE_END
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

Touch gesture detection start - represents the event of starting a user gesture detection.
Type: TYPE_GESTURE_DETECTION_START
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

Touch gesture detection end - represents the event of ending a user gesture detection.
Type: TYPE_GESTURE_DETECTION_END
Properties:

Note: This event is fired only by the system and is not passed to the view tree to be populated.

MISCELLANEOUS TYPES

Announcement - represents the event of an application requesting a screen reader to make an announcement. Because the event carries no semantic meaning, this event is appropriate only in exceptional situations where additional screen reader output is needed but other types of accessibility services do not need to be aware of the change.
Type: TYPE_ANNOUNCEMENT
Properties:

See also:

Summary

Constants

int CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The node's content description changed.

int CONTENT_CHANGE_TYPE_PANE_APPEARED

Change type for TYPE_WINDOW_STATE_CHANGED event: The node has a pane title, and either just appeared or just was assigned a title when it had none before.

int CONTENT_CHANGE_TYPE_PANE_DISAPPEARED

Change type for TYPE_WINDOW_STATE_CHANGED event: Can mean one of two slightly different things.

int CONTENT_CHANGE_TYPE_PANE_TITLE

Change type for TYPE_WINDOW_STATE_CHANGED event: The node's pane title changed.

int CONTENT_CHANGE_TYPE_STATE_DESCRIPTION

Change type for TYPE_WINDOW_CONTENT_CHANGED event: state description of the node as returned by AccessibilityNodeInfo#getStateDescription changed.

int CONTENT_CHANGE_TYPE_SUBTREE

Change type for TYPE_WINDOW_CONTENT_CHANGED event: One or more content changes occurred in the the subtree rooted at the source node, or the subtree's structure changed when a node was added or removed.

int CONTENT_CHANGE_TYPE_TEXT

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The node's text changed.

int CONTENT_CHANGE_TYPE_UNDEFINED

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The type of change is not defined.

int INVALID_POSITION

Invalid selection/focus position.

int MAX_TEXT_LENGTH

Maximum length of the text fields.

int TYPES_ALL_MASK

Mask for AccessibilityEvent all types.

int TYPE_ANNOUNCEMENT

Represents the event of an application making an announcement.

int TYPE_ASSIST_READING_CONTEXT

Represents the event of the assistant currently reading the users screen context.

int TYPE_GESTURE_DETECTION_END

Represents the event of ending gesture detection.

int TYPE_GESTURE_DETECTION_START

Represents the event of beginning gesture detection.

int TYPE_NOTIFICATION_STATE_CHANGED

Represents the event showing a Notification.

int TYPE_TOUCH_EXPLORATION_GESTURE_END

Represents the event of ending a touch exploration gesture.

int TYPE_TOUCH_EXPLORATION_GESTURE_START

Represents the event of starting a touch exploration gesture.

int TYPE_TOUCH_INTERACTION_END

Represents the event of the user ending to touch the screen.

int TYPE_TOUCH_INTERACTION_START

Represents the event of the user starting to touch the screen.

int TYPE_VIEW_ACCESSIBILITY_FOCUSED

Represents the event of gaining accessibility focus.

int TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED

Represents the event of clearing accessibility focus.

int TYPE_VIEW_CLICKED

Represents the event of clicking on a View like Button, CompoundButton, etc.

int TYPE_VIEW_CONTEXT_CLICKED

Represents the event of a context click on a View.

int TYPE_VIEW_FOCUSED

Represents the event of setting input focus of a View.

int TYPE_VIEW_HOVER_ENTER

Represents the event of a hover enter over a View.

int TYPE_VIEW_HOVER_EXIT

Represents the event of a hover exit over a View.

int TYPE_VIEW_LONG_CLICKED

Represents the event of long clicking on a View like Button, CompoundButton, etc.

int TYPE_VIEW_SCROLLED

Represents the event of scrolling a view.

int TYPE_VIEW_SELECTED

Represents the event of selecting an item usually in the context of an AdapterView.

int TYPE_VIEW_TEXT_CHANGED

Represents the event of changing the text of an EditText.

int TYPE_VIEW_TEXT_SELECTION_CHANGED

Represents the event of changing the selection in an EditText.

int TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY

Represents the event of traversing the text of a view at a given movement granularity.

int TYPE_WINDOWS_CHANGED

Represents the event change in the system windows shown on the screen.

int TYPE_WINDOW_CONTENT_CHANGED

Represents the event of changing the content of a window and more specifically the sub-tree rooted at the event's source.

int TYPE_WINDOW_STATE_CHANGED

Represents the event of a change to a visually distinct section of the user interface.

int WINDOWS_CHANGE_ACCESSIBILITY_FOCUSED

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isAccessibilityFocused() changed.

int WINDOWS_CHANGE_ACTIVE

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isActive() changed.

int WINDOWS_CHANGE_ADDED

Change type for TYPE_WINDOWS_CHANGED event: The window was added.

int WINDOWS_CHANGE_BOUNDS

Change type for TYPE_WINDOWS_CHANGED event: The window's bounds changed.

int WINDOWS_CHANGE_CHILDREN

Change type for TYPE_WINDOWS_CHANGED event: The window's children changed.

int WINDOWS_CHANGE_FOCUSED

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isFocused() changed.

int WINDOWS_CHANGE_LAYER

Change type for TYPE_WINDOWS_CHANGED event: The window's layer changed.

int WINDOWS_CHANGE_PARENT

Change type for TYPE_WINDOWS_CHANGED event: The window's parent changed.

int WINDOWS_CHANGE_PIP

Change type for TYPE_WINDOWS_CHANGED event: The window either entered or exited picture-in-picture mode.

int WINDOWS_CHANGE_REMOVED

Change type for TYPE_WINDOWS_CHANGED event: A window was removed.

int WINDOWS_CHANGE_TITLE

Change type for TYPE_WINDOWS_CHANGED event: The window's title changed.

Inherited constants

Fields

public static final Creator<AccessibilityEvent> CREATOR

Public constructors

AccessibilityEvent()

Creates a new AccessibilityEvent.

AccessibilityEvent(int eventType)

Creates a new AccessibilityEvent with the given eventType.

AccessibilityEvent(AccessibilityEvent event)

Copy constructor.

Public methods

void appendRecord(AccessibilityRecord record)

Appends an AccessibilityRecord to the end of event records.

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

static String eventTypeToString(int eventType)

Returns the string representation of an event type.

int getAction()

Gets the performed action that triggered this event.

int getContentChangeTypes()

Gets the bit mask of change types signaled by a TYPE_WINDOW_CONTENT_CHANGED event or TYPE_WINDOW_STATE_CHANGED.

long getEventTime()

Gets the time in which this event was sent.

int getEventType()

Gets the event type.

int getMovementGranularity()

Gets the movement granularity that was traversed.

CharSequence getPackageName()

Gets the package name of the source.

AccessibilityRecord getRecord(int index)

Gets the record at a given index.

int getRecordCount()

Gets the number of records contained in the event.

int getWindowChanges()

Get the bit mask of change types signaled by a TYPE_WINDOWS_CHANGED event.

void initFromParcel(Parcel parcel)

Creates a new instance from a Parcel.

static AccessibilityEvent obtain(AccessibilityEvent event)

Returns a cached instance if such is available or a new one is created.

static AccessibilityEvent obtain()

Returns a cached instance if such is available or a new one is instantiated.

static AccessibilityEvent obtain(int eventType)

Returns a cached instance if such is available or a new one is instantiated with its type property set.

void recycle()

Recycles an instance back to be reused.

void setAction(int action)

Sets the performed action that triggered this event.

void setContentChangeTypes(int changeTypes)

Sets the bit mask of node tree changes signaled by an TYPE_WINDOW_CONTENT_CHANGED event.

void setEventTime(long eventTime)

Sets the time in which this event was sent.

void setEventType(int eventType)

Sets the event type.

void setMovementGranularity(int granularity)

Sets the movement granularity that was traversed.

void setPackageName(CharSequence packageName)

Sets the package name of the source.

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel parcel, int flags)

Flatten this object in to a Parcel.

Inherited methods

Constants

CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION

public static final int CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The node's content description changed.

Constant Value: 4 (0x00000004)

CONTENT_CHANGE_TYPE_PANE_APPEARED

public static final int CONTENT_CHANGE_TYPE_PANE_APPEARED

Change type for TYPE_WINDOW_STATE_CHANGED event: The node has a pane title, and either just appeared or just was assigned a title when it had none before.

Constant Value: 16 (0x00000010)

CONTENT_CHANGE_TYPE_PANE_DISAPPEARED

public static final int CONTENT_CHANGE_TYPE_PANE_DISAPPEARED

Change type for TYPE_WINDOW_STATE_CHANGED event: Can mean one of two slightly different things. The primary meaning is that the node has a pane title, and was removed from the node hierarchy. It will also be sent if the pane title is set to null after it contained a title. No source will be returned if the node is no longer on the screen. To make the change more clear for the user, the first entry in AccessibilityRecord.getText() will return the value that would have been returned by getSource().getPaneTitle().

Constant Value: 32 (0x00000020)

CONTENT_CHANGE_TYPE_PANE_TITLE

public static final int CONTENT_CHANGE_TYPE_PANE_TITLE

Change type for TYPE_WINDOW_STATE_CHANGED event: The node's pane title changed.

Constant Value: 8 (0x00000008)

CONTENT_CHANGE_TYPE_STATE_DESCRIPTION

public static final int CONTENT_CHANGE_TYPE_STATE_DESCRIPTION

Change type for TYPE_WINDOW_CONTENT_CHANGED event: state description of the node as returned by AccessibilityNodeInfo#getStateDescription changed.

Constant Value: 64 (0x00000040)

CONTENT_CHANGE_TYPE_SUBTREE

public static final int CONTENT_CHANGE_TYPE_SUBTREE

Change type for TYPE_WINDOW_CONTENT_CHANGED event: One or more content changes occurred in the the subtree rooted at the source node, or the subtree's structure changed when a node was added or removed.

Constant Value: 1 (0x00000001)

CONTENT_CHANGE_TYPE_TEXT

public static final int CONTENT_CHANGE_TYPE_TEXT

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The node's text changed.

Constant Value: 2 (0x00000002)

CONTENT_CHANGE_TYPE_UNDEFINED

public static final int CONTENT_CHANGE_TYPE_UNDEFINED

Change type for TYPE_WINDOW_CONTENT_CHANGED event: The type of change is not defined.

Constant Value: 0 (0x00000000)

INVALID_POSITION

public static final int INVALID_POSITION

Invalid selection/focus position.

See also:

Constant Value: -1 (0xffffffff)

MAX_TEXT_LENGTH

public static final int MAX_TEXT_LENGTH

Maximum length of the text fields.

See also:

Constant Value: 500 (0x000001f4)

TYPES_ALL_MASK

public static final int TYPES_ALL_MASK

Mask for AccessibilityEvent all types.

See also:

Constant Value: -1 (0xffffffff)

TYPE_ANNOUNCEMENT

public static final int TYPE_ANNOUNCEMENT

Represents the event of an application making an announcement.

Constant Value: 16384 (0x00004000)

TYPE_ASSIST_READING_CONTEXT

public static final int TYPE_ASSIST_READING_CONTEXT

Represents the event of the assistant currently reading the users screen context.

Constant Value: 16777216 (0x01000000)

TYPE_GESTURE_DETECTION_END

public static final int TYPE_GESTURE_DETECTION_END

Represents the event of ending gesture detection.

Constant Value: 524288 (0x00080000)

TYPE_GESTURE_DETECTION_START

public static final int TYPE_GESTURE_DETECTION_START

Represents the event of beginning gesture detection.

Constant Value: 262144 (0x00040000)

TYPE_NOTIFICATION_STATE_CHANGED

public static final int TYPE_NOTIFICATION_STATE_CHANGED

Represents the event showing a Notification.

Constant Value: 64 (0x00000040)

TYPE_TOUCH_EXPLORATION_GESTURE_END

public static final int TYPE_TOUCH_EXPLORATION_GESTURE_END

Represents the event of ending a touch exploration gesture.

Constant Value: 1024 (0x00000400)

TYPE_TOUCH_EXPLORATION_GESTURE_START

public static final int TYPE_TOUCH_EXPLORATION_GESTURE_START

Represents the event of starting a touch exploration gesture.

Constant Value: 512 (0x00000200)

TYPE_TOUCH_INTERACTION_END

public static final int TYPE_TOUCH_INTERACTION_END

Represents the event of the user ending to touch the screen.

Constant Value: 2097152 (0x00200000)

TYPE_TOUCH_INTERACTION_START

public static final int TYPE_TOUCH_INTERACTION_START

Represents the event of the user starting to touch the screen.

Constant Value: 1048576 (0x00100000)

TYPE_VIEW_ACCESSIBILITY_FOCUSED

public static final int TYPE_VIEW_ACCESSIBILITY_FOCUSED

Represents the event of gaining accessibility focus.

Constant Value: 32768 (0x00008000)

TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED

public static final int TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED

Represents the event of clearing accessibility focus.

Constant Value: 65536 (0x00010000)

TYPE_VIEW_CLICKED

public static final int TYPE_VIEW_CLICKED

Represents the event of clicking on a View like Button, CompoundButton, etc.

Constant Value: 1 (0x00000001)

TYPE_VIEW_CONTEXT_CLICKED

public static final int TYPE_VIEW_CONTEXT_CLICKED

Represents the event of a context click on a View.

Constant Value: 8388608 (0x00800000)

TYPE_VIEW_FOCUSED

public static final int TYPE_VIEW_FOCUSED

Represents the event of setting input focus of a View.

Constant Value: 8 (0x00000008)

TYPE_VIEW_HOVER_ENTER

public static final int TYPE_VIEW_HOVER_ENTER

Represents the event of a hover enter over a View.

Constant Value: 128 (0x00000080)

TYPE_VIEW_HOVER_EXIT

public static final int TYPE_VIEW_HOVER_EXIT

Represents the event of a hover exit over a View.

Constant Value: 256 (0x00000100)

TYPE_VIEW_LONG_CLICKED

public static final int TYPE_VIEW_LONG_CLICKED

Represents the event of long clicking on a View like Button, CompoundButton, etc.

Constant Value: 2 (0x00000002)

TYPE_VIEW_SCROLLED

public static final int TYPE_VIEW_SCROLLED

Represents the event of scrolling a view. This event type is generally not sent directly.

See also:

Constant Value: 4096 (0x00001000)

TYPE_VIEW_SELECTED

public static final int TYPE_VIEW_SELECTED

Represents the event of selecting an item usually in the context of an AdapterView.

Constant Value: 4 (0x00000004)

TYPE_VIEW_TEXT_CHANGED

public static final int TYPE_VIEW_TEXT_CHANGED

Represents the event of changing the text of an EditText.

Constant Value: 16 (0x00000010)

TYPE_VIEW_TEXT_SELECTION_CHANGED

public static final int TYPE_VIEW_TEXT_SELECTION_CHANGED

Represents the event of changing the selection in an EditText.

Constant Value: 8192 (0x00002000)

TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY

public static final int TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY

Represents the event of traversing the text of a view at a given movement granularity.

Constant Value: 131072 (0x00020000)

TYPE_WINDOWS_CHANGED

public static final int TYPE_WINDOWS_CHANGED

Represents the event change in the system windows shown on the screen. This event type should only be dispatched by the system.

Constant Value: 4194304 (0x00400000)

TYPE_WINDOW_CONTENT_CHANGED

public static final int TYPE_WINDOW_CONTENT_CHANGED

Represents the event of changing the content of a window and more specifically the sub-tree rooted at the event's source.

Constant Value: 2048 (0x00000800)

TYPE_WINDOW_STATE_CHANGED

public static final int TYPE_WINDOW_STATE_CHANGED

Represents the event of a change to a visually distinct section of the user interface. These events should only be dispatched from Views that have accessibility pane titles, and replaces TYPE_WINDOW_CONTENT_CHANGED for those sources. Details about the change are available from getContentChangeTypes().

Constant Value: 32 (0x00000020)

WINDOWS_CHANGE_ACCESSIBILITY_FOCUSED

public static final int WINDOWS_CHANGE_ACCESSIBILITY_FOCUSED

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isAccessibilityFocused() changed.

Constant Value: 128 (0x00000080)

WINDOWS_CHANGE_ACTIVE

public static final int WINDOWS_CHANGE_ACTIVE

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isActive() changed.

Constant Value: 32 (0x00000020)

WINDOWS_CHANGE_ADDED

public static final int WINDOWS_CHANGE_ADDED

Change type for TYPE_WINDOWS_CHANGED event: The window was added.

Constant Value: 1 (0x00000001)

WINDOWS_CHANGE_BOUNDS

public static final int WINDOWS_CHANGE_BOUNDS

Change type for TYPE_WINDOWS_CHANGED event: The window's bounds changed.

Starting in R, this event implies the window's region changed. It's also possible that region changed but bounds doesn't.

Constant Value: 8 (0x00000008)

WINDOWS_CHANGE_CHILDREN

public static final int WINDOWS_CHANGE_CHILDREN

Change type for TYPE_WINDOWS_CHANGED event: The window's children changed.

Constant Value: 512 (0x00000200)

WINDOWS_CHANGE_FOCUSED

public static final int WINDOWS_CHANGE_FOCUSED

Change type for TYPE_WINDOWS_CHANGED event: The window's AccessibilityWindowInfo#isFocused() changed.

Constant Value: 64 (0x00000040)

WINDOWS_CHANGE_LAYER

public static final int WINDOWS_CHANGE_LAYER

Change type for TYPE_WINDOWS_CHANGED event: The window's layer changed.

Constant Value: 16 (0x00000010)

WINDOWS_CHANGE_PARENT

public static final int WINDOWS_CHANGE_PARENT

Change type for TYPE_WINDOWS_CHANGED event: The window's parent changed.

Constant Value: 256 (0x00000100)

WINDOWS_CHANGE_PIP

public static final int WINDOWS_CHANGE_PIP

Change type for TYPE_WINDOWS_CHANGED event: The window either entered or exited picture-in-picture mode.

Constant Value: 1024 (0x00000400)

WINDOWS_CHANGE_REMOVED

public static final int WINDOWS_CHANGE_REMOVED

Change type for TYPE_WINDOWS_CHANGED event: A window was removed.

Constant Value: 2 (0x00000002)

WINDOWS_CHANGE_TITLE

public static final int WINDOWS_CHANGE_TITLE

Change type for TYPE_WINDOWS_CHANGED event: The window's title changed.

Constant Value: 4 (0x00000004)

Fields

CREATOR

public static final Creator<AccessibilityEvent> CREATOR

See also:

Public constructors

AccessibilityEvent

public AccessibilityEvent ()

Creates a new AccessibilityEvent.

AccessibilityEvent

public AccessibilityEvent (int eventType)

Creates a new AccessibilityEvent with the given eventType.

Parameters
eventType int: The event type.

AccessibilityEvent

public AccessibilityEvent (AccessibilityEvent event)

Copy constructor. Creates a new AccessibilityEvent, and this instance is initialized from the given event.

Parameters
event AccessibilityEvent: The other event. This value cannot be null.

Public methods

appendRecord

public void appendRecord (AccessibilityRecord record)

Appends an AccessibilityRecord to the end of event records.

Parameters
record AccessibilityRecord: The record to append.
Throws
IllegalStateException If called from an AccessibilityService.

describeContents

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

eventTypeToString

public static String eventTypeToString (int eventType)

Returns the string representation of an event type. For example, TYPE_VIEW_CLICKED is represented by the string TYPE_VIEW_CLICKED.

Parameters
eventType int: The event type
Returns
String The string representation.

getAction

public int getAction ()

Gets the performed action that triggered this event.

Returns
int The action.

getContentChangeTypes

public int getContentChangeTypes ()

Gets the bit mask of change types signaled by a TYPE_WINDOW_CONTENT_CHANGED event or TYPE_WINDOW_STATE_CHANGED. A single event may represent multiple change types.

Returns
int The bit mask of change types. One or more of: Value is either 0 or a combination of CONTENT_CHANGE_TYPE_UNDEFINED, CONTENT_CHANGE_TYPE_SUBTREE, CONTENT_CHANGE_TYPE_TEXT, CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION, CONTENT_CHANGE_TYPE_STATE_DESCRIPTION, CONTENT_CHANGE_TYPE_PANE_TITLE, CONTENT_CHANGE_TYPE_PANE_APPEARED, and CONTENT_CHANGE_TYPE_PANE_DISAPPEARED

getEventTime

public long getEventTime ()

Gets the time in which this event was sent.

Returns
long The event time.

getEventType

public int getEventType ()

Gets the event type.

Returns
int The event type. Value is either 0 or a combination of TYPE_VIEW_CLICKED, TYPE_VIEW_LONG_CLICKED, TYPE_VIEW_SELECTED, TYPE_VIEW_FOCUSED, TYPE_VIEW_TEXT_CHANGED, TYPE_WINDOW_STATE_CHANGED, TYPE_NOTIFICATION_STATE_CHANGED, TYPE_VIEW_HOVER_ENTER, TYPE_VIEW_HOVER_EXIT, TYPE_TOUCH_EXPLORATION_GESTURE_START, TYPE_TOUCH_EXPLORATION_GESTURE_END, TYPE_WINDOW_CONTENT_CHANGED, TYPE_VIEW_SCROLLED, TYPE_VIEW_TEXT_SELECTION_CHANGED, TYPE_ANNOUNCEMENT, TYPE_VIEW_ACCESSIBILITY_FOCUSED, TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED, TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY, TYPE_GESTURE_DETECTION_START, TYPE_GESTURE_DETECTION_END, TYPE_TOUCH_INTERACTION_START, TYPE_TOUCH_INTERACTION_END, TYPE_WINDOWS_CHANGED, TYPE_VIEW_CONTEXT_CLICKED, and TYPE_ASSIST_READING_CONTEXT

getMovementGranularity

public int getMovementGranularity ()

Gets the movement granularity that was traversed.

Returns
int The granularity.

getPackageName

public CharSequence getPackageName ()

Gets the package name of the source.

Returns
CharSequence The package name.

getRecord

public AccessibilityRecord getRecord (int index)

Gets the record at a given index.

Parameters
index int: The index.
Returns
AccessibilityRecord The record at the specified index.

getRecordCount

public int getRecordCount ()

Gets the number of records contained in the event.

Returns
int The number of records.

getWindowChanges

public int getWindowChanges ()

Get the bit mask of change types signaled by a TYPE_WINDOWS_CHANGED event. A single event may represent multiple change types.

Returns
int The bit mask of change types. Value is either 0 or a combination of WINDOWS_CHANGE_ADDED, WINDOWS_CHANGE_REMOVED, WINDOWS_CHANGE_TITLE, WINDOWS_CHANGE_BOUNDS, WINDOWS_CHANGE_LAYER, WINDOWS_CHANGE_ACTIVE, WINDOWS_CHANGE_FOCUSED, WINDOWS_CHANGE_ACCESSIBILITY_FOCUSED, WINDOWS_CHANGE_PARENT, WINDOWS_CHANGE_CHILDREN, and WINDOWS_CHANGE_PIP

initFromParcel

public void initFromParcel (Parcel parcel)

Creates a new instance from a Parcel.

Parameters
parcel Parcel: A parcel containing the state of a AccessibilityEvent.

obtain

public static AccessibilityEvent obtain (AccessibilityEvent event)

Returns a cached instance if such is available or a new one is created. The returned instance is initialized from the given event.

In most situations object pooling is not beneficial. Create a new instance using the constructor AccessibilityEvent(android.view.accessibility.AccessibilityEvent) instead.

Parameters
event AccessibilityEvent: The other event.
Returns
AccessibilityEvent An instance.

obtain

public static AccessibilityEvent obtain ()

Returns a cached instance if such is available or a new one is instantiated.

In most situations object pooling is not beneficial. Create a new instance using the constructor AccessibilityEvent() instead.

Returns
AccessibilityEvent An instance.

obtain

public static AccessibilityEvent obtain (int eventType)

Returns a cached instance if such is available or a new one is instantiated with its type property set.

In most situations object pooling is not beneficial. Create a new instance using the constructor AccessibilityEvent(int) instead.

Parameters
eventType int: The event type.
Returns
AccessibilityEvent An instance.

recycle

public void recycle ()

Recycles an instance back to be reused.

Note: You must not touch the object after calling this function.

In most situations object pooling is not beneficial, and recycling is not necessary.

Throws
IllegalStateException If the event is already recycled.

setAction

public void setAction (int action)

Sets the performed action that triggered this event.

Valid actions are defined in AccessibilityNodeInfo:

Parameters
action int: The action.
Throws
IllegalStateException If called from an AccessibilityService.

See also:

setContentChangeTypes

public void setContentChangeTypes (int changeTypes)

Sets the bit mask of node tree changes signaled by an TYPE_WINDOW_CONTENT_CHANGED event.

Parameters
changeTypes int: The bit mask of change types. Value is either 0 or a combination of CONTENT_CHANGE_TYPE_UNDEFINED, CONTENT_CHANGE_TYPE_SUBTREE, CONTENT_CHANGE_TYPE_TEXT, CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION, CONTENT_CHANGE_TYPE_STATE_DESCRIPTION, CONTENT_CHANGE_TYPE_PANE_TITLE, CONTENT_CHANGE_TYPE_PANE_APPEARED, and CONTENT_CHANGE_TYPE_PANE_DISAPPEARED
Throws
IllegalStateException If called from an AccessibilityService.

See also:

setEventTime

public void setEventTime (long eventTime)

Sets the time in which this event was sent.

Parameters
eventTime long: The event time.
Throws
IllegalStateException If called from an AccessibilityService.

setEventType

public void setEventType (int eventType)

Sets the event type.

Parameters
eventType int: The event type. Value is either 0 or a combination of TYPE_VIEW_CLICKED, TYPE_VIEW_LONG_CLICKED, TYPE_VIEW_SELECTED, TYPE_VIEW_FOCUSED, TYPE_VIEW_TEXT_CHANGED, TYPE_WINDOW_STATE_CHANGED, TYPE_NOTIFICATION_STATE_CHANGED, TYPE_VIEW_HOVER_ENTER, TYPE_VIEW_HOVER_EXIT, TYPE_TOUCH_EXPLORATION_GESTURE_START, TYPE_TOUCH_EXPLORATION_GESTURE_END, TYPE_WINDOW_CONTENT_CHANGED, TYPE_VIEW_SCROLLED, TYPE_VIEW_TEXT_SELECTION_CHANGED, TYPE_ANNOUNCEMENT, TYPE_VIEW_ACCESSIBILITY_FOCUSED, TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED, TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY, TYPE_GESTURE_DETECTION_START, TYPE_GESTURE_DETECTION_END, TYPE_TOUCH_INTERACTION_START, TYPE_TOUCH_INTERACTION_END, TYPE_WINDOWS_CHANGED, TYPE_VIEW_CONTEXT_CLICKED, and TYPE_ASSIST_READING_CONTEXT
Throws
IllegalStateException If called from an AccessibilityService.

setMovementGranularity

public void setMovementGranularity (int granularity)

Sets the movement granularity that was traversed.

Parameters
granularity int: The granularity.
Throws
IllegalStateException If called from an AccessibilityService.

setPackageName

public void setPackageName (CharSequence packageName)

Sets the package name of the source.

Parameters
packageName CharSequence: The package name.
Throws
IllegalStateException If called from an AccessibilityService.

toString

public String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of: 

 getClass().getName() + '@' + Integer.toHexString(hashCode())

Returns
String a string representation of the object.

writeToParcel

public void writeToParcel (Parcel parcel, 
                int flags)

Flatten this object in to a Parcel.

Parameters
parcel Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES
Get news & tips
Blog Support

Except as noted, this content is licensed under Apache 2.0. For details and restrictions, see the Content License.

Android 7.0 r1 —

About Android Auto TV Wear Legal