UiSelector

public class UiSelector
extends Object

java.lang.Object
   ↳ android.support.test.uiautomator.UiSelector


指定要测试的布局层次结构中的元素,通过诸如文本值,内容描述,类名称和状态信息等属性进行过滤。 您还可以通过在布局层次结构中的位置来定位元素。

Summary

Public constructors

UiSelector()

Public methods

UiSelector checkable(boolean val)

设置搜索条件以匹配可检查的小部件。

UiSelector checked(boolean val)

设置搜索条件以匹配当前选中的小部件(通常用于复选框)。

UiSelector childSelector(UiSelector selector)

向此选择器添加一个子UiSelector条件。

UiSelector className(String className)

设置搜索条件以匹配小部件的类属性(例如,“android.widget.Button”)。

<T> UiSelector className(Class<T> type)

设置搜索条件以匹配小部件的类属性(例如,“android.widget.Button”)。

UiSelector classNameMatches(String regex)

使用正则表达式设置搜索条件以匹配窗口小部件的类属性。

UiSelector clickable(boolean val)

设置搜索条件以匹配可点击的小部件。

UiSelector description(String desc)

设置搜索条件以匹配小部件的内容描述属性。

UiSelector descriptionContains(String desc)

设置搜索条件以匹配小部件的内容描述属性。

UiSelector descriptionMatches(String regex)

设置搜索条件以匹配小部件的内容描述属性。

UiSelector descriptionStartsWith(String desc)

设置搜索条件以匹配小部件的内容描述属性。

UiSelector enabled(boolean val)

设置搜索条件以匹配已启用的小部件。

UiSelector focusable(boolean val)

设置搜索条件以匹配可聚焦的小部件。

UiSelector focused(boolean val)

设置搜索条件以匹配具有焦点的小部件。

UiSelector fromParent(UiSelector selector)

向此选择器添加一个子UiSelector条件,该选择器用于从父窗口小部件开始搜索。

UiSelector index(int index)

通过布局层次结构中的节点索引将搜索条件设置为与窗口小部件匹配。

UiSelector instance(int instance)

设置搜索条件以通过其实例号匹配小部件。

UiSelector longClickable(boolean val)

设置搜索条件以匹配可长按的小部件。

UiSelector packageName(String name)

设置搜索条件以匹配包含该小部件的应用程序的包名称。

UiSelector packageNameMatches(String regex)

设置搜索条件以匹配包含该小部件的应用程序的包名称。

UiSelector resourceId(String id)

设置搜索条件以匹配给定的资源ID。

UiSelector resourceIdMatches(String regex)

使用正则表达式设置搜索条件以匹配窗口小部件的资源ID。

UiSelector scrollable(boolean val)

设置搜索条件以匹配可滚动的小部件。

UiSelector selected(boolean val)

设置搜索条件以匹配当前选定的小部件。

UiSelector text(String text)

设置搜索条件以匹配小部件中显示的可见文本(例如,启动应用程序的文本标签)。

UiSelector textContains(String text)

设置搜索条件以匹配可见文本必须包含输入参数中的字符串的小部件中的可见文本。

UiSelector textMatches(String regex)

使用正则表达式设置搜索条件以匹配显示在布局元素中的可见文本。

UiSelector textStartsWith(String text)

设置搜索条件以匹配以text参数为前缀的小部件中的可见文本。

String toString()

Protected methods

UiSelector cloneSelector()

Inherited methods

From class java.lang.Object

Public constructors

UiSelector

UiSelector ()

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 ()

Returns
String

Protected methods

cloneSelector

UiSelector cloneSelector ()

Returns
UiSelector