UiObject2

fun clear(): Unit

Clears this object's text content if it is an editable field.

fun click(): Unit

Clicks on this object's center.

fun click(duration: Long): Unit

Clicks on this object's center for duration milliseconds.

fun click(point: Point): Unit

Clicks on a point within this object's visible bounds.

fun click(point: Point, duration: Long): Unit

Clicks on a point within this object's visible bounds.

fun <U> clickAndWait(condition: EventCondition<U!>, timeout: Long): U!

Clicks on this object's center, and waits for a condition to be met.

fun <U> clickAndWait(point: Point, condition: EventCondition<U!>, timeout: Long): U!

Clicks on a point within this object's visible bounds, and waits for a condition to be met.

fun drag(dest: Point): Unit

Drags this object to the specified point.

fun drag(dest: Point, speed: Int): Unit

Drags this object to the specified point.

fun findObject(selector: BySelector): UiObject2!

Searches all elements under this object and returns the first one to match the selector, or null if no matching objects are found.

fun findObjects(selector: BySelector): (Mutable)List<UiObject2!>

Searches all elements under this object and returns those that match the selector.

fun fling(direction: Direction): Boolean

Performs a fling gesture on this object.

fun fling(direction: Direction, speed: Int): Boolean

Performs a fling gesture on this object.

fun getApplicationPackage(): String!

Returns the package name of the app that this object belongs to.

fun getChildCount(): Int

Returns the number of child elements directly under this object.

fun getChildren(): (Mutable)List<UiObject2!>

Returns a collection of the child elements directly under this object.

fun getClassName(): String!

Returns the class name of this object's underlying View.

fun getContentDescription(): String!

Returns this object's content description.

fun getDisplayId(): Int

Returns the ID of the display containing this object.

@RequiresApi(value = 24)
fun getDrawingOrder(): Int

Returns the drawing order (z-index) of this object relative to its siblings. Higher values are drawn last (i.e. above their siblings).

In some cases, the drawing order is essentially simultaneous, so it is possible for two siblings to return the same value. It is also possible that values will be skipped.

@RequiresApi(value = 26)
fun getHint(): String?

Returns the hint text of this object, or null if hint text is not preset.

Hint text is displayed when there's no user input text.

fun getParent(): UiObject2!

Returns this object's parent, or null if it has no parent.

fun getResourceName(): String!

Returns the fully qualified resource name for this object's ID.

fun getText(): String!

Returns this object's text content.

fun getVisibleBounds(): Rect

Returns this object's visible bounds.

fun getVisibleCenter(): Point

Returns a point in the center of this object's visible bounds.

fun hasObject(selector: BySelector): Boolean

Returns true if there is a nested element which matches the selector.

fun isCheckable(): Boolean

Returns true if this object is checkable.

fun isChecked(): Boolean

Returns true if this object is checked.

fun isClickable(): Boolean

Returns true if this object is clickable.

fun isEnabled(): Boolean

Returns true if this object is enabled.

fun isFocusable(): Boolean

Returns true if this object is focusable.

fun isFocused(): Boolean

Returns true if this object is focused.

fun isLongClickable(): Boolean

Returns true if this object is long clickable.

fun isScrollable(): Boolean

Returns true if this object is scrollable.

fun isSelected(): Boolean

Returns true if this object is selected.

fun longClick(): Unit

Performs a long click on this object's center.

fun pinchClose(percent: Float): Unit

Performs a pinch close gesture on this object.

fun pinchClose(percent: Float, speed: Int): Unit

Performs a pinch close gesture on this object.

fun pinchOpen(percent: Float): Unit

Performs a pinch open gesture on this object.

fun pinchOpen(percent: Float, speed: Int): Unit

Performs a pinch open gesture on this object.

fun recycle(): Unit

Recycle this object.

fun scroll(direction: Direction, percent: Float): Boolean

Performs a scroll gesture on this object.

fun scroll(direction: Direction, percent: Float, speed: Int): Boolean

Performs a scroll gesture on this object.

fun <U> scrollUntil(direction: Direction, condition: Condition<UiObject2!, U!>): U!

Perform scroll actions in certain direction until a condition is satisfied or scroll has finished, e.g. to scroll until an object contain certain text is found:

 mScrollableUiObject2.scrollUntil(Direction.DOWN, Until.findObject(By.textContains
("sometext"))); 

fun <U> scrollUntil(direction: Direction, condition: EventCondition<U!>): U!

Perform scroll actions in certain direction until a condition is satisfied or scroll has finished, e.g. to scroll until a new window has appeared:

 mScrollableUiObject2.scrollUntil(Direction.DOWN, Until.newWindow()); 

fun setGestureMargin(margin: Int): Unit

Sets the margins used for gestures in pixels.

fun setGestureMarginPercentage(percent: @FloatRange(from = 0.0, to = 0.5) Float): Unit

Sets the percentage of gestures' margins to avoid touching too close to the edges, e.g. when scrolling up, phone open quick settings instead if gesture is close to the top. The percentage is based on the object's visible size, e.g. to set 20% margins:

mUiObject2.setGestureMarginPercentage(0.2f);

percent Float between [0, 0.5] for four margins: left, top, right, and bottom.

fun setGestureMargins(left: Int, top: Int, right: Int, bottom: Int): Unit

Sets the margins used for gestures in pixels.

fun setGestureMarginsPercentage(
    left: @FloatRange(from = 0.0, to = 1.0) Float,
    top: @FloatRange(from = 0.0, to = 1.0) Float,
    right: @FloatRange(from = 0.0, to = 1.0) Float,
    bottom: @FloatRange(from = 0.0, to = 1.0) Float
): Unit

Sets the percentage of gestures' margins to avoid touching too close to the edges, e.g. when scrolling up, phone open quick settings instead if gesture is close to the top. The percentage is based on the object's visible size, e.g. to set 20% bottom margin only:

mUiObject2.setGestureMarginsPercentage(0f, 0f, 0f, 0.2f);

left Float between [0, 1] for left margin

top Float between [0, 1] for top margin

right Float between [0, 1] for right margin

bottom Float between [0, 1] for bottom margin

fun setText(text: String?): Unit

Sets this object's text content if it is an editable field.

fun swipe(direction: Direction, percent: Float): Unit

Performs a swipe gesture on this object.

fun swipe(direction: Direction, percent: Float, speed: Int): Unit

Performs a swipe gesture on this object.

fun <U> wait(condition: Condition<UiObject2!, U!>, timeout: Long): U!

Waits for a condition to be met.

fun <U> wait(condition: SearchCondition<U!>, timeout: Long): U!

Waits for a condition to be met.

fun <U> wait(condition: UiObject2Condition<U!>, timeout: Long): U!

Waits for a condition to be met.