public class UiObject2
extends Object
java.lang.Object | |
↳ | android.support.test.uiautomator.UiObject2 |
UiObject2
代表一个UI元素。 与UiObject
不同,它绑定到一个特定的视图实例,并且如果底层视图对象被销毁,它可能会变陈旧。 因此,如果UI发生显着变化,则可能需要调用findObject(BySelector)
来获取新的实例UiObject2
。
Public methods |
|
---|---|
void |
clear() 如果此对象是可编辑字段,则清除文本内容。 |
void |
click() 点击此对象。 |
void |
click(long 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() 返回由此对象表示的基础 |
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) 等待给定的 |
<R> R |
wait(SearchCondition<R> condition, long timeout) 等待给予 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
void clear ()
如果此对象是可编辑字段,则清除文本内容。
void click ()
点击此对象。
void click (long duration)
对该对象执行一次点击,该持续时间为 duration
毫秒。
Parameters | |
---|---|
duration |
long
|
R clickAndWait (EventCondition<R> condition, long timeout)
点击这个对象,并等待给定的条件成为真实。
Parameters | |
---|---|
condition |
EventCondition
|
timeout |
long
|
Returns | |
---|---|
R |
void drag (Point dest)
将此对象拖到指定的位置。
Parameters | |
---|---|
dest |
Point : The end point that this object should be dragged to. |
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. |
boolean equals (Object object)
Parameters | |
---|---|
object |
Object
|
Returns | |
---|---|
boolean |
UiObject2 findObject (BySelector selector)
搜索此对象下的所有元素并返回第一个对象以匹配条件。
Parameters | |
---|---|
selector |
BySelector
|
Returns | |
---|---|
UiObject2 |
List<UiObject2> findObjects (BySelector selector)
搜索此对象下的所有元素并返回符合条件的所有对象。
Parameters | |
---|---|
selector |
BySelector
|
Returns | |
---|---|
List<UiObject2> |
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. |
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. |
String getApplicationPackage ()
返回此对象所属的应用程序的包名称。
Returns | |
---|---|
String |
int getChildCount ()
返回直接在此对象下的子元素的数量。
Returns | |
---|---|
int |
String getContentDescription ()
返回此对象的内容描述。
Returns | |
---|---|
String |
String getResourceName ()
返回此对象标识的完全限定资源名称。
Returns | |
---|---|
String |
String getText ()
返回此对象的文本值。
Returns | |
---|---|
String |
Rect getVisibleBounds ()
以屏幕坐标返回此对象的可见边界。
Returns | |
---|---|
Rect |
Point getVisibleCenter ()
返回此对象可见边界中心的点。
Returns | |
---|---|
Point |
boolean hasObject (BySelector selector)
返回此对象下的给定条件是否匹配。
Parameters | |
---|---|
selector |
BySelector
|
Returns | |
---|---|
boolean |
int hashCode ()
Returns | |
---|---|
int |
boolean isCheckable ()
返回此对象是否可检查。
Returns | |
---|---|
boolean |
boolean isChecked ()
返回是否检查此对象。
Returns | |
---|---|
boolean |
boolean isClickable ()
返回此对象是否可点击。
Returns | |
---|---|
boolean |
boolean isEnabled ()
返回是否启用此对象。
Returns | |
---|---|
boolean |
boolean isFocusable ()
返回此对象是否可以聚焦。
Returns | |
---|---|
boolean |
boolean isFocused ()
返回这个对象是否被聚焦。
Returns | |
---|---|
boolean |
boolean isLongClickable ()
返回此对象是否可以长时间点击。
Returns | |
---|---|
boolean |
boolean isScrollable ()
返回此对象是否可滚动。
Returns | |
---|---|
boolean |
boolean isSelected ()
返回是否选择此对象。
Returns | |
---|---|
boolean |
void longClick ()
执行此对象的长时间点击。
void pinchClose (float percent)
在此对象上执行捏合手势。
Parameters | |
---|---|
percent |
float : The size of the pinch as a percentage of this object's size. |
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. |
void pinchOpen (float percent)
在此对象上执行捏开手势。
Parameters | |
---|---|
percent |
float : The size of the pinch as a percentage of this object's size. |
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. |
void recycle ()
回收这个对象。
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. |
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. |
void setGestureMargin (int margin)
以像素为单位设置用于手势的边距。
Parameters | |
---|---|
margin |
int
|
void setGestureMargins (int left, int top, int right, int bottom)
以像素为单位设置用于手势的边距。
Parameters | |
---|---|
left |
int
|
top |
int
|
right |
int
|
bottom |
int
|
void setText (String text)
如果此对象是可编辑字段,则设置文本内容。
Parameters | |
---|---|
text |
String
|
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. |
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. |
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. |
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. |