AccessibilityEvent

public final class AccessibilityEvent
extends AccessibilityRecord implements Parcelable

此类表示在用户界面中出现显着事件时由系统发送的可访问性事件。 例如，当点击Button时， View被集中，等等。

可访问性事件由单个视图触发，该视图使用其状态的数据填充事件，并从其父级请求将事件发送给感兴趣的各方。 父母可以选择为自己添加一个AccessibilityRecord ，然后向其父母派发类似的请求。 家长也可以选择不尊重发送活动的请求。 可访问性事件由视图树中最顶层的视图发送。 因此， AccessibilityService可以浏览可访问性事件中的所有记录，以获取有关事件触发的上下文的更多信息。

可访问性事件的主要目的是为AccessibilityService公开足够的信息以向用户提供有意义的反馈。 然而，有时候，无障碍服务可能需要更多的上下文信息，然后才需要付费。 在这种情况下，服务可以获得可以用于浏览窗口内容的事件源AccessibilityNodeInfo （View状态的快照）。 请注意，必须明确要求访问事件源的权限，因此窗口内容。 有关更多详细信息，请参阅AccessibilityService 。 如果辅助功能服务未请求检索窗口内容，则该事件不会包含对其源的引用。 对于类型为TYPE_NOTIFICATION_STATE_CHANGED的事件，源也不可用。

这个类表示不同的语义不同的可访问性事件类型。 每种事件类型都有一组关联的属性。 换句话说，每个事件类型都是通过该类所公开的属性的子集来表征的。 对于每个事件类型，都有一个在此类中定义的相应常量。 遵循事件类型及其相关属性的规范：

查看类型

点击查看 -代表点击一个的事件View像Button ， CompoundButton ，等等。
类型： TYPE_VIEW_CLICKED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• isPassword() - Whether the source is password.
• isChecked() - Whether the source is checked.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

查看长点击 -表示长时间点击的一个事件View像Button ， CompoundButton ，等
类型： TYPE_VIEW_LONG_CLICKED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• isPassword() - Whether the source is password.
• isChecked() - Whether the source is checked.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

选择视图 - 表示通常在AdapterView的上下文中选择项目的事件。
类型： TYPE_VIEW_SELECTED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• isPassword() - Whether the source is password.
• isChecked() - Whether the source is checked.
• getItemCount() - The number of selectable items of the source.
• getCurrentItemIndex() - The currently selected item index.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

集中观看 - 代表聚焦View的事件。
类型： TYPE_VIEW_FOCUSED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• isPassword() - Whether the source is password.
• isChecked() - Whether the source is checked.
• getItemCount() - The number of focusable items on the screen.
• getCurrentItemIndex() - The currently focused item index.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

查看文本已更改 - 表示更改EditText文本的EditText 。
类型： TYPE_VIEW_TEXT_CHANGED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source.
• isEnabled() - Whether the source is enabled.
• isPassword() - Whether the source is password.
• isChecked() - Whether the source is checked.
• getFromIndex() - The text change start index.
• getAddedCount() - The number of added characters.
• getRemovedCount() - The number of removed characters.
• getBeforeText() - The text of the source before the change.
• getContentDescription() - The content description of the source.

查看文本选择已更改 - 表示更改EditText的文本选择事件。
类型： TYPE_VIEW_TEXT_SELECTION_CHANGED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source.
• isPassword() - Whether the source is password.
• getFromIndex() - The selection start index.
• getToIndex() - The selection end index.
• getItemCount() - The length of the source text.
• isEnabled() - Whether the source is enabled.
• getContentDescription() - The content description of the source.

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getMovementGranularity() - Sets the granularity at which a view's text was traversed.
• getText() - The text of the source's sub-tree.
• getFromIndex() - The start the text that was skipped over in this movement. This is the starting point when moving forward through the text, but not when moving back.
• getToIndex() - The end of the text that was skipped over in this movement. This is the ending point when moving forward through the text, but not when moving back.
• isPassword() - Whether the source is password.
• isEnabled() - Whether the source is enabled.
• getContentDescription() - The content description of the source.
• getMovementGranularity() - Sets the granularity at which a view's text was traversed.
• getAction() - Gets traversal action which specifies the direction.

查看滚动 - 表示滚动视图的事件。 如果源是AdapterView的后代，则根据可见项目（第一个可见项目，最后一个可见项目和总项目）报告滚动，因为源代码不知道其像素大小，因为它的适配器负责创建观点。 在所有其他情况下，滚动分别报告为X轴和Y轴上的当前滚动以及以像素为单位的源高度。
类型： TYPE_VIEW_SCROLLED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

过渡类型

窗口状态改变 -表示的打开事件PopupWindow ， Menu ， Dialog等
类型： TYPE_WINDOW_STATE_CHANGED
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.

窗口内容已更改 - 表示窗口内容发生更改。 此更改可以添加/删除视图，更改视图大小等。

注意：此事件仅针对最后一个辅助功能事件的窗口源与TYPE_NOTIFICATION_STATE_CHANGED不同，其目的是通知客户端用户交互窗口的内容已更改。
类型： TYPE_WINDOW_CONTENT_CHANGED
属性：

• getEventType() - The type of the event.
• getContentChangeTypes() - The type of content changes.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.

Windows已更改 - 代表屏幕上显示的窗口发生更改，如窗口出现，窗口消失，窗口大小更改，窗口层更改等等。
类型： TYPE_WINDOWS_CHANGED
属性：

• getEventType() - The type of the event.
• getEventTime() - The event time.

通知类型

通知状态已更改 - 表示显示Notification的事件。
类型： TYPE_NOTIFICATION_STATE_CHANGED
属性：

• getEventType() - The type of the event.
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getParcelableData() - The posted Notification.
• getText() - Text for providing more context.

勘探类型

查看悬停输入 - 表示开始悬停在View上的View 。 可以通过触摸或通过定位设备浏览屏幕来生成悬停。
类型： TYPE_VIEW_HOVER_ENTER
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the source's sub-tree.
• isEnabled() - Whether the source is enabled.
• getContentDescription() - The content description of the source.
• getScrollX() - The offset of the source left edge in pixels (without descendants of AdapterView).
• getScrollY() - The offset of the source top edge in pixels (without descendants of AdapterView).
• getFromIndex() - The zero based index of the first visible item of the source, inclusive (for descendants of AdapterView).
• getToIndex() - The zero based index of the last visible item of the source, inclusive (for descendants of AdapterView).
• getItemCount() - The total items of the source (for descendants of AdapterView).

触摸互动开始 - 表示开始触摸互动的事件，即用户开始触摸屏幕。
类型： TYPE_TOUCH_INTERACTION_START
属性：

• getEventType() - The type of the event.

触摸交互结束 - 表示结束触摸交互的事件，即用户停止触摸屏幕。
类型： TYPE_TOUCH_INTERACTION_END
属性：

• getEventType() - The type of the event.

触摸探索手势开始 - 表示开始触摸探索手势的事件。
类型： TYPE_TOUCH_EXPLORATION_GESTURE_START
属性：

• getEventType() - The type of the event.

触摸探索手势结束 - 表示结束触摸探索手势的事件。
类型： TYPE_TOUCH_EXPLORATION_GESTURE_END
属性：

• getEventType() - The type of the event.

触摸手势检测开始 - 表示开始用户手势检测的事件。
类型： TYPE_GESTURE_DETECTION_START
属性：

• getEventType() - The type of the event.

触摸手势检测结束 - 表示结束用户手势检测的事件。
类型： TYPE_GESTURE_DETECTION_END
属性：

• getEventType() - The type of the event.

其他类型

公告 - 代表发布公告的申请事件。 通常这个公告与某种上下文变化有关，对于这种变化，没有任何代表UI过渡的事件是合适的。 例如，在书中宣布新页面。
类型： TYPE_ANNOUNCEMENT
属性：

• getEventType() - The type of the event.
• getSource() - The source info (for registered clients).
• getClassName() - The class name of the source.
• getPackageName() - The package name of the source.
• getEventTime() - The event time.
• getText() - The text of the announcement.
• isEnabled() - Whether the source is enabled.

安全说明

由于事件包含其来源隐私文本，因泄漏敏感信息（如密码）可能会受到影响。 为了解决这个问题，响应于操纵密码字段而触发的任何事件不包含密码的文本。

Summary

Inherited constants
From interface android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR 与 describeContents()使用的描述符位：表示 describeContents()对象的展平表示包含文件描述符。 int PARCELABLE_WRITE_RETURN_VALUE 与 writeToParcel(Parcel, int)一起使用的 writeToParcel(Parcel, int) ：正在写入的对象是返回值，即“ Parcelable someFunction() ”，“ void someFunction(out Parcelable) ”或“ void someFunction(inout Parcelable) ”等函数的结果。

Inherited methods
From class android.view.accessibility.AccessibilityRecord int getAddedCount() 获取添加的字符数。 CharSequence getBeforeText() 设置更改前的文本。 CharSequence getClassName() 获取源的类名称。 CharSequence getContentDescription() 获取源的描述。 int getCurrentItemIndex() 获取可以访问的项目列表中源的索引。 int getFromIndex() 获取已更改序列的第一个字符的索引，或滚动时文本选择的开始或第一个可见项目的索引。 int getItemCount() 获取可以访问的项目数。 int getMaxScrollX() 获取源左边缘的最大滚动偏移量（以像素为单位）。 int getMaxScrollY() 以像素为单位获取源顶部边缘的最大滚动偏移量。 Parcelable getParcelableData() 获取 Parcelable数据。 int getRemovedCount() 获取已删除字符的数量。 int getScrollX() 获取源左边缘的滚动偏移量，以像素为单位。 int getScrollY() 获取以像素为单位的源顶部边缘的滚动偏移量。 AccessibilityNodeInfo getSource() 获取事件源的 AccessibilityNodeInfo 。 List<CharSequence> getText() 获取事件的文本。 int getToIndex() 滚动时获取文本选择结束的索引或最后一个可见项目的索引。 int getWindowId() 获取事件来自的窗口的ID。 boolean isChecked() 获取源是否被选中。 boolean isEnabled() 获取源是否已启用。 boolean isFullScreen() 获取源是否正在拍摄整个屏幕。 boolean isPassword() 获取源是否是密码字段。 boolean isScrollable() 获取源是否可滚动。 static AccessibilityRecord obtain() 如果可用或返回实例，则返回缓存的实例。 static AccessibilityRecord obtain(AccessibilityRecord record) 如果可用或返回实例，则返回缓存的实例。 void recycle() 返回一个实例以重用。 void setAddedCount(int addedCount) 设置添加的字符数。 void setBeforeText(CharSequence beforeText) 设置更改前的文本。 void setChecked(boolean isChecked) 设置是否检查源。 void setClassName(CharSequence className) 设置源的类名称。 void setContentDescription(CharSequence contentDescription) 设置源的描述。 void setCurrentItemIndex(int currentItemIndex) 设置可以访问的项目列表中源的索引。 void setEnabled(boolean isEnabled) 设置源是否已启用。 void setFromIndex(int fromIndex) 滚动时，设置已更改序列的第一个字符的索引或文本选择的开头或第一个可见项目的索引。 void setFullScreen(boolean isFullScreen) 设置信号源是否拍摄整个屏幕。 void setItemCount(int itemCount) 设置可以访问的项目数量。 void setMaxScrollX(int maxScrollX) 设置源左边缘的最大滚动偏移量（以像素为单位）。 void setMaxScrollY(int maxScrollY) 设置源顶部边缘的最大滚动偏移量（以像素为单位）。 void setParcelableData(Parcelable parcelableData) 设置事件的 Parcelable数据。 void setPassword(boolean isPassword) 设置源是否是密码字段。 void setRemovedCount(int removedCount) 设置已删除字符的数量。 void setScrollX(int scrollX) 设置源左边缘的滚动偏移量（以像素为单位）。 void setScrollY(int scrollY) 以像素为单位设置源顶部边缘的滚动偏移量。 void setScrollable(boolean scrollable) 设置源是否可滚动。 void setSource(View root, int virtualDescendantId) 将源设置为给定 root的虚拟后代。 void setSource(View source) 设置事件源。 void setToIndex(int toIndex) 滚动时设置文本选择结束的索引或最后一个可见项目的索引。 String toString() 返回对象的字符串表示形式。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或某个其他线程中断当前线程或经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。
From interface android.os.Parcelable abstract int describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 abstract void writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。

Constants

int CONTENT_CHANGE_TYPE_CONTENT_DESCRIPTION

int CONTENT_CHANGE_TYPE_SUBTREE

int CONTENT_CHANGE_TYPE_TEXT

int CONTENT_CHANGE_TYPE_UNDEFINED

int INVALID_POSITION

int MAX_TEXT_LENGTH

int TYPES_ALL_MASK

int TYPE_ANNOUNCEMENT

int TYPE_ASSIST_READING_CONTEXT

int TYPE_GESTURE_DETECTION_END

int TYPE_GESTURE_DETECTION_START

int TYPE_NOTIFICATION_STATE_CHANGED

int TYPE_TOUCH_EXPLORATION_GESTURE_END

int TYPE_TOUCH_EXPLORATION_GESTURE_START

int TYPE_TOUCH_INTERACTION_END

int TYPE_TOUCH_INTERACTION_START

int TYPE_VIEW_ACCESSIBILITY_FOCUSED

int TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED

int TYPE_VIEW_CLICKED

int TYPE_VIEW_CONTEXT_CLICKED

int TYPE_VIEW_FOCUSED

int TYPE_VIEW_HOVER_ENTER

int TYPE_VIEW_HOVER_EXIT

int TYPE_VIEW_LONG_CLICKED

int TYPE_VIEW_SCROLLED

int TYPE_VIEW_SELECTED

int TYPE_VIEW_TEXT_CHANGED

int TYPE_VIEW_TEXT_SELECTION_CHANGED

int TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY

int TYPE_WINDOWS_CHANGED

int TYPE_WINDOW_CONTENT_CHANGED

int TYPE_WINDOW_STATE_CHANGED

Fields

Creator<AccessibilityEvent> CREATOR

Public methods

void appendRecord (AccessibilityRecord record)

int describeContents ()

String eventTypeToString (int eventType)

int getAction ()

int getContentChangeTypes ()

long getEventTime ()

int getEventType ()

int getMovementGranularity ()

CharSequence getPackageName ()

AccessibilityRecord getRecord (int index)

int getRecordCount ()

void initFromParcel (Parcel parcel)

AccessibilityEvent obtain (AccessibilityEvent event)

AccessibilityEvent obtain ()

AccessibilityEvent obtain (int eventType)

void recycle ()

void setAction (int action)

void setContentChangeTypes (int changeTypes)

void setEventTime (long eventTime)

void setEventType (int eventType)

void setMovementGranularity (int granularity)

void setPackageName (CharSequence packageName)

String toString ()

void writeToParcel (Parcel parcel, 
                int flags)