UiSelector
public class UiSelector
extends Object
java.lang.Object |
↳ |
android.support.test.uiautomator.UiSelector |
指定要测试的布局层次结构中的元素,通过诸如文本值,内容描述,类名称和状态信息等属性进行过滤。 您还可以通过在布局层次结构中的位置来定位元素。
Summary
Inherited methods |
From class java.lang.Object
Object |
clone() |
boolean |
equals(Object arg0) |
void |
finalize() |
final Class<?> |
getClass() |
int |
hashCode() |
final void |
notify() |
final void |
notifyAll() |
String |
toString() |
final void |
wait(long arg0, int arg1) |
final void |
wait(long arg0) |
final void |
wait() |
|
Public constructors
Public methods
checkable
UiSelector checkable (boolean val)
设置搜索条件以匹配可检查的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
checked
UiSelector checked (boolean val)
设置搜索条件以匹配当前选中的小部件(通常用于复选框)。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
childSelector
UiSelector childSelector (UiSelector selector)
向此选择器添加一个子UiSelector条件。 使用此选择器可将搜索范围缩小到特定父窗口小部件下的子窗口小部件。
Returns |
UiSelector |
UiSelector with this added search criterion |
className
UiSelector className (String className)
设置搜索条件以匹配小部件的类属性(例如,“android.widget.Button”)。
Parameters |
className |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
className
UiSelector className (Class<T> type)
设置搜索条件以匹配小部件的类属性(例如,“android.widget.Button”)。
Parameters |
type |
Class : type |
Returns |
UiSelector |
UiSelector with the specified search criteria |
classNameMatches
UiSelector classNameMatches (String regex)
使用正则表达式设置搜索条件以匹配窗口小部件的类属性。
Parameters |
regex |
String : a regular expression |
Returns |
UiSelector |
UiSelector with the specified search criteria |
clickable
UiSelector clickable (boolean val)
设置搜索条件以匹配可点击的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
description
UiSelector description (String desc)
设置搜索条件以匹配小部件的内容描述属性。 内容描述通常由Android Accessibility框架使用,以在选择小部件时为小部件提供音频提示。 小部件的内容描述必须与输入参数中的字符串完全匹配。 匹配区分大小写。
Parameters |
desc |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
descriptionContains
UiSelector descriptionContains (String desc)
设置搜索条件以匹配小部件的内容描述属性。 内容描述通常由Android Accessibility框架使用,以在选择小部件时为小部件提供音频提示。 该小部件的内容描述必须包含输入参数中的字符串。 匹配不区分大小写。
Parameters |
desc |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
descriptionMatches
UiSelector descriptionMatches (String regex)
设置搜索条件以匹配小部件的内容描述属性。 内容描述通常由Android Accessibility框架使用,以在选择小部件时为小部件提供音频提示。 小部件的内容描述必须与输入参数中的字符串完全匹配。
Parameters |
regex |
String : a regular expression |
Returns |
UiSelector |
UiSelector with the specified search criteria |
descriptionStartsWith
UiSelector descriptionStartsWith (String desc)
设置搜索条件以匹配小部件的内容描述属性。 内容描述通常由Android Accessibility框架使用,以在选择小部件时为小部件提供音频提示。 小部件的内容描述必须以输入参数中的字符串开头。 匹配不区分大小写。
Parameters |
desc |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
enabled
UiSelector enabled (boolean val)
设置搜索条件以匹配已启用的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
focusable
UiSelector focusable (boolean val)
设置搜索条件以匹配可聚焦的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
focused
UiSelector focused (boolean val)
设置搜索条件以匹配具有焦点的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
fromParent
UiSelector fromParent (UiSelector selector)
向此选择器添加一个子UiSelector条件,该选择器用于从父窗口小部件开始搜索。 使用此选择器可将搜索范围缩小为兄弟部件以及父级下的所有子部件。
Returns |
UiSelector |
UiSelector with this added search criterion |
index
UiSelector index (int index)
通过布局层次结构中的节点索引将搜索条件设置为与窗口小部件匹配。 索引值必须为0或更大。 使用索引可能是不可靠的,只能作为匹配的最后手段。 相反,请考虑使用instance(int)
方法。
Parameters |
index |
int : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
instance
UiSelector instance (int instance)
设置搜索条件以通过其实例号匹配小部件。 实例值必须为0或更大,其中第一个实例为0.例如,要模拟用户单击UI屏幕中启用的第三个图像,可以指定实例为2的搜索条件,即className(String)
匹配图像小部件类,并且enabled(boolean)
为true。 代码如下所示: new UiSelector().className("android.widget.ImageView") .enabled(true).instance(2);
Parameters |
instance |
int : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
longClickable
UiSelector longClickable (boolean val)
设置搜索条件以匹配可长按的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
packageName
UiSelector packageName (String name)
设置搜索条件以匹配包含该小部件的应用程序的包名称。
Parameters |
name |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
packageNameMatches
UiSelector packageNameMatches (String regex)
设置搜索条件以匹配包含该小部件的应用程序的包名称。
Parameters |
regex |
String : a regular expression |
Returns |
UiSelector |
UiSelector with the specified search criteria |
resourceId
UiSelector resourceId (String id)
设置搜索条件以匹配给定的资源ID。
Parameters |
id |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
resourceIdMatches
UiSelector resourceIdMatches (String regex)
使用正则表达式设置搜索条件以匹配窗口小部件的资源ID。
Parameters |
regex |
String : a regular expression |
Returns |
UiSelector |
UiSelector with the specified search criteria |
scrollable
UiSelector scrollable (boolean val)
设置搜索条件以匹配可滚动的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
selected
UiSelector selected (boolean val)
设置搜索条件以匹配当前选定的小部件。 通常,单独使用此搜索条件是没有用的。 您还应该包含其他条件,例如文本,内容描述或小部件的类名称。 如果没有指定其他搜索条件,并且有多个匹配小部件,则会选择树中的第一个小部件。
Parameters |
val |
boolean : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
text
UiSelector text (String text)
设置搜索条件以匹配小部件中显示的可见文本(例如,启动应用程序的文本标签)。 元素的文本必须与输入参数中的字符串完全匹配。 匹配区分大小写。
Parameters |
text |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
textContains
UiSelector textContains (String text)
设置搜索条件以匹配可见文本必须包含输入参数中的字符串的小部件中的可见文本。 匹配区分大小写。
Parameters |
text |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
textMatches
UiSelector textMatches (String regex)
使用正则表达式设置搜索条件以匹配显示在布局元素中的可见文本。 小部件中的文本必须与输入参数中的字符串完全匹配。
Parameters |
regex |
String : a regular expression |
Returns |
UiSelector |
UiSelector with the specified search criteria |
textStartsWith
UiSelector textStartsWith (String text)
设置搜索条件以匹配以text参数为前缀的小部件中的可见文本。 匹配是不区分大小写的。
Parameters |
text |
String : Value to match |
Returns |
UiSelector |
UiSelector with the specified search criteria |
toString
String toString ()
Protected methods