UiObject2

public class UiObject2
extends Object

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


UiObject2代表一个UI元素。 UiObject不同,它绑定到一个特定的视图实例,并且如果底层视图对象被销毁,它可能会变陈旧。 因此,如果UI发生显着变化,则可能需要调用findObject(BySelector)来获取新的实例UiObject2

Summary

Public methods

void clear()

如果此对象是可编辑字段,则清除文本内容。

void click()

点击此对象。

void click(long duration)

对该对象执行一次点击,该持续时间为 duration毫秒。

<R> R clickAndWait(EventCondition<R> condition, long timeout)

点击这个对象,并等待给定的条件成为真实。

void drag(Point dest)

将此对象拖到指定的位置。

void drag(Point dest, int speed)

将此对象拖到指定的位置。

boolean equals(Object object)

UiObject2 findObject(BySelector selector)

搜索此对象下的所有元素并返回第一个对象以匹配条件。

List<UiObject2> findObjects(BySelector selector)

搜索此对象下的所有元素并返回符合条件的所有对象。

boolean fling(Direction direction, int speed)

在这个对象上执行一个扔手势。

boolean fling(Direction direction)

在这个对象上执行一个扔手势。

String getApplicationPackage()

返回此对象所属的应用程序的包名称。

int getChildCount()

返回直接在此对象下的子元素的数量。

List<UiObject2> getChildren()

返回直接位于此对象下的子元素的集合。

String getClassName()

返回由此对象表示的基础 View的类名称。

String getContentDescription()

返回此对象的内容描述。

UiObject2 getParent()

返回此对象的父级。

String getResourceName()

返回此对象标识的完全限定资源名称。

String getText()

返回此对象的文本值。

Rect getVisibleBounds()

以屏幕坐标返回此对象的可见边界。

Point getVisibleCenter()

返回此对象可见边界中心的点。

boolean hasObject(BySelector selector)

返回此对象下的给定条件是否匹配。

int hashCode()

boolean isCheckable()

返回此对象是否可检查。

boolean isChecked()

返回是否检查此对象。

boolean isClickable()

返回此对象是否可点击。

boolean isEnabled()

返回是否启用此对象。

boolean isFocusable()

返回此对象是否可以聚焦。

boolean isFocused()

返回这个对象是否被聚焦。

boolean isLongClickable()

返回此对象是否可以长时间点击。

boolean isScrollable()

返回此对象是否可滚动。

boolean isSelected()

返回是否选择此对象。

void longClick()

执行此对象的长时间点击。

void pinchClose(float percent)

在此对象上执行捏合手势。

void pinchClose(float percent, int speed)

在此对象上执行捏合手势。

void pinchOpen(float percent)

在此对象上执行捏开手势。

void pinchOpen(float percent, int speed)

在此对象上执行捏开手势。

void recycle()

回收这个对象。

boolean scroll(Direction direction, float percent, int speed)

在此对象上执行滚动手势。

boolean scroll(Direction direction, float percent)

在此对象上执行滚动手势。

void setGestureMargin(int margin)

以像素为单位设置用于手势的边距。

void setGestureMargins(int left, int top, int right, int bottom)

以像素为单位设置用于手势的边距。

void setText(String text)

如果此对象是可编辑字段,则设置文本内容。

void swipe(Direction direction, float percent, int speed)

在此对象上执行滑动手势。

void swipe(Direction direction, float percent)

在此对象上执行滑动手势。

<R> R wait(UiObject2Condition<R> condition, long timeout)

等待给定的 condition

<R> R wait(SearchCondition<R> condition, long timeout)

等待给予 condition

Inherited methods

From class java.lang.Object

Public methods

clear

void clear ()

如果此对象是可编辑字段,则清除文本内容。

click

void click ()

点击此对象。

click

void click (long duration)

对该对象执行一次点击,该持续时间为 duration毫秒。

Parameters
duration long

clickAndWait

R clickAndWait (EventCondition<R> condition, 
                long timeout)

点击这个对象,并等待给定的条件成为真实。

Parameters
condition EventCondition
timeout long
Returns
R

drag

void drag (Point dest)

将此对象拖到指定的位置。

Parameters
dest Point: The end point that this object should be dragged to.

drag

void drag (Point dest, 
                int speed)

将此对象拖到指定的位置。

Parameters
dest Point: The end point that this object should be dragged to.
speed int: The speed at which to perform this gesture in pixels per second.

equals

boolean equals (Object object)

Parameters
object Object
Returns
boolean

findObject

UiObject2 findObject (BySelector selector)

搜索此对象下的所有元素并返回第一个对象以匹配条件。

Parameters
selector BySelector
Returns
UiObject2

findObjects

List<UiObject2> findObjects (BySelector selector)

搜索此对象下的所有元素并返回符合条件的所有对象。

Parameters
selector BySelector
Returns
List<UiObject2>

fling

boolean fling (Direction direction, 
                int speed)

在这个对象上执行一个扔手势。

Parameters
direction Direction: The direction in which to fling.
speed int: The speed at which to perform this gesture in pixels per second.
Returns
boolean Whether the object can still scroll in the given direction.

fling

boolean fling (Direction direction)

在这个对象上执行一个扔手势。

Parameters
direction Direction: The direction in which to fling.
Returns
boolean Whether the object can still scroll in the given direction.

getApplicationPackage

String getApplicationPackage ()

返回此对象所属的应用程序的包名称。

Returns
String

getChildCount

int getChildCount ()

返回直接在此对象下的子元素的数量。

Returns
int

getChildren

List<UiObject2> getChildren ()

返回直接位于此对象下的子元素的集合。

Returns
List<UiObject2>

getClassName

String getClassName ()

返回由此对象表示的基础 View的类名称。

Returns
String

getContentDescription

String getContentDescription ()

返回此对象的内容描述。

Returns
String

getParent

UiObject2 getParent ()

返回此对象的父级。

Returns
UiObject2

getResourceName

String getResourceName ()

返回此对象标识的完全限定资源名称。

Returns
String

getText

String getText ()

返回此对象的文本值。

Returns
String

getVisibleBounds

Rect getVisibleBounds ()

以屏幕坐标返回此对象的可见边界。

Returns
Rect

getVisibleCenter

Point getVisibleCenter ()

返回此对象可见边界中心的点。

Returns
Point

hasObject

boolean hasObject (BySelector selector)

返回此对象下的给定条件是否匹配。

Parameters
selector BySelector
Returns
boolean

hashCode

int hashCode ()

Returns
int

isCheckable

boolean isCheckable ()

返回此对象是否可检查。

Returns
boolean

isChecked

boolean isChecked ()

返回是否检查此对象。

Returns
boolean

isClickable

boolean isClickable ()

返回此对象是否可点击。

Returns
boolean

isEnabled

boolean isEnabled ()

返回是否启用此对象。

Returns
boolean

isFocusable

boolean isFocusable ()

返回此对象是否可以聚焦。

Returns
boolean

isFocused

boolean isFocused ()

返回这个对象是否被聚焦。

Returns
boolean

isLongClickable

boolean isLongClickable ()

返回此对象是否可以长时间点击。

Returns
boolean

isScrollable

boolean isScrollable ()

返回此对象是否可滚动。

Returns
boolean

isSelected

boolean isSelected ()

返回是否选择此对象。

Returns
boolean

longClick

void longClick ()

执行此对象的长时间点击。

pinchClose

void pinchClose (float percent)

在此对象上执行捏合手势。

Parameters
percent float: The size of the pinch as a percentage of this object's size.

pinchClose

void pinchClose (float percent, 
                int speed)

在此对象上执行捏合手势。

Parameters
percent float: The size of the pinch as a percentage of this object's size.
speed int: The speed at which to perform this gesture in pixels per second.

pinchOpen

void pinchOpen (float percent)

在此对象上执行捏开手势。

Parameters
percent float: The size of the pinch as a percentage of this object's size.

pinchOpen

void pinchOpen (float percent, 
                int speed)

在此对象上执行捏开手势。

Parameters
percent float: The size of the pinch as a percentage of this object's size.
speed int: The speed at which to perform this gesture in pixels per second.

recycle

void recycle ()

回收这个对象。

scroll

boolean scroll (Direction direction, 
                float percent, 
                int speed)

在此对象上执行滚动手势。

Parameters
direction Direction: The direction in which to scroll.
percent float: The distance to scroll as a percentage of this object's visible size.
speed int: The speed at which to perform this gesture in pixels per second.
Returns
boolean Whether the object can still scroll in the given direction.

scroll

boolean scroll (Direction direction, 
                float percent)

在此对象上执行滚动手势。

Parameters
direction Direction: The direction in which to scroll.
percent float: The distance to scroll as a percentage of this object's visible size.
Returns
boolean Whether the object can still scroll in the given direction.

setGestureMargin

void setGestureMargin (int margin)

以像素为单位设置用于手势的边距。

Parameters
margin int

setGestureMargins

void setGestureMargins (int left, 
                int top, 
                int right, 
                int bottom)

以像素为单位设置用于手势的边距。

Parameters
left int
top int
right int
bottom int

setText

void setText (String text)

如果此对象是可编辑字段,则设置文本内容。

Parameters
text String

swipe

void swipe (Direction direction, 
                float percent, 
                int speed)

在此对象上执行滑动手势。

Parameters
direction Direction: The direction in which to swipe.
percent float: The length of the swipe as a percentage of this object's size.
speed int: The speed at which to perform this gesture in pixels per second.

swipe

void swipe (Direction direction, 
                float percent)

在此对象上执行滑动手势。

Parameters
direction Direction: The direction in which to swipe.
percent float: The length of the swipe as a percentage of this object's size.

wait

R wait (UiObject2Condition<R> condition, 
                long timeout)

等待给定的 condition

Parameters
condition UiObject2Condition: The UiObject2Condition to evaluate.
timeout long: Maximum amount of time to wait in milliseconds.
Returns
R The final result returned by the condition.

wait

R wait (SearchCondition<R> condition, 
                long timeout)

等待给定的 condition

Parameters
condition SearchCondition: The SearchCondition to evaluate.
timeout long: Maximum amount of time to wait in milliseconds.
Returns
R The final result returned by the condition.