AccessibilityNodeInfo 类

定义

此类表示窗口内容的节点以及可从其源请求的操作。

[Android.Runtime.Register("android/view/accessibility/AccessibilityNodeInfo", DoNotGenerateAcw=true)]
public class AccessibilityNodeInfo : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/view/accessibility/AccessibilityNodeInfo", DoNotGenerateAcw=true)>]
type AccessibilityNodeInfo = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
继承
AccessibilityNodeInfo
属性
实现

注解

此类表示窗口内容的节点以及可从其源请求的操作。 从窗口内容的角度来看 android.accessibilityservice.AccessibilityService ,它显示为辅助功能节点信息的树,该树可能或可能不会将一对一映射到视图层次结构。 换句话说,自定义视图可以自由地将自身报告为辅助功能节点信息的树。 </p>

将辅助功能节点信息传递到辅助功能服务后,它就会变得不可变,调用状态突变方法将生成错误。 查看 #setQueryFromAppProcessEnabled 是否要从应用进程检查节点树以进行测试或调试工具。

有关如何 android.accessibilityservice.AccessibilityService 获取窗口内容的句柄的详细信息,请参阅辅助功能节点信息的树以及有关安全模型的详细信息。

<div class=“special reference”><h3>Developer Guides</h3>

有关使应用程序易于访问的详细信息,请阅读 辅助功能 开发人员指南。

</div> “note”><b>Note:</b> Use a <c>androidx.core.view.accessibility.AccessibilityNodeInfoCompat</c> wrapper,而不是此类以实现向后兼容性。 </aside>

Java文档android.view.accessibility.AccessibilityNodeInfo

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

构造函数

名称 说明
AccessibilityNodeInfo()

创建新的 AccessibilityNodeInfo

AccessibilityNodeInfo(AccessibilityNodeInfo)

复制构造函数。

AccessibilityNodeInfo(IntPtr, JniHandleOwnership)

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

AccessibilityNodeInfo(View, Int32)

使用给定AccessibilityNodeInfosource创建新项。

AccessibilityNodeInfo(View)

使用给定AccessibilityNodeInfosource创建新项。

字段

名称 说明
ActionAccessibilityFocus
已过时.

为节点提供辅助功能焦点的操作。

ActionArgumentColumnInt

用于指定要在屏幕上可见的集合列的参数。

ActionArgumentDirectionInt

使用时 AccessibilityAction#ACTION_SCROLL_IN_DIRECTION要表示方向的参数。

ActionArgumentExtendSelectionBoolean

用于在粒度上移动以扩展所选内容还是以其他方式移动时的参数。

ActionArgumentHtmlElementString

要移动到下一个/上一个 HTML 元素的 HTML 元素的参数。

ActionArgumentMovementGranularityInt

遍历节点文本时要使用的移动粒度的参数。

ActionArgumentMoveWindowX

用于指定要移动窗口的 x 坐标的参数。

ActionArgumentMoveWindowY

用于指定要移动窗口的 y 坐标的参数。

ActionArgumentPressAndHoldDurationMillisInt

用于表示要按住节点的持续时间(以毫秒为单位)的参数。

ActionArgumentProgressValue

指定要设置的进度值的参数。

ActionArgumentRowInt

用于指定集合行以在屏幕上可见的参数。

ActionArgumentScrollAmountFloat

将滚动量表示为节点可见区域的百分比的参数,其中 1。

ActionArgumentSelectionEndInt

用于指定选择结束的参数。

ActionArgumentSelectionStartInt

用于指定选择开始的参数。

ActionArgumentSetTextCharsequence

指定要设置的文本内容的参数。

ActionClearAccessibilityFocus
已过时.

清除节点的辅助功能焦点的操作。

ActionClearFocus
已过时.

清除节点的输入焦点的操作。

ActionClearSelection
已过时.

取消选择节点的操作。

ActionClick
已过时.

单击节点信息的操作。

ActionCollapse
已过时.

折叠可扩展节点的操作。

ActionCopy
已过时.

将当前选择复制到剪贴板的操作。

ActionCut
已过时.

剪切当前所选内容并将其置于剪贴板的操作。

ActionDismiss
已过时.

关闭可消除的节点的操作。

ActionExpand
已过时.

展开可扩展节点的操作。

ActionFocus
已过时.

为节点提供输入焦点的操作。

ActionLongClick
已过时.

长时间单击节点上的操作。

ActionNextAtMovementGranularity
已过时.

请求以给定移动粒度转到此节点文本中的下一个实体的操作。

ActionNextHtmlElement
已过时.

移动到给定类型的下一个 HTML 元素的操作。

ActionPaste
已过时.

粘贴当前剪贴板内容的操作。

ActionPreviousAtMovementGranularity
已过时.

请求以给定移动粒度转到此节点文本中的上一实体的操作。

ActionPreviousHtmlElement
已过时.

移动到给定类型的上一个 HTML 元素的操作。

ActionScrollBackward
已过时.

向后滚动节点内容的操作。

ActionScrollForward
已过时.

向前滚动节点内容的操作。

ActionSelect
已过时.

选择节点的操作。

ActionSetSelection
已过时.

设置所选内容的操作。

ActionSetText
已过时.

设置节点文本的操作。

CheckedStateFalse
已过时.

未检查此节点。

CheckedStatePartial
已过时.

此节点已部分检查。

CheckedStateTrue
已过时.

检查此节点。

ExpandedStateCollapsed
已过时.

折叠的可展开元素的展开状态。

ExpandedStateFull
已过时.

无法进一步扩展的可扩展元素的展开状态。

ExpandedStatePartial
已过时.

扩展的可扩展元素的展开状态,该元素仍可进一步扩展。

ExpandedStateUndefined
已过时.

不可扩展元素的展开状态

ExtraDataRenderingInfoKey

用于请求呈现信息的额外数据的密钥。

ExtraDataTextCharacterLocationArgLength

指定所请求文本位置数据的结束索引的整数参数。

ExtraDataTextCharacterLocationArgMaxLength

请求的文本位置数据的最大允许长度。

ExtraDataTextCharacterLocationArgStartIndex

指定所请求文本位置数据的起始索引的整数参数。

ExtraDataTextCharacterLocationInWindowKey

用于在窗口坐标中请求和查找文本字符位置的额外数据的键。

ExtraDataTextCharacterLocationKey

用于请求和查找文本字符位置的额外数据的键。

FlagPrefetchAncestors
已过时.

预提取策略,该策略预提取所请求节点的上级。

FlagPrefetchDescendantsBreadthFirst
已过时.

预提取策略,用于预提取所请求节点广度优先的后代。

FlagPrefetchDescendantsDepthFirst
已过时.

预提取策略,用于预提取所请求节点深度优先的后代。

FlagPrefetchDescendantsHybrid
已过时.

预提取策略,在混合深度优先和广度优先方法中预提取后代。

FlagPrefetchSiblings
已过时.

预提取策略,该策略预提取请求的节点的同级节点。

FlagPrefetchUninterruptible
已过时.

指定预提取的标志不应被请求中断以检索节点或在节点上执行操作。

FocusAccessibility
已过时.

辅助功能焦点。

FocusInput
已过时.

输入焦点。

MaxNumberOfPrefetchedNodes

请求预提取节点的最大批大小。

MovementGranularityCharacter
已过时.

移动粒度位,用于按字符遍历节点的文本。

MovementGranularityLine
已过时.

用于逐行遍历节点文本的移动粒度位。

MovementGranularityPage
已过时.

移动粒度位,用于逐页遍历节点的文本。

MovementGranularityParagraph
已过时.

移动粒度位,用于逐段遍历节点的文本。

MovementGranularityWord
已过时.

移动粒度位,用于逐字遍历节点的文本。

属性

名称 说明
AccessibilityDataSensitive

获取节点的辅助功能数据是否被视为敏感数据。 - 或 - 设置此节点的辅助功能数据是否被视为敏感数据。

AccessibilityFocused

获取此节点是否以辅助功能为重点。 - 或 - 设置此节点是否以辅助功能为重点。

ActionList

获取可在节点上执行的操作。

Actions
已过时.

获取可在节点上执行的操作。

AvailableExtraData

获取此节点可用的额外数据。 - 或 - 设置可用于此节点的额外数据。

Checkable

获取此节点是否可检查。 - 或 - 设置此节点是否可检查。

Checked

获取是否检查此节点。 - 或 - 设置是否检查此节点。

CheckedState

获取此节点的选中状态。 - 或 - 设置此节点的选中状态。

ChildCount

获取子级数。

Class

返回此 Object的运行时类。

(继承自 Object)
ClassName

此类表示窗口内容的节点以及可从其源请求的操作。

ClassNameFormatted

获取此节点来自的类。 - 或 - 设置此节点来自的类。

Clickable

获取此节点是否可单击。 - 或 - 设置此节点是否可单击。

ContainerTitle

此类表示窗口内容的节点以及可从其源请求的操作。

ContainerTitleFormatted

返回容器标题。 - 或 - 为应用开发人员定义的容器设置容器标题,该容器可以是任何类型的 ViewGroup 或布局。

ContentDescription

此类表示窗口内容的节点以及可从其源请求的操作。

ContentDescriptionFormatted

获取此节点的内容说明。 - 或 - 设置此节点的内容说明。

ContentInvalid

获取此节点的内容是否无效。 - 或 - 设置此节点的内容是否无效。

ContextClickable

获取此节点是否可单击上下文。 - 或 - 设置此节点是否可单击上下文。

Creator
Dismissable

获取是否可以消除节点。 - 或 - 设置节点是否可以消除。

DrawingOrder

获取与此节点对应的视图的绘图顺序。 - 或 - 设置与此节点对应的视图的绘图顺序。

Editable

获取节点是否可编辑。 - 或 - 设置此节点是否可编辑。

Enabled

获取是否启用此节点。 - 或 - 设置是否启用此节点。

Error

此类表示窗口内容的节点以及可从其源请求的操作。

ErrorFormatted

获取此节点的错误文本。 - 或 - 设置此节点的错误文本。

ExpandedState

获取此节点的展开状态。 - 或 - 设置节点的展开状态。

Extras

获取具有额外数据的可选捆绑包。

FieldRequired

获取表示窗体字段的节点是否需要输入或选择。 - 或 - 设置节点是否 this 表示需要输入或选择的窗体字段。

Focusable

获取此节点是否可聚焦。 - 或 - 设置此节点是否可聚焦。

Focused

获取此节点是否聚焦。 - 或 - 设置此节点是否聚焦。

GranularScrollingSupported

获取节点是否支持精细滚动。 - 或 - 设置节点是否支持精细滚动。

Handle

基础 Android 实例的句柄。

(继承自 Object)
HasRequestInitialAccessibilityFocus

获取节点是否具有 #setRequestInitialAccessibilityFocus

Heading

返回节点是否表示标题。 - 或 - 设置节点是否表示标题。

HintText

此类表示窗口内容的节点以及可从其源请求的操作。

HintTextFormatted

获取此节点的提示文本。 - 或 - 设置此节点的提示文本。

ImportantForAccessibility

返回节点是否源自被认为对辅助功能很重要的视图。 - 或 - 设置节点是否被视为对辅助功能很重要。

InputType

获取由 InputType. 定义的源的输入类型。 - 或 - 设置由 InputType. 定义的源的输入类型。

JniIdentityHashCode

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
JniPeerMembers

此类表示窗口内容的节点以及可从其源请求的操作。

LabeledBy

获取用作此信息所表示视图的标签的节点信息,以便进行辅助功能。

LabeledByList

获取节点信息的列表,这些信息用作此信息所表示视图的标签,以便进行辅助功能。

LabelFor

获取由此信息表示的视图用作辅助功能的标签的节点信息。

LiveRegion

获取节点的实时区域模式。 - 或 - 设置节点的实时区域模式。

LongClickable

获取此节点是否可长时间单击。 - 或 - 设置此节点是否可长时间单击。

MaxTextLength

返回此节点的最大文本长度。 - 或 - 设置最大文本长度,或 -1 无限制。

MinDurationBetweenContentChanges

获取两个内容更改事件之间的最短持续时间。 - 或 - 设置两个内容更改事件之间的最短持续时间,该事件用于限制辅助功能服务中的内容更改事件。

MovementGranularities

获取用于遍历此节点文本的移动粒度。 - 或 - 设置用于遍历此节点文本的移动粒度。

MultiLine

获取节点是否为多行可编辑文本。 - 或 - 设置节点是否为多行可编辑文本。

PackageName

此类表示窗口内容的节点以及可从其源请求的操作。

PackageNameFormatted

获取此节点来自的包。 - 或 - 设置此节点所来自的包。

PaneTitle

此类表示窗口内容的节点以及可从其源请求的操作。

PaneTitleFormatted

获取此节点表示的窗格的标题。 - 或 - 如果此节点表示屏幕的可视不同区域,该区域可能会独立于窗口的其余部分进行更新,则被视为窗格。

Parent

获取父级。

Password

获取此节点是否为密码。 - 或 - 设置此节点是否为密码。

PeerReference

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
ScreenReaderFocusable

返回是否由屏幕阅读器显式标记为可聚焦单元的节点。 - 或 - 设置节点是否应被屏幕阅读器视为可聚焦单元。

Scrollable

获取节点是否可滚动。 - 或 - 设置节点是否可滚动。

Selected

获取是否选择此节点。 - 或 - 设置是否选择此节点。

ShowingHintText

返回节点的文本是否表示用户输入文本的提示。 - 或 - 设置节点的文本是否表示用户输入文本的提示。

StateDescription

此类表示窗口内容的节点以及可从其源请求的操作。

StateDescriptionFormatted

获取此节点的状态说明。 - 或 - 设置此节点的状态说明。

SupplementalDescription

此类表示窗口内容的节点以及可从其源请求的操作。

SupplementalDescriptionFormatted

获取此节点的补充说明。 - 或 - 设置此节点的补充说明。

Text

此类表示窗口内容的节点以及可从其源请求的操作。

TextEntryKey

返回节点是否表示作为键盘或键盘一部分的文本输入键。 - 或 - 设置节点是否表示作为键盘或键盘一部分的文本输入键。

TextFormatted

获取此节点的文本。 - 或 - 设置此节点的文本。

TextSelectable

获取节点是否具有可选文本。 - 或 - 设置节点是否具有可选文本。

TextSelectionEnd

获取选定文本时文本选择结束。

TextSelectionStart

获取文本选择开始位置或光标位置。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

TooltipText

此类表示窗口内容的节点以及可从其源请求的操作。

TooltipTextFormatted

获取此节点的工具提示文本。 - 或 - 设置此节点的工具提示文本。

TraversalAfter

获取在可访问性遍历中访问此节点的节点。

TraversalBefore

获取遍历期间访问此节点的节点。

UniqueId

获取节点的唯一 ID。 - 或 - 设置唯一 ID 以充当用于标识节点的键。

ViewIdResourceName

获取源视图 ID 的完全限定资源名称。-或 - 设置源视图 ID 的完全限定资源名称。

VisibleToUser

获取此节点是否对用户可见。 - 或 - 设置此节点是否对用户可见。

Window

获取此节点所属的窗口。

WindowId

获取来自信息的窗口的 ID。

方法

名称 说明
AddAction(AccessibilityNodeInfo+AccessibilityAction)

添加可在节点上执行的操作。

AddAction(Action)
已过时.

添加可在节点上执行的操作。

AddChild(View, Int32)

添加一个虚拟子级,该子级是给定 root的后代。

AddChild(View)

添加子级。

AddLabeledBy(View, Int32)

此类表示窗口内容的节点以及可从其源请求的操作。

AddLabeledBy(View)

此类表示窗口内容的节点以及可从其源请求的操作。

CanOpenPopup()

获取此节点是否打开弹出窗口或对话框。

Clone()

创建并返回此对象的副本。

(继承自 Object)
DescribeContents()

要添加

Dispose()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
Dispose(Boolean)

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
Equals(Object)

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

(继承自 Object)
FindAccessibilityNodeInfosByText(String)

AccessibilityNodeInfo按文本查找 s。

FindAccessibilityNodeInfosByViewId(String)

AccessibilityNodeInfo按完全限定视图 ID 的资源名称查找,其中完全限定 ID 来自“package:id/id_resource_name”。

FindFocus(NodeFocus)

查找具有指定焦点类型的视图。

FocusSearch(FocusSearchDirection)

在指定方向中搜索可获取输入焦点的最接近的视图。

GetBoundsInParent(Rect)

获取 viewParent 坐标中的节点边界。

GetBoundsInScreen(Rect)

获取屏幕坐标中的节点边界。

GetBoundsInWindow(Rect)

获取窗口坐标中的节点边界。

GetChild(Int32, Int32)

获取给定索引处的子级。

GetChild(Int32)

获取给定索引处的子级。

GetCollectionInfo()

如果节点是集合,则获取集合信息。

GetCollectionItemInfo()

如果节点是集合项,则获取集合项信息。

GetExtraRenderingInfo()

获取 ExtraRenderingInfo extra rendering info 节点是否应使用额外数据刷新,以检查呈现相关的辅助功能问题。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetParent(Int32)

获取父级。

GetRangeInfo()

如果此节点是范围,则获取范围信息。

GetTouchDelegateInfo()

使用 TouchDelegateInfo 表示的视图获取触摸委托行为。

JavaFinalize()

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

(继承自 Object)
Notify()

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

(继承自 Object)
NotifyAll()

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

(继承自 Object)
Obtain()

实例化新的 AccessibilityNodeInfo。

Obtain(AccessibilityNodeInfo)

实例化从给定 info初始化的新 AccessibilityNodeInfo。

Obtain(View, Int32)

如果缓存实例可用,则返回一个新实例并设置源。

Obtain(View)

如果缓存实例可用,则返回一个新实例并设置源。

PerformAction(Action, Bundle)

在节点上执行操作。

PerformAction(Action)

在节点上执行操作。

Recycle()

以前将返回一个实例以重复使用。

Refresh()

使用它表示的视图的最新状态刷新此信息。

RefreshWithExtraData(String, Bundle)

使用它表示的视图的最新状态刷新此信息,并请求视图添加新数据。

RemoveAction(AccessibilityNodeInfo+AccessibilityAction)

删除可在节点上执行的操作。

RemoveAction(Int32)
已过时.

删除可在节点上执行的操作。

RemoveChild(View, Int32)

删除作为给定 root子代的虚拟子级。

RemoveChild(View)

删除子级。

RemoveLabeledBy(View, Int32)

此类表示窗口内容的节点以及可从其源请求的操作。

RemoveLabeledBy(View)

此类表示窗口内容的节点以及可从其源请求的操作。

SetBoundsInParent(Rect)

设置 viewParent 坐标中的节点边界。

SetBoundsInScreen(Rect)

设置屏幕坐标中的节点边界。

SetBoundsInWindow(Rect)

设置窗口坐标中的节点边界。

SetCanOpenPopup(Boolean)

设置此节点是否打开弹出窗口或对话框。

SetCollectionInfo(AccessibilityNodeInfo+CollectionInfo)

如果节点是集合,则设置集合信息。

SetCollectionItemInfo(AccessibilityNodeInfo+CollectionItemInfo)

如果节点是集合项,则设置收集项信息。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetLabeledBy(View, Int32)

设置视图,该视图用作此信息所表示的视图的标签,以实现辅助功能。

SetLabeledBy(View)

设置视图,该视图用作此信息所表示的视图的标签,以实现辅助功能。

SetLabelFor(View, Int32)

设置由此信息表示的视图用作辅助功能的标签的视图。

SetLabelFor(View)

设置由此信息表示的视图用作辅助功能的标签的视图。

SetParent(View, Int32)

将父级设置为给定 root的虚拟后代。

SetParent(View)

设置父级。

SetQueryFromAppProcessEnabled(View, Boolean)

将此节点连接到视图的根目录,以便此节点上的操作可以查询整个 AccessibilityNodeInfo 树,并在节点上执行辅助功能操作。

SetRangeInfo(AccessibilityNodeInfo+RangeInfo)

如果此节点是范围,则设置范围信息。

SetRequestInitialAccessibilityFocus(Boolean)

设置节点是否请求初始辅助功能焦点。

SetSource(View, Int32)

将源设置为给定 root的虚拟后代。

SetSource(View)

设置源。

SetTextSelection(Int32, Int32)

设置文本选择的开头和结尾。

SetTouchDelegateInfo(AccessibilityNodeInfo+TouchDelegateInfo)

如果表示的视图有一个 TouchDelegate,则设置触摸委托信息。

SetTraversalAfter(View, Int32)

设置在可访问性遍历中访问此节点的节点。

SetTraversalAfter(View)

设置在可访问性遍历中访问其节点之后的视图。

SetTraversalBefore(View, Int32)

设置遍历期间访问此节点的节点。

SetTraversalBefore(View)

设置视图,然后才能在遍历期间访问此节点。

ToArray<T>()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
ToString()

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

(继承自 Object)
UnregisterFromRuntime()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

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

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)

要添加

显式接口实现

名称 说明
IJavaPeerable.Disposed()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
IJavaPeerable.Finalized()

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

此类表示窗口内容的节点以及可从其源请求的操作。

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

此类表示窗口内容的节点以及可从其源请求的操作。

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

此类表示窗口内容的节点以及可从其源请求的操作。

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

此类表示窗口内容的节点以及可从其源请求的操作。

(继承自 Object)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

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

JavaAs<TResult>(IJavaPeerable)

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

JavaCast<TResult>(IJavaObject)

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

JavaCast<TResult>(IJavaObject)

此类表示窗口内容的节点以及可从其源请求的操作。

TryJavaCast<TResult>(IJavaPeerable, TResult)

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

适用于