public class AccessibilityNodeInfo
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.view.accessibility.AccessibilityNodeInfo |
这个类代表了窗口内容的一个节点,以及可以从源头请求的动作。 从AccessibilityService
的角度来看,一个窗口的内容被呈现为可访问节点信息的树状结构,其可以或不可以一对一映射到视图层次结构。 换句话说,自定义视图可以自由地将自身报告为可访问性节点信息树。
一旦将可访问性节点信息传递给可访问性服务,它将变为不可变的,并且调用状态变异方法会产生错误。
有关如何获取窗口内容句柄的详细信息,请参阅 AccessibilityService
,以获取辅助节点信息树以及有关安全模型的详细信息。
有关使应用程序可访问的更多信息,请阅读 Accessibility开发人员指南。
Nested classes |
|
---|---|
class |
AccessibilityNodeInfo.AccessibilityAction 定义可以在 |
class |
AccessibilityNodeInfo.CollectionInfo 如果一个节点是一个集合,则带有信息的类。 |
class |
AccessibilityNodeInfo.CollectionItemInfo 如果节点是集合项目,则包含信息类别。 |
class |
AccessibilityNodeInfo.RangeInfo 如果节点是范围,则包含信息类。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<AccessibilityNodeInfo> |
CREATOR |
Public methods |
|
---|---|
void |
addAction(int action) 此方法在API级别21中已被弃用。已针对 |
void |
addAction(AccessibilityNodeInfo.AccessibilityAction action) 添加可以在节点上执行的操作。 |
void |
addChild(View root, int virtualDescendantId) 添加一个虚拟孩子,它是给定的 |
void |
addChild(View child) 添加一个孩子。 |
boolean |
canOpenPopup() 获取该节点是否打开弹出窗口或对话框。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
boolean |
equals(Object object) 指示其他某个对象是否“等于”这一个。 |
List<AccessibilityNodeInfo> |
findAccessibilityNodeInfosByText(String text) 通过文本查找 |
List<AccessibilityNodeInfo> |
findAccessibilityNodeInfosByViewId(String viewId) 通过完全限定的视图ID的资源名称查找 |
AccessibilityNodeInfo |
findFocus(int focus) 找到具有指定焦点类型的视图。 |
AccessibilityNodeInfo |
focusSearch(int direction) 在指定的方向上搜索可输入焦点的最近视图。 |
List<AccessibilityNodeInfo.AccessibilityAction> |
getActionList() 获取可以在节点上执行的操作。 |
int |
getActions() 此方法在API级别21中已弃用。使用 |
void |
getBoundsInParent(Rect outBounds) 获取父坐标中的节点边界。 |
void |
getBoundsInScreen(Rect outBounds) 获取屏幕坐标中的节点边界。 |
AccessibilityNodeInfo |
getChild(int index) 获取给定索引的孩子。 |
int |
getChildCount() 获取孩子的数量。 |
CharSequence |
getClassName() 获取此节点来自的类。 |
AccessibilityNodeInfo.CollectionInfo |
getCollectionInfo() 如果节点是一个集合,则获取集合信息。 |
AccessibilityNodeInfo.CollectionItemInfo |
getCollectionItemInfo() 如果节点是集合项目,则获取集合项目信息。 |
CharSequence |
getContentDescription() 获取此节点的内容描述。 |
int |
getDrawingOrder() 获取与此节点对应的视图的绘制顺序。 |
CharSequence |
getError() 获取此节点的错误文本。 |
Bundle |
getExtras() 获取具有额外数据的可选包。 |
int |
getInputType() 获取 |
AccessibilityNodeInfo |
getLabelFor() 获取由此信息表示的视图作为可访问性标签的节点信息。 |
AccessibilityNodeInfo |
getLabeledBy() 获取节点信息,该信息充当此信息所表示的视图的标签以用于可访问性目的。 |
int |
getLiveRegion() 获取节点的实时区域模式。 |
int |
getMaxTextLength() 返回此节点的最大文本长度。 |
int |
getMovementGranularities() 获取遍历此节点文本的移动粒度。 |
CharSequence |
getPackageName() 获取此节点来自的包。 |
AccessibilityNodeInfo |
getParent() 获取父项。 |
AccessibilityNodeInfo.RangeInfo |
getRangeInfo() 如果此节点是范围,则获取范围信息。 |
CharSequence |
getText() 获取此节点的文本。 |
int |
getTextSelectionEnd() 如果选择了文本,则获取文本选择结束。 |
int |
getTextSelectionStart() 获取文本选择开始或光标位置。 |
AccessibilityNodeInfo |
getTraversalAfter() 获取在可访问性遍历中访问此节点后的节点。 |
AccessibilityNodeInfo |
getTraversalBefore() 获取在遍历期间之前访问的节点。 |
String |
getViewIdResourceName() 获取源视图的标识的完全限定资源名称。 |
AccessibilityWindowInfo |
getWindow() 获取此节点所属的窗口。 |
int |
getWindowId() 获取信息来自的窗口的ID。 |
int |
hashCode() 返回对象的哈希码值。 |
boolean |
isAccessibilityFocused() 获取此节点是否以可访问性为重点。 |
boolean |
isCheckable() 获取此节点是否可检查。 |
boolean |
isChecked() 获取是否检查此节点。 |
boolean |
isClickable() 获取此节点是否可点击。 |
boolean |
isContentInvalid() 获取此节点的内容是否无效。 |
boolean |
isContextClickable() 获取此节点是否可以上下文点击。 |
boolean |
isDismissable() 获取节点是否可以被解雇。 |
boolean |
isEditable() 获取节点是否可编辑。 |
boolean |
isEnabled() 获取此节点是否已启用。 |
boolean |
isFocusable() 获取此节点是否可以聚焦。 |
boolean |
isFocused() 获取这个节点是否关注。 |
boolean |
isImportantForAccessibility() 返回节点是否来自被认为对可访问性很重要的视图。 |
boolean |
isLongClickable() 获取此节点是否可以长时间点击。 |
boolean |
isMultiLine() 获取节点是否为多行可编辑文本。 |
boolean |
isPassword() 获取此节点是否为密码。 |
boolean |
isScrollable() 获取节点是否可滚动。 |
boolean |
isSelected() 获取该节点是否被选中。 |
boolean |
isVisibleToUser() 获取此节点对用户是否可见。 |
static AccessibilityNodeInfo |
obtain(View root, int virtualDescendantId) 如果可用,则返回缓存实例,否则返回新实例并设置源。 |
static AccessibilityNodeInfo |
obtain(AccessibilityNodeInfo info) 如果可用或创建新实例,则返回缓存实例。 |
static AccessibilityNodeInfo |
obtain() 如果可用,则返回一个缓存实例,否则返回一个新实例。 |
static AccessibilityNodeInfo |
obtain(View source) 如果可用,则返回缓存实例,否则返回新实例并设置源。 |
boolean |
performAction(int action, Bundle arguments) 在节点上执行操作。 |
boolean |
performAction(int action) 在节点上执行操作。 |
void |
recycle() 返回一个实例以重用。 |
boolean |
refresh() 刷新此信息并显示它所代表的视图的最新状态。 |
boolean |
removeAction(AccessibilityNodeInfo.AccessibilityAction action) 删除可以在节点上执行的操作。 |
void |
removeAction(int action) 此方法在API级别21中已弃用。使用 |
boolean |
removeChild(View root, int virtualDescendantId) 移除作为给定 |
boolean |
removeChild(View child) 移除一个孩子。 |
void |
setAccessibilityFocused(boolean focused) 设置此节点是否以可访问性为重点。 |
void |
setBoundsInParent(Rect bounds) 设置父坐标中的节点边界。 |
void |
setBoundsInScreen(Rect bounds) 设置屏幕坐标中的节点边界。 |
void |
setCanOpenPopup(boolean opensPopup) 设置此节点是否打开弹出窗口或对话框。 |
void |
setCheckable(boolean checkable) 设置此节点是否可检查。 |
void |
setChecked(boolean checked) 设置是否检查此节点。 |
void |
setClassName(CharSequence className) 设置此节点来自的类。 |
void |
setClickable(boolean clickable) 设置此节点是否可点击。 |
void |
setCollectionInfo(AccessibilityNodeInfo.CollectionInfo collectionInfo) 如果节点是集合,则设置集合信息。 |
void |
setCollectionItemInfo(AccessibilityNodeInfo.CollectionItemInfo collectionItemInfo) 如果节点是集合项目,则设置集合项目信息。 |
void |
setContentDescription(CharSequence contentDescription) 设置此节点的内容描述。 |
void |
setContentInvalid(boolean contentInvalid) 设置此节点的内容是否无效。 |
void |
setContextClickable(boolean contextClickable) 设置此节点是否可以上下文点击。 |
void |
setDismissable(boolean dismissable) 设置节点是否可以被解散。 |
void |
setDrawingOrder(int drawingOrderInParent) 设置与此节点对应的视图的绘制顺序。 |
void |
setEditable(boolean editable) 设置此节点是否可编辑。 |
void |
setEnabled(boolean enabled) 设置此节点是否已启用。 |
void |
setError(CharSequence error) 设置此节点的错误文本。 |
void |
setFocusable(boolean focusable) 设置此节点是否可以聚焦。 |
void |
setFocused(boolean focused) 设置此节点是否被聚焦。 |
void |
setImportantForAccessibility(boolean important) 设置节点是否被认为对可访问性很重要。 |
void |
setInputType(int inputType) 设置由 |
void |
setLabelFor(View root, int virtualDescendantId) 设置由此信息表示的视图作为可访问性标签的视图。 |
void |
setLabelFor(View labeled) 设置由此信息表示的视图作为可访问性标签的视图。 |
void |
setLabeledBy(View label) 为可访问性目的设置用作此信息所表示的视图标签的视图。 |
void |
setLabeledBy(View root, int virtualDescendantId) 为可访问性目的设置用作此信息所表示的视图标签的视图。 |
void |
setLiveRegion(int mode) 设置节点的实时区域模式。 |
void |
setLongClickable(boolean longClickable) 设置此节点是否可以长时间点击。 |
void |
setMaxTextLength(int max) 设置最大文本长度,或者-1表示无限制。 |
void |
setMovementGranularities(int granularities) 设置遍历此节点文本的移动粒度。 |
void |
setMultiLine(boolean multiLine) 设置节点是否为多行可编辑文本。 |
void |
setPackageName(CharSequence packageName) 设置此节点来自的包。 |
void |
setParent(View root, int virtualDescendantId) 将父项设置为给定 |
void |
setParent(View parent) 设置父级。 |
void |
setPassword(boolean password) 设置此节点是否是密码。 |
void |
setRangeInfo(AccessibilityNodeInfo.RangeInfo rangeInfo) 如果此节点是范围,则设置范围信息。 |
void |
setScrollable(boolean scrollable) 设置节点是否可滚动。 |
void |
setSelected(boolean selected) 设置是否选择此节点。 |
void |
setSource(View source) 设置来源。 |
void |
setSource(View root, int virtualDescendantId) 将源设置为给定 |
void |
setText(CharSequence text) 设置此节点的文本。 |
void |
setTextSelection(int start, int end) 设置文本选择开始和结束。 |
void |
setTraversalAfter(View view) 在可访问性遍历中设置此节点访问完该节点后的视图。 |
void |
setTraversalAfter(View root, int virtualDescendantId) 在可访问性遍历中设置访问此节点后的节点。 |
void |
setTraversalBefore(View view) 在遍历期间应该在其节点之前设置该节点的视图。 |
void |
setTraversalBefore(View root, int virtualDescendantId) 设置遍历期间之前访问此节点的节点。 |
void |
setViewIdResourceName(String viewIdResName) 设置源视图的标识的完全限定资源名称。 |
void |
setVisibleToUser(boolean visibleToUser) 设置此节点对用户是否可见。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel parcel, int flags) 将此对象平铺到一个包裹中。 注意:将实例写入包裹后,它将被回收。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
int ACTION_ACCESSIBILITY_FOCUS
为节点提供可访问性焦点的操作。
常量值:64(0x00000040)
String ACTION_ARGUMENT_COLUMN_INT
指定收集列以使其在屏幕上可见的参数。
类型: int
操作:
也可以看看:
常量值:“android.view.accessibility.action.ARGUMENT_COLUMN_INT”
String ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN
有关当按粒度移动以延伸选择或以其他方式移动时的争论。
类型:布尔值
操作:
常数值:“ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN”
String ACTION_ARGUMENT_HTML_ELEMENT_STRING
要移动到下一个/上一个HTML元素的HTML元素的参数。
类型:字符串
操作:
常量值:“ACTION_ARGUMENT_HTML_ELEMENT_STRING”
String ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT
遍历节点文本时使用移动粒度的参数。
类型: int
操作:
常量值:“ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT”
String ACTION_ARGUMENT_PROGRESS_VALUE
用于指定要设置的进度值的参数。
类型: float
操作:
也可以看看:
常量值:“android.view.accessibility.action.ARGUMENT_PROGRESS_VALUE”
String ACTION_ARGUMENT_ROW_INT
指定收集行以使其在屏幕上可见的参数。
类型: int
操作:
也可以看看:
常量值:“android.view.accessibility.action.ARGUMENT_ROW_INT”
String ACTION_ARGUMENT_SELECTION_END_INT
指定选择结束的参数。
类型: int
操作:
也可以看看:
常量值:“ACTION_ARGUMENT_SELECTION_END_INT”
String ACTION_ARGUMENT_SELECTION_START_INT
指定选择开始的参数。
类型: int
操作:
也可以看看:
常量值:“ACTION_ARGUMENT_SELECTION_START_INT”
String ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE
用于指定要设置的文本内容的参数。
类型: CharSequence
操作:
也可以看看:
常量值:“ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE”
int ACTION_CLEAR_ACCESSIBILITY_FOCUS
清除节点可访问性焦点的操作。
常量值:128(0x00000080)
int ACTION_CLEAR_SELECTION
取消选择节点的操作。
常量值:8(0x00000008)
int ACTION_NEXT_AT_MOVEMENT_GRANULARITY
请求以给定移动粒度前往该节点文本中下一个实体的动作。 例如,移至下一个字符,单词等。
参数: ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT
<, ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN
示例:移至上一个字符并且不扩展选择。
Bundle arguments = new Bundle(); arguments.putInt(AccessibilityNodeInfo.ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT, AccessibilityNodeInfo.MOVEMENT_GRANULARITY_CHARACTER); arguments.putBoolean(AccessibilityNodeInfo.ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN, false); info.performAction(AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY, arguments);
也可以看看:
常量值:256(0x00000100)
int ACTION_NEXT_HTML_ELEMENT
采取措施移动到给定类型的下一个HTML元素。 例如,移至按钮,输入,表格等
参数: ACTION_ARGUMENT_HTML_ELEMENT_STRING
例如:
Bundle arguments = new Bundle(); arguments.putString(AccessibilityNodeInfo.ACTION_ARGUMENT_HTML_ELEMENT_STRING, "BUTTON"); info.performAction(AccessibilityNodeInfo.ACTION_NEXT_HTML_ELEMENT, arguments);
常量值:1024(0x00000400)
int ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY
请求以给定移动粒度前往该节点文本中的前一个实体的操作。 例如,移至下一个字符,单词等。
参数: ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT
<, ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN
示例:移至下一个字符并且不扩展选择。
Bundle arguments = new Bundle(); arguments.putInt(AccessibilityNodeInfo.ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT, AccessibilityNodeInfo.MOVEMENT_GRANULARITY_CHARACTER); arguments.putBoolean(AccessibilityNodeInfo.ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN, false); info.performAction(AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY, arguments);
也可以看看:
常量值:512(0x00000200)
int ACTION_PREVIOUS_HTML_ELEMENT
要移动到给定类型的前一个HTML元素的操作。 例如,移至按钮,输入,表格等
参数: ACTION_ARGUMENT_HTML_ELEMENT_STRING
例如:
Bundle arguments = new Bundle(); arguments.putString(AccessibilityNodeInfo.ACTION_ARGUMENT_HTML_ELEMENT_STRING, "BUTTON"); info.performAction(AccessibilityNodeInfo.ACTION_PREVIOUS_HTML_ELEMENT, arguments);
常量值:2048(0x00000800)
int ACTION_SCROLL_BACKWARD
向后滚动节点内容的动作。
常量值:8192(0x00002000)
int ACTION_SCROLL_FORWARD
向前滚动节点内容的操作。
常量值:4096(0x00001000)
int ACTION_SET_SELECTION
设置选择的动作。 不使用参数执行此操作将清除选择。
参数: ACTION_ARGUMENT_SELECTION_START_INT
, ACTION_ARGUMENT_SELECTION_END_INT
例如:
Bundle arguments = new Bundle(); arguments.putInt(AccessibilityNodeInfo.ACTION_ARGUMENT_SELECTION_START_INT, 1); arguments.putInt(AccessibilityNodeInfo.ACTION_ARGUMENT_SELECTION_END_INT, 2); info.performAction(AccessibilityNodeInfo.ACTION_SET_SELECTION, arguments);
常量值:131072(0x00020000)
int ACTION_SET_TEXT
设置节点文本的操作。 使用null
或清空CharSequence
执行无参数操作将清除文本。 这个动作也会把光标放在文本的末尾。
参数: ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE
例如:
Bundle arguments = new Bundle(); arguments.putCharSequence(AccessibilityNodeInfo.ACTION_ARGUMENT_SET_TEXT_CHARSEQUENCE, "android"); info.performAction(AccessibilityNodeInfo.ACTION_SET_TEXT, arguments);
常量值:2097152(0x00200000)
int MOVEMENT_GRANULARITY_CHARACTER
移动粒度位,用于按字符遍历节点的文本。
常数值:1(0x00000001)
int MOVEMENT_GRANULARITY_LINE
移动粒度位,用于逐行遍历节点的文本。
常量值:4(0x00000004)
int MOVEMENT_GRANULARITY_PAGE
移动粒度位,用于逐页遍历节点的文本。
常量值:16(0x00000010)
int MOVEMENT_GRANULARITY_PARAGRAPH
移动粒度位,用于逐段遍历节点的文本。
常量值:8(0x00000008)
int MOVEMENT_GRANULARITY_WORD
运动粒度位,用于逐个遍历节点的文本。
常量值:2(0x00000002)
void addAction (int action)
此方法在API级别21中已弃用。
这已被弃用addAction(AccessibilityAction)
添加可以在节点上执行的操作。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
action |
int : The action. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
IllegalArgumentException |
If the argument is not one of the standard actions. |
void addAction (AccessibilityNodeInfo.AccessibilityAction action)
添加可以在节点上执行的操作。
要添加标准操作,请使用AccessibilityNodeInfo.AccessibilityAction
上的静态常量。 要添加自定义操作,请创建一个新的AccessibilityNodeInfo.AccessibilityAction
,方法是从您的应用程序传入一个资源ID作为操作ID和描述该操作的可选标签。 重写其中一个标准动作,用作标准动作标识的动作标识,例如ACTION_CLICK
和描述动作的可选标签。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
action |
AccessibilityNodeInfo.AccessibilityAction : The action. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void addChild (View root, int virtualDescendantId)
添加一个虚拟孩子,它是给定的root
的后代。 如果virtualDescendantId
是NO_ID
则根作为孩子添加。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图能够将它们自己报告为虚拟视图树,从而传达其逻辑结构。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual child. |
void addChild (View child)
添加一个孩子。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
child |
View : The child. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
boolean canOpenPopup ()
获取该节点是否打开弹出窗口或对话框。
Returns | |
---|---|
boolean |
If the the node opens a popup. |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
boolean equals (Object object)
指示其他某个对象是否“等于”这一个。
equals
方法在非空对象引用上实现等价关系:
x
, x.equals(x)
should return true
. x
and y
, x.equals(y)
should return true
if and only if y.equals(x)
returns true
. x
, y
, and z
, if x.equals(y)
returns true
and y.equals(z)
returns true
, then x.equals(z)
should return true
. x
and y
, multiple invocations of x.equals(y)
consistently return true
or consistently return false
, provided no information used in equals
comparisons on the objects is modified. x
, x.equals(null)
should return false
. 类equals
方法Object
实现对象上最可能的等价关系; 也就是说,对于任何非空参考值x
和y
,当且仅当x
和y
指向同一对象( x == y
的值为true
)时,此方法返回true
。
请注意,无论何时重写此方法,通常都需要重写 hashCode
方法,以便维护 hashCode
方法的一般合同,该方法声明相等对象必须具有相同的哈希代码。
Parameters | |
---|---|
object |
Object : the reference object with which to compare. |
Returns | |
---|---|
boolean |
true if this object is the same as the obj argument; false otherwise. |
List<AccessibilityNodeInfo> findAccessibilityNodeInfosByText (String text)
通过文本查找AccessibilityNodeInfo
。 这场比赛是不区分大小写的遏制。 搜索是相对于这个信息,即这个信息是遍历树的根。
注意:通过调用 recycle()
来回收接收到的信息是客户的责任,以避免创建多个实例。
Parameters | |
---|---|
text |
String : The searched text. |
Returns | |
---|---|
List<AccessibilityNodeInfo> |
A list of node info. |
List<AccessibilityNodeInfo> findAccessibilityNodeInfosByViewId (String viewId)
通过完全限定的视图ID的资源名称查找AccessibilityNodeInfo
,其中完全限定的ID来自“package:id / id_resource_name”。 例如,如果目标应用程序的包是“foo.bar”,并且id资源名称是“baz”,则完全限定的资源ID是“foo.bar:id/baz”。
注意:通过调用 recycle()
来回收接收到的信息是客户的责任,以避免创建多个实例。
注意:这个API的主要用途是UI测试自动化,并以报告完全合格的视图id如果 AccessibilityNodeInfo
客户端必须设置 FLAG_REPORT_VIEW_IDS
配置其在标志 AccessibilityService
。
Parameters | |
---|---|
viewId |
String : The fully qualified resource name of the view id to find. |
Returns | |
---|---|
List<AccessibilityNodeInfo> |
A list of node info. |
AccessibilityNodeInfo findFocus (int focus)
找到具有指定焦点类型的视图。 搜索从此节点信息表示的视图开始。
Parameters | |
---|---|
focus |
int : The focus to find. One of FOCUS_INPUT or FOCUS_ACCESSIBILITY . |
Returns | |
---|---|
AccessibilityNodeInfo |
The node info of the focused view or null. |
也可以看看:
AccessibilityNodeInfo focusSearch (int direction)
在指定的方向上搜索可输入焦点的最近视图。
Parameters | |
---|---|
direction |
int : The direction. Can be one of: FOCUS_DOWN , FOCUS_UP , FOCUS_LEFT , FOCUS_RIGHT , FOCUS_FORWARD , FOCUS_BACKWARD . |
Returns | |
---|---|
AccessibilityNodeInfo |
The node info for the view that can take accessibility focus. |
List<AccessibilityNodeInfo.AccessibilityAction> getActionList ()
获取可以在节点上执行的操作。
Returns | |
---|---|
List<AccessibilityNodeInfo.AccessibilityAction> |
int getActions ()
此方法在API级别21中已弃用。
使用getActionList()
。
获取可以在节点上执行的操作。
Returns | |
---|---|
int |
The bit mask of with actions. |
也可以看看:
ACTION_FOCUS
ACTION_CLEAR_FOCUS
ACTION_SELECT
ACTION_CLEAR_SELECTION
ACTION_ACCESSIBILITY_FOCUS
ACTION_CLEAR_ACCESSIBILITY_FOCUS
ACTION_CLICK
ACTION_LONG_CLICK
ACTION_NEXT_AT_MOVEMENT_GRANULARITY
ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY
ACTION_NEXT_HTML_ELEMENT
ACTION_PREVIOUS_HTML_ELEMENT
ACTION_SCROLL_FORWARD
ACTION_SCROLL_BACKWARD
void getBoundsInParent (Rect outBounds)
获取父坐标中的节点边界。
Parameters | |
---|---|
outBounds |
Rect : The output node bounds. |
void getBoundsInScreen (Rect outBounds)
获取屏幕坐标中的节点边界。
Parameters | |
---|---|
outBounds |
Rect : The output node bounds. |
AccessibilityNodeInfo getChild (int index)
获取给定索引的孩子。
Note: It is a client responsibility to recycle the received info by calling recycle()
to avoid creating of multiple instances.
Parameters | |
---|---|
index |
int : The child index. |
Returns | |
---|---|
AccessibilityNodeInfo |
The child node. |
Throws | |
---|---|
IllegalStateException |
If called outside of an AccessibilityService. |
CharSequence getClassName ()
获取此节点来自的类。
Returns | |
---|---|
CharSequence |
The class name. |
AccessibilityNodeInfo.CollectionInfo getCollectionInfo ()
如果节点是一个集合,则获取集合信息。 收集孩子总是一个收集项目。
Returns | |
---|---|
AccessibilityNodeInfo.CollectionInfo |
The collection info. |
AccessibilityNodeInfo.CollectionItemInfo getCollectionItemInfo ()
如果节点是集合项目,则获取集合项目信息。 收集项目始终是收集的子项。
Returns | |
---|---|
AccessibilityNodeInfo.CollectionItemInfo |
The collection item info. |
CharSequence getContentDescription ()
获取此节点的内容描述。
Returns | |
---|---|
CharSequence |
The content description. |
int getDrawingOrder ()
获取与此节点对应的视图的绘制顺序。
绘图顺序仅在节点的父节点中确定,因此此索引仅相对于其兄弟节点。
在某些情况下,绘图顺序基本上是同时发生的,所以有可能两个同胞返回相同的值。 值也可能会跳过。
Returns | |
---|---|
int |
The drawing position of the view corresponding to this node relative to its siblings. |
CharSequence getError ()
获取此节点的错误文本。
Returns | |
---|---|
CharSequence |
The error text. |
Bundle getExtras ()
获取具有额外数据的可选包。 这个包是懒洋洋地创建的,从来没有null
。
注意:建议使用应用程序的包名称作为密钥的前缀,以避免可能会混淆可访问性服务的冲突,如果同一个密钥在从不同应用程序发出时具有不同含义。
Returns | |
---|---|
Bundle |
The bundle. |
int getInputType ()
获取 InputType
定义的源的输入类型。
Returns | |
---|---|
int |
The input type. |
AccessibilityNodeInfo getLabelFor ()
获取由此信息表示的视图作为可访问性标签的节点信息。
注意:通过调用 recycle()
来回收接收到的信息是客户的责任,以避免创建多个实例。
Returns | |
---|---|
AccessibilityNodeInfo |
The labeled info. |
AccessibilityNodeInfo getLabeledBy ()
获取节点信息,该信息充当此信息所表示的视图的标签以用于可访问性目的。
注意:通过调用 recycle()
来回收收到的信息是客户的责任,以避免创建多个实例。
Returns | |
---|---|
AccessibilityNodeInfo |
The label. |
int getLiveRegion ()
获取节点的实时区域模式。
活动区域是一个节点,其中包含对用户很重要的信息,当它发生变化时,应通知用户。 例如,在具有显示“密码错误”通知的TextView的登录屏幕中,应该将该视图标记为模式为ACCESSIBILITY_LIVE_REGION_POLITE
的实时区域。
无障碍服务负责监控 TYPE_WINDOW_CONTENT_CHANGED
事件,该事件指示对活动区域节点及其子节点的更改。
Returns | |
---|---|
int |
The live region mode, or ACCESSIBILITY_LIVE_REGION_NONE if the view is not a live region. |
也可以看看:
int getMaxTextLength ()
返回此节点的最大文本长度。
Returns | |
---|---|
int |
The maximum text length, or -1 for no limit. |
也可以看看:
int getMovementGranularities ()
获取遍历此节点文本的移动粒度。
Returns | |
---|---|
int |
The bit mask with granularities. |
CharSequence getPackageName ()
获取此节点来自的包。
Returns | |
---|---|
CharSequence |
The package name. |
AccessibilityNodeInfo getParent ()
获取父项。
注意:通过调用 recycle()
来回收接收到的信息是客户的责任,以避免创建多个实例。
Returns | |
---|---|
AccessibilityNodeInfo |
The parent. |
AccessibilityNodeInfo.RangeInfo getRangeInfo ()
如果此节点是范围,则获取范围信息。
Returns | |
---|---|
AccessibilityNodeInfo.RangeInfo |
The range. |
int getTextSelectionEnd ()
如果选择了文本,则获取文本选择结束。
如果未选择文本,则此方法和 getTextSelectionStart()
返回相同的值:光标的当前位置。
Returns | |
---|---|
int |
The text selection end, the cursor location if there is no selection, or -1 if there is no text selection and no cursor. |
int getTextSelectionStart ()
获取文本选择开始或光标位置。
如果未选择文本,则此方法和 getTextSelectionEnd()
返回相同的值:光标的当前位置。
Returns | |
---|---|
int |
The text selection start, the cursor location if there is no selection, or -1 if there is no text selection and no cursor. |
AccessibilityNodeInfo getTraversalAfter ()
获取在可访问性遍历中访问此节点后的节点。 屏幕阅读器必须在此内容之前访问其他节点的内容。
Returns | |
---|---|
AccessibilityNodeInfo |
The succeeding node if such or null . |
AccessibilityNodeInfo getTraversalBefore ()
获取在遍历期间之前访问的节点。 屏幕阅读器必须在它之前的内容之前访问此节点的内容。
Returns | |
---|---|
AccessibilityNodeInfo |
The succeeding node if such or null . |
String getViewIdResourceName ()
获取源视图的标识的完全限定资源名称。
注意:此API的主要用途是用于UI测试自动化,并且为了报告 AccessibilityNodeInfo
的源视图ID,客户端在配置其 AccessibilityService
时必须设置 FLAG_REPORT_VIEW_IDS
标志。
Returns | |
---|---|
String |
The id resource name. |
AccessibilityWindowInfo getWindow ()
获取此节点所属的窗口。
Returns | |
---|---|
AccessibilityWindowInfo |
The window. |
也可以看看:
int hashCode ()
返回对象的哈希码值。 为了散列表的好处而支持此方法,例如由HashMap
提供的HashMap
。
一般合同 hashCode
是:
hashCode
method must consistently return the same integer, provided no information used in equals
comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. equals(Object)
method, then calling the hashCode
method on each of the two objects must produce the same integer result. equals(java.lang.Object)
method, then calling the hashCode
method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. 尽可能合理实用,由类Object
定义的hashCode方法确实为不同的对象返回不同的整数。 (这通常通过将对象的内部地址转换为整数来实现,但Java TM编程语言不需要此实现技术。)
Returns | |
---|---|
int |
a hash code value for this object. |
boolean isAccessibilityFocused ()
获取此节点是否以可访问性为重点。
Returns | |
---|---|
boolean |
True if the node is accessibility focused. |
boolean isCheckable ()
获取此节点是否可检查。
Returns | |
---|---|
boolean |
True if the node is checkable. |
boolean isChecked ()
获取是否检查此节点。
Returns | |
---|---|
boolean |
True if the node is checked. |
boolean isClickable ()
获取此节点是否可点击。
Returns | |
---|---|
boolean |
True if the node is clickable. |
boolean isContentInvalid ()
获取此节点的内容是否无效。 例如,日期格式不正确。
Returns | |
---|---|
boolean |
If the node content is invalid. |
boolean isContextClickable ()
获取此节点是否可以上下文点击。
Returns | |
---|---|
boolean |
True if the node is context clickable. |
boolean isDismissable ()
获取节点是否可以被解雇。
Returns | |
---|---|
boolean |
If the node can be dismissed. |
boolean isEditable ()
获取节点是否可编辑。
Returns | |
---|---|
boolean |
True if the node is editable, false otherwise. |
boolean isEnabled ()
获取此节点是否已启用。
Returns | |
---|---|
boolean |
True if the node is enabled. |
boolean isFocusable ()
获取此节点是否可以聚焦。
Returns | |
---|---|
boolean |
True if the node is focusable. |
boolean isFocused ()
获取这个节点是否关注。
Returns | |
---|---|
boolean |
True if the node is focused. |
boolean isImportantForAccessibility ()
返回节点是否来自被认为对可访问性很重要的视图。
Returns | |
---|---|
boolean |
true if the node originates from a view considered important for accessibility, false otherwise |
boolean isLongClickable ()
获取此节点是否可以长时间点击。
Returns | |
---|---|
boolean |
True if the node is long clickable. |
boolean isMultiLine ()
获取节点是否为多行可编辑文本。
Returns | |
---|---|
boolean |
True if the node is multi line. |
boolean isPassword ()
获取此节点是否为密码。
Returns | |
---|---|
boolean |
True if the node is a password. |
boolean isScrollable ()
获取节点是否可滚动。
Returns | |
---|---|
boolean |
True if the node is scrollable, false otherwise. |
boolean isSelected ()
获取该节点是否被选中。
Returns | |
---|---|
boolean |
True if the node is selected. |
boolean isVisibleToUser ()
获取此节点对用户是否可见。
Returns | |
---|---|
boolean |
Whether the node is visible to the user. |
AccessibilityNodeInfo obtain (View root, int virtualDescendantId)
如果可用,则返回缓存实例,否则返回新实例并设置源。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual descendant. |
Returns | |
---|---|
AccessibilityNodeInfo |
An instance. |
也可以看看:
AccessibilityNodeInfo obtain (AccessibilityNodeInfo info)
如果可用或创建新实例,则返回缓存实例。 返回的实例从给定的info
初始化。
Parameters | |
---|---|
info |
AccessibilityNodeInfo : The other info. |
Returns | |
---|---|
AccessibilityNodeInfo |
An instance. |
AccessibilityNodeInfo obtain ()
如果可用,则返回一个缓存实例,否则返回一个新实例。
Returns | |
---|---|
AccessibilityNodeInfo |
An instance. |
AccessibilityNodeInfo obtain (View source)
如果可用,则返回缓存实例,否则返回新实例并设置源。
Parameters | |
---|---|
source |
View : The source view. |
Returns | |
---|---|
AccessibilityNodeInfo |
An instance. |
也可以看看:
boolean performAction (int action, Bundle arguments)
在节点上执行操作。
注意:只有在请求来自 AccessibilityService
才能执行操作。
Parameters | |
---|---|
action |
int : The action to perform. |
arguments |
Bundle : A bundle with additional arguments. |
Returns | |
---|---|
boolean |
True if the action was performed. |
Throws | |
---|---|
IllegalStateException |
If called outside of an AccessibilityService. |
boolean performAction (int action)
在节点上执行操作。
注意:只有在请求来自 AccessibilityService
才能执行操作。
Parameters | |
---|---|
action |
int : The action to perform. |
Returns | |
---|---|
boolean |
True if the action was performed. |
Throws | |
---|---|
IllegalStateException |
If called outside of an AccessibilityService. |
void recycle ()
返回一个实例以重用。
注意:调用此函数后,请勿触摸对象。
Throws | |
---|---|
IllegalStateException |
If the info is already recycled. |
boolean refresh ()
刷新此信息并显示它所代表的视图的最新状态。
注意:如果此方法返回false,则此信息已过时,因为它表示不再位于视图树中并应回收的视图。
Returns | |
---|---|
boolean |
Whether the refresh succeeded. |
boolean removeAction (AccessibilityNodeInfo.AccessibilityAction action)
删除可以在节点上执行的操作。 如果操作尚未添加到节点,则调用此方法不起作用。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
action |
AccessibilityNodeInfo.AccessibilityAction : The action to be removed. |
Returns | |
---|---|
boolean |
The action removed from the list of actions. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void removeAction (int action)
此方法在API级别21中已弃用。
使用removeAction(AccessibilityAction)
删除可以在节点上执行的操作。 如果操作尚未添加到节点,则调用此方法不起作用。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
action |
int : The action to be removed. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
boolean removeChild (View root, int virtualDescendantId)
移除作为给定root
的后代的虚拟孩子。 如果以前没有将孩子添加到节点中,则调用此方法不起作用。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual child. |
Returns | |
---|---|
boolean |
true if the child was present |
也可以看看:
boolean removeChild (View child)
移除一个孩子。 如果以前没有将孩子添加到节点中,则调用此方法不起作用。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
child |
View : The child. |
Returns | |
---|---|
boolean |
true if the child was present |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setAccessibilityFocused (boolean focused)
设置此节点是否以可访问性为重点。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
focused |
boolean : True if the node is accessibility focused. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setBoundsInParent (Rect bounds)
设置父坐标中的节点边界。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
bounds |
Rect : The node bounds. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setBoundsInScreen (Rect bounds)
设置屏幕坐标中的节点边界。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
bounds |
Rect : The node bounds. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setCanOpenPopup (boolean opensPopup)
设置此节点是否打开弹出窗口或对话框。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
opensPopup |
boolean : If the the node opens a popup. |
void setCheckable (boolean checkable)
设置此节点是否可检查。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
checkable |
boolean : True if the node is checkable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setChecked (boolean checked)
设置是否检查此节点。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
checked |
boolean : True if the node is checked. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setClassName (CharSequence className)
设置此节点来自的类。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
className |
CharSequence : The class name. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setClickable (boolean clickable)
设置此节点是否可点击。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
clickable |
boolean : True if the node is clickable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setCollectionInfo (AccessibilityNodeInfo.CollectionInfo collectionInfo)
如果节点是集合,则设置集合信息。 收集孩子总是一个收集项目。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
collectionInfo |
AccessibilityNodeInfo.CollectionInfo : The collection info. |
void setCollectionItemInfo (AccessibilityNodeInfo.CollectionItemInfo collectionItemInfo)
如果节点是集合项目,则设置集合项目信息。 收集项目始终是收集的子项。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
collectionItemInfo |
AccessibilityNodeInfo.CollectionItemInfo
|
void setContentDescription (CharSequence contentDescription)
设置此节点的内容描述。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
contentDescription |
CharSequence : The content description. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setContentInvalid (boolean contentInvalid)
设置此节点的内容是否无效。 例如,日期格式不正确。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
contentInvalid |
boolean : If the node content is invalid. |
void setContextClickable (boolean contextClickable)
设置此节点是否可以上下文点击。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
contextClickable |
boolean : True if the node is context clickable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setDismissable (boolean dismissable)
设置节点是否可以被解散。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
dismissable |
boolean : If the node can be dismissed. |
void setDrawingOrder (int drawingOrderInParent)
设置与此节点对应的视图的绘制顺序。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setEditable (boolean editable)
设置此节点是否可编辑。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
editable |
boolean : True if the node is editable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setEnabled (boolean enabled)
设置此节点是否已启用。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
enabled |
boolean : True if the node is enabled. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setError (CharSequence error)
设置此节点的错误文本。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
error |
CharSequence : The error text. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setFocusable (boolean focusable)
设置此节点是否可以聚焦。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
focusable |
boolean : True if the node is focusable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setFocused (boolean focused)
设置此节点是否被聚焦。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
focused |
boolean : True if the node is focused. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setImportantForAccessibility (boolean important)
设置节点是否被认为对可访问性很重要。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
important |
boolean : true if the node is considered important for accessibility, false otherwise |
void setInputType (int inputType)
设置由 InputType
定义的源的输入类型。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
inputType |
int : The input type. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setLabelFor (View root, int virtualDescendantId)
设置由此信息表示的视图作为可访问性标签的视图。 如果virtualDescendantId
是NO_ID
则根被设置为标记。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图可以将自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root whose virtual descendant serves as a label. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setLabelFor (View labeled)
设置由此信息表示的视图作为可访问性标签的视图。
Parameters | |
---|---|
labeled |
View : The view for which this info serves as a label. |
void setLabeledBy (View label)
为可访问性目的设置用作此信息所表示的视图标签的视图。
Parameters | |
---|---|
label |
View : The view that labels this node's source. |
void setLabeledBy (View root, int virtualDescendantId)
为可访问性目的设置用作此信息所表示的视图标签的视图。 如果virtualDescendantId
是NO_ID
则根被设置为标签。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图可以将自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root whose virtual descendant labels this node's source. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setLiveRegion (int mode)
设置节点的实时区域模式。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
mode |
int : The live region mode, or ACCESSIBILITY_LIVE_REGION_NONE if the view is not a live region. |
void setLongClickable (boolean longClickable)
设置此节点是否可以长时间点击。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
longClickable |
boolean : True if the node is long clickable. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setMaxTextLength (int max)
设置最大文本长度,或者-1表示无限制。
通常用于指示可编辑文本字段对输入的字符数量有限制。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
max |
int : The maximum text length. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
也可以看看:
void setMovementGranularities (int granularities)
设置遍历此节点文本的移动粒度。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
granularities |
int : The bit mask with granularities. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setMultiLine (boolean multiLine)
设置节点是否为多行可编辑文本。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
multiLine |
boolean : True if the node is multi line. |
void setPackageName (CharSequence packageName)
设置此节点来自的包。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
packageName |
CharSequence : The package name. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setParent (View root, int virtualDescendantId)
将父项设置为给定root
的虚拟后代。 如果virtualDescendantId
等于NO_ID
则将根设置为父级。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图能够将它们自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setParent (View parent)
设置父级。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
parent |
View : The parent. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setPassword (boolean password)
设置此节点是否是密码。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
password |
boolean : True if the node is a password. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setRangeInfo (AccessibilityNodeInfo.RangeInfo rangeInfo)
如果此节点是范围,则设置范围信息。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
rangeInfo |
AccessibilityNodeInfo.RangeInfo : The range info. |
void setScrollable (boolean scrollable)
设置节点是否可滚动。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
scrollable |
boolean : True if the node is scrollable, false otherwise. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setSelected (boolean selected)
设置是否选择此节点。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
selected |
boolean : True if the node is selected. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setSource (View source)
设置来源。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
source |
View : The info source. |
void setSource (View root, int virtualDescendantId)
将源设置为给定的root
的虚拟后代。 如果virtualDescendantId
是NO_ID
则将根设置为源。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图可以将自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setText (CharSequence text)
设置此节点的文本。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
text |
CharSequence : The text. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setTextSelection (int start, int end)
设置文本选择开始和结束。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
start |
int : The text selection start. |
end |
int : The text selection end. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
void setTraversalAfter (View view)
在可访问性遍历中设置此节点访问完该节点后的视图。 屏幕阅读器必须在此内容之前访问其他节点的内容。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
view |
View : The previous view. |
也可以看看:
void setTraversalAfter (View root, int virtualDescendantId)
在可访问性遍历中设置访问此节点后的节点。 屏幕阅读器必须在此内容之前访问其他节点的内容。 如果virtualDescendantId
等于NO_ID
则根被设置为前驱。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图能够将它们自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setTraversalBefore (View view)
在遍历期间应该在其节点之前设置该节点的视图。 屏幕阅读器必须在它之前的内容之前访问此节点的内容。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
view |
View : The view providing the preceding node. |
也可以看看:
void setTraversalBefore (View root, int virtualDescendantId)
设置遍历期间之前访问此节点的节点。 屏幕阅读器必须在它之前的内容之前访问此节点的内容。 后继者是给定的root
的虚拟后裔。 如果virtualDescendantId
等于NO_ID
则根被设置为后继者。
虚拟后代是一个假想的视图,作为可见性层次结构的一部分进行报告,以实现可访问性。 这使得绘制复杂内容的自定义视图能够将它们自己报告为虚拟视图树,从而传达其逻辑结构。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
root |
View : The root of the virtual subtree. |
virtualDescendantId |
int : The id of the virtual descendant. |
void setViewIdResourceName (String viewIdResName)
设置源视图的标识的完全限定资源名称。
Note: Cannot be called from an AccessibilityService
. This class is made immutable before being delivered to an AccessibilityService.
Parameters | |
---|---|
viewIdResName |
String : The id resource name. |
void setVisibleToUser (boolean visibleToUser)
设置此节点对用户是否可见。
注意:不能从AccessibilityService
。 这个类在交付给AccessibilityService之前是不可变的。
Parameters | |
---|---|
visibleToUser |
boolean : Whether the node is visible to the user. |
Throws | |
---|---|
IllegalStateException |
If called from an AccessibilityService. |
String toString ()
返回对象的字符串表示形式。 一般来说, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel parcel, int flags)
将此对象平铺到一个包裹中。
注意:将实例写入包裹后,它将被回收。 调用此函数后,请勿触摸对象。
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_WRITE_RETURN_VALUE . |