diff --git a/docs/html/tools/help/uiautomator/Configurator.jd b/docs/html/tools/help/uiautomator/Configurator.jd new file mode 100644 index 0000000000000..c898772216d65 --- /dev/null +++ b/docs/html/tools/help/uiautomator/Configurator.jd @@ -0,0 +1,960 @@ +page.title=Configurator +parent.title=uiautomator +parent.link=index.html + +@jd:body + + +
+
+Since API level 18 +
+
+ +

Allows you to set key parameters for running uiautomator tests. The new +settings take effect immediately and can be changed any time during a test run. +To modify parameters using Configurator, first +obtain an instance by calling getInstance(). +As a best practice, make sure you always save the original value of any +parameter that you are modifying. After running your tests with the modified +parameters, make sure to also restore the original parameter values, otherwise +this will impact other tests cases.

+ + +

Summary

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Public Methods
+ + + + + + long + + getActionAcknowledgmentTimeout() + +
Gets the current timeout for waiting for an acknowledgment of generic + uiautomator actions, such as clicks, text setting, and menu presses.
+ +
+ + + + static + + Configurator + + getInstance() + +
Retrieves a singleton instance of Configurator.
+ +
+ + + + + + long + + getKeyInjectionDelay() + +
Gets the current delay between key presses when injecting text input.
+ +
+ + + + + + long + + getScrollAcknowledgmentTimeout() + +
Gets the timeout for waiting for an acknowledgement of an + uiautomtor scroll swipe action.
+ +
+ + + + + + long + + getWaitForIdleTimeout() + +
Gets the current timeout used for waiting for the user interface to go + into an idle state.
+ +
+ + + + + + long + + getWaitForSelectorTimeout() + +
Gets the current timeout for waiting for a widget to become visible in + the user interface so that it can be matched by a selector.
+ +
+ + + + + + Configurator + + setActionAcknowledgmentTimeout(long timeout) + +
Sets the timeout for waiting for an acknowledgment of generic uiautomator + actions, such as clicks, text setting, and menu presses.
+ +
+ + + + + + Configurator + + setKeyInjectionDelay(long delay) + +
Sets a delay between key presses when injecting text input.
+ +
+ + + + + + Configurator + + setScrollAcknowledgmentTimeout(long timeout) + +
Sets the timeout for waiting for an acknowledgement of an + uiautomtor scroll swipe action.
+ +
+ + + + + + Configurator + + setWaitForIdleTimeout(long timeout) + +
Sets the timeout for waiting for the user interface to go into an idle + state before starting a uiautomator action.
+ +
+ + + + + + Configurator + + setWaitForSelectorTimeout(long timeout) + +
Sets the timeout for waiting for a widget to become visible in the user + interface so that it can be matched by a selector.
+ +
+ + + + + + + + + + + + + + + +
+ [Expand] +
Inherited Methods
+ +From class + + java.lang.Object + +
+ + +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Public Methods

+ + + + + +
+

+ + public + + + + + long + + getActionAcknowledgmentTimeout + () +

+
+ +

Gets the current timeout for waiting for an acknowledgment of generic + uiautomator actions, such as clicks, text setting, and menu presses. + + The acknowledgment is an AccessibilityEvent, + corresponding to an action, that lets the framework determine if the + action was successful. Generally, this timeout should not be modified. + See UiObject

+
+
Returns
+
  • current timeout in milliseconds
+
+
+
Since
+
  • Android API Level 18
+
+ +
+
+ + + + +
+

+ + public + static + + + + Configurator + + getInstance + () +

+
+ +

Retrieves a singleton instance of Configurator.

+
+
Returns
+
  • Configurator instance
+
+
+
Since
+
  • Android API Level 18
+
+ +
+
+ + + + +
+

+ + public + + + + + long + + getKeyInjectionDelay + () +

+
+ +

Gets the current delay between key presses when injecting text input. + See setText(String)

+
+
Returns
+
  • current delay in milliseconds
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + long + + getScrollAcknowledgmentTimeout + () +

+
+ +

Gets the timeout for waiting for an acknowledgement of an + uiautomtor scroll swipe action. + + The acknowledgment is an AccessibilityEvent, + corresponding to the scroll action, that lets the framework determine if + the scroll action was successful. Generally, this timeout should not be modified. + See UiScrollable

+
+
Returns
+
  • current timeout in milliseconds
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + long + + getWaitForIdleTimeout + () +

+
+ +

Gets the current timeout used for waiting for the user interface to go + into an idle state. + + By default, all core uiautomator objects except UiDevice will perform + this wait before starting to search for the widget specified by the + object's UiSelector. Once the idle state is detected or the + timeout elapses (whichever occurs first), the object will start to wait + for the selector to find a match. + See setWaitForSelectorTimeout(long)

+
+
Returns
+
  • Current timeout value in milliseconds
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + long + + getWaitForSelectorTimeout + () +

+
+ +

Gets the current timeout for waiting for a widget to become visible in + the user interface so that it can be matched by a selector. + + Because user interface content is dynamic, sometimes a widget may not + be visible immediately and won't be detected by a selector. This timeout + allows the uiautomator framework to wait for a match to be found, up until + the timeout elapses.

+
+
Returns
+
  • Current timeout value in milliseconds
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + Configurator + + setActionAcknowledgmentTimeout + (long timeout) +

+
+ +

Sets the timeout for waiting for an acknowledgment of generic uiautomator + actions, such as clicks, text setting, and menu presses. + + The acknowledgment is an AccessibilityEvent, + corresponding to an action, that lets the framework determine if the + action was successful. Generally, this timeout should not be modified. + See UiObject

+
+
Parameters
+ + + + +
timeout + Timeout value in milliseconds
+
+
+
Returns
+
  • self
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + Configurator + + setKeyInjectionDelay + (long delay) +

+
+ +

Sets a delay between key presses when injecting text input. + See setText(String)

+
+
Parameters
+ + + + +
delay + Delay value in milliseconds
+
+
+
Returns
+
  • self
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + Configurator + + setScrollAcknowledgmentTimeout + (long timeout) +

+
+ +

Sets the timeout for waiting for an acknowledgement of an + uiautomtor scroll swipe action. + + The acknowledgment is an AccessibilityEvent, + corresponding to the scroll action, that lets the framework determine if + the scroll action was successful. Generally, this timeout should not be modified. + See UiScrollable

+
+
Parameters
+ + + + +
timeout + Timeout value in milliseconds
+
+
+
Returns
+
  • self
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + Configurator + + setWaitForIdleTimeout + (long timeout) +

+
+ +

Sets the timeout for waiting for the user interface to go into an idle + state before starting a uiautomator action. + + By default, all core uiautomator objects except UiDevice will perform + this wait before starting to search for the widget specified by the + object's UiSelector. Once the idle state is detected or the + timeout elapses (whichever occurs first), the object will start to wait + for the selector to find a match. + See setWaitForSelectorTimeout(long)

+
+
Parameters
+ + + + +
timeout + Timeout value in milliseconds
+
+
+
Returns
+
  • self
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + Configurator + + setWaitForSelectorTimeout + (long timeout) +

+
+ +

Sets the timeout for waiting for a widget to become visible in the user + interface so that it can be matched by a selector. + + Because user interface content is dynamic, sometimes a widget may not + be visible immediately and won't be detected by a selector. This timeout + allows the uiautomator framework to wait for a match to be found, up until + the timeout elapses.

+
+
Parameters
+ + + + +
timeout + Timeout value in milliseconds.
+
+
+
Returns
+
  • self
+
+
+
Since
+
  • Android API Level 18
+
+
+ + + + + + + + + + diff --git a/docs/html/tools/help/uiautomator/IAutomationSupport.jd b/docs/html/tools/help/uiautomator/IAutomationSupport.jd index 4120f2b958869..1e9e3017fe927 100644 --- a/docs/html/tools/help/uiautomator/IAutomationSupport.jd +++ b/docs/html/tools/help/uiautomator/IAutomationSupport.jd @@ -11,58 +11,8 @@ parent.link=index.html

- - - - -
- - - - - - - - - - - - - - - - -
- -

Summary

- - - - - - - - - - - - - - - - - - - - - - - - - - @@ -97,31 +47,6 @@ parent.link=index.html - - - - - - - - - - - - - - - - - - - - - - - - - @@ -149,20 +74,9 @@ parent.link=index.html sendStatus(int resultCode, Bundle status) -
-
-
- - -
-
- +

Allows the running test cases to send out interim status

- -
- - diff --git a/docs/html/tools/help/uiautomator/UiAutomatorTestCase.jd b/docs/html/tools/help/uiautomator/UiAutomatorTestCase.jd index 48c63ba71a23e..0d8d1bc0354d9 100644 --- a/docs/html/tools/help/uiautomator/UiAutomatorTestCase.jd +++ b/docs/html/tools/help/uiautomator/UiAutomatorTestCase.jd @@ -14,27 +14,6 @@ parent.link=index.html

- - - - - - - - - - - - - - - - - - - - -
diff --git a/docs/html/tools/help/uiautomator/UiCollection.jd b/docs/html/tools/help/uiautomator/UiCollection.jd index ed92ca7246a4a..3fc32b73c68c5 100644 --- a/docs/html/tools/help/uiautomator/UiCollection.jd +++ b/docs/html/tools/help/uiautomator/UiCollection.jd @@ -9,8 +9,6 @@ parent.link=index.html or targeting a sub elements by a child's text or description.

-
-

Summary

@@ -1267,5 +1265,4 @@ From class
- diff --git a/docs/html/tools/help/uiautomator/UiDevice.jd b/docs/html/tools/help/uiautomator/UiDevice.jd index 1c8805b0b5ba2..574245efe1073 100644 --- a/docs/html/tools/help/uiautomator/UiDevice.jd +++ b/docs/html/tools/help/uiautomator/UiDevice.jd @@ -5,35 +5,9 @@ parent.link=index.html - -

Class Overview

-

UiDevice provides access to state information about the device. - You can also use this class to simulate user actions on the device, - such as pressing the d-pad or pressing the Home and Menu buttons.

- - - - - - - - - - - - - - - - - - - - - - -
- +

Provides access to state information about the device. You can +also use this class to simulate user actions on the device, such as pressing +the d-pad or pressing the Home and Menu buttons.

Summary

@@ -68,866 +42,957 @@ parent.link=index.html - -
- + - - - - + - - - - + - + + + + + + - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - + + + + + + - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - + + + + + + + + + + + + - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - + + + + + + - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - - - - - - - + - + + + + + + - - - + - - - - + - - - - + - - - - + - @@ -946,7 +1011,7 @@ parent.link=index.html
Inherited Methods
- + - - @@ -92,642 +130,766 @@ parent.link=index.html - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - + + + + + + + + + + + + + + + + + + - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - - + - - + + + + + + + + + + + + + + + + + + + + + + + + - + - - - + - - - + - - - + - - - + - - - + - - @@ -737,6 +899,34 @@ parent.link=index.html + +
Public Methods
- - - - - - void + +
+ + + + + + void - clearLastTraversedText() - + + clearLastTraversedText() +
Clears the text from the last UI traversal event.
- +
- - - - - - boolean + +
+ + + + + + boolean - click(int x, int y) - + + click(int x, int y) +
Perform a click at arbitrary coordinates specified by the user
- +
- - - - - - void + +
+ + + + + + boolean - dumpWindowHierarchy(String fileName) - + + drag(int startX, int startY, int endX, int endY, int steps) + +
Performs a swipe from one coordinate to another coordinate.
+ +
+ + + + + + void + + dumpWindowHierarchy(String fileName) +
Helper method used for debugging to dump the current window's layout hierarchy.
- +
- - - - - - void + +
+ + + + + + void - freezeRotation() - + + freezeRotation() +
Disables the sensors and freezes the device rotation at its current rotation state.
- +
- - - - - - String + +
+ + + + + + String - getCurrentActivityName() - -
- - This method is deprecated. - The results returned should be considered unreliable
- + 		+ getCurrentActivityName() + +
+ This method is deprecated. + The results returned should be considered unreliable
+
- - - - - - String + +
+ + + + + + String - getCurrentPackageName() - + + getCurrentPackageName() +
Retrieves the name of the last package to report accessibility events.
- +
- - - - - - int + +
+ + + + + + int - getDisplayHeight() - + + getDisplayHeight() +
Gets the height of the display, in pixels.
- +
- - - - - - int + +
+ + + + + + int - getDisplayRotation() - -
Returns the current rotation of the display, as defined in Surface@return
- + 		+ getDisplayRotation() + +
Returns the current rotation of the display, as defined in Surface
+
- - - - - - int + +
+ + + + + + Point - getDisplayWidth() - + + getDisplaySizeDp() + +
Returns the display size in dp (device-independent pixel) + + The returned display size is adjusted per screen rotation.
+ +
+ + + + + + int + + getDisplayWidth() +
Gets the width of the display, in pixels.
- +
- - - + +
+ + + static - - UiDevice + + UiDevice - getInstance() - + + getInstance() +
Retrieves a singleton instance of UiDevice
- +
- - - - - - String + +
+ + + + + + String - getLastTraversedText() - + + getLastTraversedText() +
Retrieves the text from the last UI traversal event received.
- +
- - - - - - String + +
+ + + + + + String - getProductName() - + + getProductName() +
Retrieves the product name of the device.
- +
- - - - - - boolean + +
+ + + + + + boolean - hasAnyWatcherTriggered() - + + hasAnyWatcherTriggered() +
Checks if any registered UiWatcher have triggered.
- +
- - - - - - boolean + +
+ + + + + + boolean - hasWatcherTriggered(String watcherName) - + + hasWatcherTriggered(String watcherName) +
Checks if a specific registered UiWatcher has triggered.
- +
- - - - - - boolean + +
+ + + + + + boolean - isNaturalOrientation() - + + isNaturalOrientation() +
Check if the device is in its natural orientation.
- +
- - - - - - boolean + +
+ + + + + + boolean - isScreenOn() - + + isScreenOn() +
Checks the power manager if the screen is ON.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressBack() - + + openNotification() + +
Opens the notification shade.
+ +
+ + + + + + boolean + + openQuickSettings() + +
Opens the Quick Settings shade.
+ +
+ + + + + + boolean + + pressBack() +
Simulates a short press on the BACK button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDPadCenter() - + + pressDPadCenter() +
Simulates a short press on the CENTER button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDPadDown() - + + pressDPadDown() +
Simulates a short press on the DOWN button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDPadLeft() - + + pressDPadLeft() +
Simulates a short press on the LEFT button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDPadRight() - + + pressDPadRight() +
Simulates a short press on the RIGHT button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDPadUp() - + + pressDPadUp() +
Simulates a short press on the UP button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressDelete() - + + pressDelete() +
Simulates a short press on the DELETE key.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressEnter() - + + pressEnter() +
Simulates a short press on the ENTER key.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressHome() - + + pressHome() +
Simulates a short press on the HOME button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressKeyCode(int keyCode) - + + pressKeyCode(int keyCode, int metaState) +
Simulates a short press using a key code.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressKeyCode(int keyCode, int metaState) - + + pressKeyCode(int keyCode) +
Simulates a short press using a key code.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressMenu() - + + pressMenu() +
Simulates a short press on the MENU button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressRecentApps() - + + pressRecentApps() +
Simulates a short press on the Recent Apps button.
- +
- - - - - - boolean + +
+ + + + + + boolean - pressSearch() - + + pressSearch() +
Simulates a short press on the SEARCH button.
- +
- - - - - - void + +
+ + + + + + void - registerWatcher(String name, UiWatcher watcher) - + + registerWatcher(String name, UiWatcher watcher) +
Registers a UiWatcher to run automatically when the testing framework is unable to find a match using a UiSelector.
- +
- - - - - - void + +
+ + + + + + void - removeWatcher(String name) - + + removeWatcher(String name) +
Removes a previously registered UiWatcher.
- +
- - - - - - void + +
+ + + + + + void - resetWatcherTriggers() - + + resetWatcherTriggers() +
Resets a UiWatcher that has been triggered.
- +
- - - - - - void + +
+ + + + + + void - runWatchers() - + + runWatchers() +
This method forces all registered watchers to run.
- +
- - - - - - void + +
+ + + + + + void - setOrientationLeft() - + + setCompressedLayoutHeirarchy(boolean compressed) + +
Enables or disables layout hierarchy compression.
+ +
+ + + + + + void + + setOrientationLeft() +
Simulates orienting the device to the left and also freezes rotation by disabling the sensors.
- +
- - - - - - void + +
+ + + + + + void - setOrientationNatural() - + + setOrientationNatural() +
Simulates orienting the device into its natural orientation and also freezes rotation by disabling the sensors.
- +
- - - - - - void + +
+ + + + + + void - setOrientationRight() - + + setOrientationRight() +
Simulates orienting the device to the right and also freezes rotation by disabling the sensors.
- +
- - - - - - void + +
+ + + + + + void - sleep() - + + sleep() +
This method simply presses the power button if the screen is ON else it does nothing if the screen is already OFF.
- +
- - - - - - boolean + +
+ + + + + + boolean - swipe(Point[] segments, int segmentSteps) - + + swipe(Point[] segments, int segmentSteps) +
Performs a swipe between points in the Point array.
- +
- - - - - - boolean + +
+ + + + + + boolean - swipe(int startX, int startY, int endX, int endY, int steps) - + + swipe(int startX, int startY, int endX, int endY, int steps) +
Performs a swipe from one coordinate to another using the number of steps to determine smoothness and speed.
- +
- - - - - - boolean + +
+ + + + + + boolean - takeScreenshot(File storePath, float scale, int quality) - -
Take a screenshot of current window and store it as PNG +
+ takeScreenshot(File storePath) - The screenshot is adjusted per screen rotation - -
- - - - - - boolean - - takeScreenshot(File storePath) -
Take a screenshot of current window and store it as PNG Default scale of 1.0f (original size) and 90% quality is used The screenshot is adjusted per screen rotation
- +
- - - - - - void + +
+ + + + + + boolean - unfreezeRotation() - + + takeScreenshot(File storePath, float scale, int quality) + +
Take a screenshot of current window and store it as PNG + + The screenshot is adjusted per screen rotation
+ +
+ + + + + + void + + unfreezeRotation() +
Re-enables the sensors and un-freezes the device rotation allowing its contents to rotate with the device physical rotation.
- +
- - - - - - void + +
+ + + + + + void - waitForIdle(long time) - + + waitForIdle(long timeout) +
Waits for the current application to idle.
- +
- - - - - - void + +
+ + + + + + void - waitForIdle() - + + waitForIdle() +
Waits for the current application to idle.
- +
- - - - - - boolean + +
+ + + + + + boolean - waitForWindowUpdate(String packageName, long timeout) - + + waitForWindowUpdate(String packageName, long timeout) +
Waits for a window content update event to occur.
- +
- - - - - - void + +
+ + + + + + void - wakeUp() - + + wakeUp() +
This method simulates pressing the power button if the screen is OFF else it does nothing if the screen is already ON.
- +
- + -
+

- public - - - - + public + + + + + boolean + + drag + (int startX, int startY, int endX, int endY, int steps) +

+
+ +

Performs a swipe from one coordinate to another coordinate. You can control + the smoothness and speed of the swipe by specifying the number of steps. + Each step execution is throttled to 5 milliseconds per step, so for a 100 + steps, the swipe will take around 0.5 seconds to complete.

+
+
Parameters
+ + + + + + + + + + + + + + + + +
startX + X-axis value for the starting coordinate
startY + Y-axis value for the starting coordinate
endX + X-axis value for the ending coordinate
endY + Y-axis value for the ending coordinate
steps + is the number of steps for the swipe action
+
+
+
Returns
+
  • true if swipe is performed, false if the operation fails + or the coordinates are invalid
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + void dumpWindowHierarchy (String fileName)

-
+
+ -
- -
- +

Helper method used for debugging to dump the current window's layout hierarchy. The file root location is /data/local/tmp

@@ -1269,40 +1419,38 @@ From class
- + -
+

- public - - - - + public + + + + void freezeRotation ()

-
+
+ -
- -
- +

Disables the sensors and freezes the device rotation at its current rotation state.

Throws
- +
- + @@ -1314,34 +1462,32 @@ From class - + -
+

- public - - - - + public + + + + String getCurrentActivityName ()

-
+
+ -
- -

-

- - This method is deprecated.
The results returned should be considered unreliable +

+ This method is deprecated.
+ The results returned should be considered unreliable

Retrieves the last activity to report accessibility events.

@@ -1353,31 +1499,29 @@ From class
- + -
+

- public - - - - + public + + + + String getCurrentPackageName ()

-
+
+ -
- -
- +

Retrieves the name of the last package to report accessibility events.

Returns
@@ -1388,31 +1532,29 @@ From class
- + -
+

- public - - - - + public + + + + int getDisplayHeight ()

-
+
+ -
- -
- +

Gets the height of the display, in pixels. The size is adjusted based on the current orientation of the display.

@@ -1424,65 +1566,84 @@ From class
- + -
+

- public - - - - + public + + + + int getDisplayRotation ()

-
-
- -
- - - -
- -

Returns the current rotation of the display, as defined in Surface@return

-
-
Since
-
  • Android API Level 17
+ +

Returns the current rotation of the display, as defined in Surface

+ +
+
+
Since
+
  • Android API Level 17
+
+ + + + +
+

+ + public + + + + + Point + + getDisplaySizeDp + () +

+
+ +

Returns the display size in dp (device-independent pixel) + + The returned display size is adjusted per screen rotation. Also this will return the actual + size of the screen, rather than adjusted per system decorations (like status bar).

+
+
Returns
+
  • a Point containing the display size in dp +
+
+
+
Since
+
  • Android API Level 18
+
- + -
+

- public - - - - + public + + + + int getDisplayWidth ()

-
-
- -
- - - -
- +

Gets the width of the display, in pixels. The width and height details are reported based on the current orientation of the display.

@@ -1494,31 +1655,23 @@ From class
- + -
+

- public - static - - - - UiDevice + public + static + + + + UiDevice getInstance ()

-
-
- -
- - - -
- +

Retrieves a singleton instance of UiDevice

Returns
@@ -1529,31 +1682,29 @@ From class
- + -
+

- public - - - - + public + + + + String getLastTraversedText ()

-
+
+ -
- -
- +

Retrieves the text from the last UI traversal event received. You can use this method to read the contents in a WebView container @@ -1573,31 +1724,23 @@ From class

- + -
+

- public - - - - + public + + + + String getProductName ()

-
-
- -
- - - -
- +

Retrieves the product name of the device. This method provides information on what type of device the test is running on. This value is @@ -1607,38 +1750,36 @@ From class

  • product name of the device
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + boolean hasAnyWatcherTriggered ()

-
+
+ -
- -
- +

Checks if any registered UiWatcher have triggered. See registerWatcher(String, UiWatcher) @@ -1648,31 +1789,29 @@ From class

- + -
+

- public - - - - + public + + + + boolean hasWatcherTriggered (String watcherName)

-
+
+ -
- -
- +

Checks if a specific registered UiWatcher has triggered. See registerWatcher(String, UiWatcher). If a UiWatcher runs and its checkForCondition() call returned true, then @@ -1687,31 +1826,23 @@ From class

- + -
+

- public - - - - + public + + + + boolean isNaturalOrientation ()

-
-
- -
- - - -
- +

Check if the device is in its natural orientation. This is determined by checking if the orientation is at 0 or 180 degrees.

@@ -1719,38 +1850,36 @@ From class
  • true if it is in natural orientation
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + boolean isScreenOn ()

-
+
+ -
- -
- +

Checks the power manager if the screen is ON.

Returns
@@ -1758,11 +1887,11 @@ From class
Throws
-
RemoteException
RemoteException
+
- + @@ -1774,31 +1903,89 @@ From class - + -
+

- public - - - - + public + + + + + boolean + + openNotification + () +

+
+ +

Opens the notification shade.

+
+
Returns
+
  • true if successful, else return false
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + boolean + + openQuickSettings + () +

+
+ +

Opens the Quick Settings shade.

+
+
Returns
+
  • true if successful, else return false
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + boolean pressBack ()

-
+
+ -
- -
- +

Simulates a short press on the BACK button.

Returns
@@ -1809,31 +1996,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDPadCenter ()

-
+
+ -
- -
- +

Simulates a short press on the CENTER button.

Returns
@@ -1844,31 +2029,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDPadDown ()

-
+
+ -
- -
- +

Simulates a short press on the DOWN button.

Returns
@@ -1879,31 +2062,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDPadLeft ()

-
+
+ -
- -
- +

Simulates a short press on the LEFT button.

Returns
@@ -1914,31 +2095,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDPadRight ()

-
+
+ -
- -
- +

Simulates a short press on the RIGHT button.

Returns
@@ -1949,31 +2128,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDPadUp ()

-
+
+ -
- -
- +

Simulates a short press on the UP button.

Returns
@@ -1984,31 +2161,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressDelete ()

-
+
+ -
- -
- +

Simulates a short press on the DELETE key.

Returns
@@ -2019,31 +2194,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressEnter ()

-
+
+ -
- -
- +

Simulates a short press on the ENTER key.

Returns
@@ -2054,31 +2227,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressHome ()

-
+
+ -
- -
- +

Simulates a short press on the HOME button.

Returns
@@ -2089,80 +2260,41 @@ From class
- + -
+

- public - - - - - boolean - - pressKeyCode - (int keyCode) -

-
-
- -
- - - -
-
- -

Simulates a short press using a key code. - - See KeyEvent

-
-
Returns
-
  • true if successful, else return false
-
- -
-
+ public + - -
-

- - public - - - - boolean pressKeyCode (int keyCode, int metaState)

-
+
+ -
- -
- +

Simulates a short press using a key code. - See KeyEvent.

+ See KeyEvent.

Parameters
RemoteException
RemoteException
- + - +
keyCodekeyCode the key code of the event.
metaStatemetaState an integer in which each bit set to 1 represents a pressed meta key
@@ -2176,31 +2308,64 @@ From class
- + -
+

- public - - - - + public + + + + + boolean + + pressKeyCode + (int keyCode) +

+
+
+ + + +
+
+ +

Simulates a short press using a key code. + + See KeyEvent

+
+
Returns
+
  • true if successful, else return false
+
+ +
+
+ + + + +
+

+ + public + + + + boolean pressMenu ()

-
+
+ -
- -
- +

Simulates a short press on the MENU button.

Returns
@@ -2211,31 +2376,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean pressRecentApps ()

-
+
+ -
- -
- +

Simulates a short press on the Recent Apps button.

Returns
@@ -2243,11 +2406,11 @@ From class
Throws
- +
- + @@ -2259,31 +2422,29 @@ From class - + -
+

- public - - - - + public + + + + boolean pressSearch ()

-
+
+ -
- -
- +

Simulates a short press on the SEARCH button.

Returns
@@ -2294,42 +2455,40 @@ From class
- + -
+

- public - - - - + public + + + + void registerWatcher (String name, UiWatcher watcher)

-
+
+ -
- -
- +

Registers a UiWatcher to run automatically when the testing framework is unable to find a match using a UiSelector. See runWatchers()

Parameters
RemoteException
RemoteException
- + - +
namename to register the UiWatcher
watcherwatcher UiWatcher
@@ -2339,31 +2498,29 @@ From class
- + -
+

- public - - - - + public + + + + void removeWatcher (String name)

-
+
+ -
- -
- +

Removes a previously registered UiWatcher. See registerWatcher(String, UiWatcher)

@@ -2371,50 +2528,39 @@ From class
Parameters
- +
namename used to register the UiWatcher
-
-
Throws
- - - - -
- UiAutomationException
-
- + -
+

- public - - - - + public + + + + void resetWatcherTriggers ()

-
+
+ -
- -
- +

Resets a UiWatcher that has been triggered. If a UiWatcher runs and its checkForCondition() call returned true, then the UiWatcher is considered triggered. @@ -2424,31 +2570,29 @@ From class

- + -
+

- public - - - - + public + + + + void runWatchers ()

-
+
+ -
- -
- +

This method forces all registered watchers to run. See registerWatcher(String, UiWatcher)

@@ -2456,31 +2600,63 @@ From class
- + -
+

- public - - - - + public + + + + + void + + setCompressedLayoutHeirarchy + (boolean compressed) +

+
+ +

Enables or disables layout hierarchy compression. + + If compression is enabled, the layout hierarchy derived from the Acessibility + framework will only contain nodes that are important for uiautomator + testing. Any unnecessary surrounding layout nodes that make viewing + and searching the hierarchy inefficient are removed.

+
+
Parameters
+ + + + +
compressed + true to enable compression; else, false to disable
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + void setOrientationLeft ()

-
-
- -
- - - -
- +

Simulates orienting the device to the left and also freezes rotation by disabling the sensors. @@ -2488,11 +2664,11 @@ From class see unfreezeRotation().

Throws
- +
- + @@ -2500,38 +2676,30 @@ From class
RemoteException
RemoteException
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + void setOrientationNatural ()

-
-
- -
- - - -
- +

Simulates orienting the device into its natural orientation and also freezes rotation by disabling the sensors. @@ -2539,11 +2707,11 @@ From class see unfreezeRotation().

Throws
- +
- + @@ -2551,38 +2719,30 @@ From class
RemoteException
RemoteException
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + void setOrientationRight ()

-
-
- -
- - - -
- +

Simulates orienting the device to the right and also freezes rotation by disabling the sensors. @@ -2590,11 +2750,11 @@ From class see unfreezeRotation().

Throws
- +
- + @@ -2602,47 +2762,45 @@ From class
RemoteException
RemoteException
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + void sleep ()

-
+
+ -
- -
- +

This method simply presses the power button if the screen is ON else it does nothing if the screen is already OFF.

Throws
- +
- + @@ -2654,42 +2812,40 @@ From class - + -
+

- public - - - - + public + + + + boolean swipe (Point[] segments, int segmentSteps)

-
+
+ -
- -
- +

Performs a swipe between points in the Point array. Each step execution is throttled to 5ms per step. So for a 100 steps, the swipe will take about 1/2 second to complete

Parameters
RemoteException
RemoteException
- + - +
segmentssegments is Point array containing at least one Point object
segmentStepssegmentSteps steps to inject between two Points
@@ -2703,31 +2859,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean swipe (int startX, int startY, int endX, int endY, int steps)

-
+
+ -
- -
- +

Performs a swipe from one coordinate to another using the number of steps to determine smoothness and speed. Each step execution is throttled to 5ms per step. So for a 100 steps, the swipe will take about 1/2 second to complete.

@@ -2735,7 +2889,7 @@ From class
Parameters
- +
stepssteps is the number of move steps sent to the system
@@ -2749,31 +2903,65 @@ From class
- + -
+

- public - - - - + public + + + + + boolean + + takeScreenshot + (File storePath) +

+
+ +

Take a screenshot of current window and store it as PNG + + Default scale of 1.0f (original size) and 90% quality is used + The screenshot is adjusted per screen rotation

+
+
Parameters
+ + + + +
storePath + where the PNG should be written to
+
+
+
Returns
+
  • true if screen shot is created successfully, false otherwise
+
+
+
Since
+
  • Android API Level 17
+
+
+
+ + + + +
+

+ + public + + + + boolean takeScreenshot (File storePath, float scale, int quality)

-
-
- -
- - - -
- +

Take a screenshot of current window and store it as PNG The screenshot is adjusted per screen rotation

@@ -2781,15 +2969,15 @@ From class
Parameters
- + - + - +
storePathstorePath where the PNG should be written to
scalescale scale the screenshot down if needed; 1.0f for original size
qualityquality quality of the PNG compression; range: 0-100
@@ -2799,94 +2987,42 @@ From class
  • true if screen shot is created successfully, false otherwise
-
Since
-
  • Android API Level 17
-
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - - boolean - - takeScreenshot - (File storePath) -

-
-
- -
- - - -
-
- -

Take a screenshot of current window and store it as PNG - - Default scale of 1.0f (original size) and 90% quality is used - The screenshot is adjusted per screen rotation

-
-
Parameters
- - - - - -
storePathwhere the PNG should be written to
-
-
-
Returns
-
  • true if screen shot is created successfully, false otherwise
-
-
-
Since
-
  • Android API Level 17
-
-
-
+ public + - -
-

- - public - - - - void unfreezeRotation ()

-
+
+ -
- -
- +

Re-enables the sensors and un-freezes the device rotation allowing its contents to rotate with the device physical rotation. During a test execution, it is best to keep the device frozen in a specific orientation until the test case execution has completed.

Throws
- +
@@ -2898,62 +3034,67 @@ From class - + -
+

- public - - - - + public + + + + void waitForIdle - (long time) + (long timeout)

-
+
+ -
- -
- +

Waits for the current application to idle.

+
+
Parameters
+
RemoteException
+ + + +
timeout + in milliseconds
+
- + -
+

- public - - - - + public + + + + void waitForIdle ()

-
+
+ -
- -
- +

Waits for the current application to idle. Default wait timeout is 10 seconds

@@ -2961,31 +3102,29 @@ From class
- + -
+

- public - - - - + public + + + + boolean waitForWindowUpdate (String packageName, long timeout)

-
+
+ -
- -
- +

Waits for a window content update event to occur. If a package name for the window is specified, but the current window @@ -2994,12 +3133,12 @@ From class

Parameters
- + - +
packageNamepackageName the specified window package name (can be null). If null, a window update from any front-end window will end the wait
timeouttimeout the timeout for the wait
@@ -3014,31 +3153,29 @@ From class
- + -
+

- public - - - - + public + + + + void wakeUp ()

-
+
+ -
- -
- +

This method simulates pressing the power button if the screen is OFF else it does nothing if the screen is already ON. @@ -3046,11 +3183,11 @@ From class to allow the device time to wake up and accept input.

Throws
- +
- + @@ -3059,7 +3196,6 @@ From class - @@ -3069,5 +3205,4 @@ From class - diff --git a/docs/html/tools/help/uiautomator/UiObject.jd b/docs/html/tools/help/uiautomator/UiObject.jd index a22df50bcbe83..45007e0a17992 100644 --- a/docs/html/tools/help/uiautomator/UiObject.jd +++ b/docs/html/tools/help/uiautomator/UiObject.jd @@ -5,31 +5,12 @@ parent.link=index.html -

A UiObject is a representation of a user interface (UI) element. It is not in any way directly bound to a - UI element as an object reference. A UiObject holds information to help it - locate a matching UI element at runtime based on the UiSelector properties specified in - its constructor. Since a UiObject is a representative for a UI element, it can - be reused for different views with matching UI elements. -

- - - - - - - - - - - - - - - - - -
- +

A UiObject is a representation of a view. It is +not in any way directly bound to a view as an object reference. A UiObject +contains information to help it locate a matching view at runtime based on the +UiSelector properties specified in +its constructor. Once you create an instance of a UiObject, it can be reused for +different views that match the selector criteria.

Summary

@@ -45,6 +26,63 @@ parent.link=index.html + +
RemoteException
RemoteException
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Constants
intFINGER_TOUCH_HALF_WIDTH
intSWIPE_MARGIN_LIMIT
longWAIT_FOR_EVENT_TMEOUT + This constant is deprecated. + use setScrollAcknowledgmentTimeout(long) +
longWAIT_FOR_SELECTOR_POLL
longWAIT_FOR_SELECTOR_TIMEOUT + This constant is deprecated. + use setWaitForSelectorTimeout(long) +
longWAIT_FOR_WINDOW_TMEOUT
+ + @@ -60,22 +98,22 @@ parent.link=index.html - +
- - - - - - + + + + + + + - UiObject(UiSelector selector) - -
Constructs a UiObject to represent a specific UI element matched by the specified - UiSelector selector properties.
- + 		+ UiObject(UiSelector selector) + +
Constructs a UiObject to represent a view that matches the specified + selector criteria.
+
- - - - - - void + + + + + + + void - clearTextField() - + + clearTextField() +
Clears the existing text contents in an editable field.
- +
- - - - - - boolean + + + + + + + boolean - click() - + + click() +
Performs a click at the center of the visible bounds of the UI element represented by this UiObject.
- +
- - - - - - boolean + + + + + + + boolean - clickAndWaitForNewWindow(long timeout) - + + clickAndWaitForNewWindow(long timeout) +
Performs a click at the center of the visible bounds of the UI element represented by this UiObject and waits for window transitions.
- +
- - - - - - boolean + + + + + + + boolean - clickAndWaitForNewWindow() - -
See clickAndWaitForNewWindow(long) - This method is intended to reliably wait for window transitions that would typically take - longer than the usual default timeouts.
- + 		+ clickAndWaitForNewWindow() + +
Waits for window transitions that would typically take longer than the + usual default timeouts.
+
- - - - - - boolean + + + + + + + boolean - clickBottomRight() - + + clickBottomRight() +
Clicks the bottom and right corner of the UI element
- +
- - - - - - boolean + + + + + + + boolean - clickTopLeft() - + + clickTopLeft() +
Clicks the top and left corner of the UI element
- +
- - - - - - boolean + + + + + + + boolean - exists() - -
Check if UI element exists.
- + 		+ dragTo(UiObject destObj, int steps) + +
Drags this object to a destination UiObject.
+
- - - - - - Rect + + + + + + + boolean - getBounds() - -
Returns the UI element's bounds property.
- + 		+ dragTo(int destX, int destY, int steps) + +
Drags this object to arbitrary coordinates.
+
- - - - - - UiObject + + + + + + + boolean - getChild(UiSelector selector) - -
Creates a new UiObject representing a child UI element of the element currently represented - by this UiObject.
- + 		+ exists() + +
Check if view exists.
+
- - - - - - int + + + + + + + Rect - getChildCount() - -
Counts the child UI elements immediately under the UI element currently represented by - this UiObject.
- + 		+ getBounds() + +
Returns the view's bounds property.
+
- - - - - - String + + + + + + + UiObject - getContentDescription() - + + getChild(UiSelector selector) + +
Creates a new UiObject for a child view that is under the present UiObject.
+ +
+ + + + + + int + + getChildCount() + +
Counts the child views immediately under the present UiObject.
+ +
+ + + + + + String + + getClassName() + +
Retrieves the className property of the UI element.
+ +
+ + + + + + String + + getContentDescription() +
Reads the content_desc property of the UI element
- +
- - - - - - UiObject + + + + + + + UiObject - getFromParent(UiSelector selector) - -
Creates a new UiObject representing a child UI element from the parent element currently - represented by this object.
- + 		+ getFromParent(UiSelector selector) + +
Creates a new UiObject for a sibling view or a child of the sibling view, + relative to the present UiObject.
+
- - - - - - String + + + + + + + String - getPackageName() - -
Reads the UI element's package property
- + 		+ getPackageName() + +
Reads the view's package property
+
- - + + + final - - - UiSelector + + + UiSelector - getSelector() - + + getSelector() +
Debugging helper.
- +
- - - - - - String + + + + + + + String - getText() - + + getText() +
Reads the text property of the UI element
- +
- - - - - - Rect + + + + + + + Rect - getVisibleBounds() - -
Returns the visible bounds of the UI element.
- + 		+ getVisibleBounds() + +
Returns the visible bounds of the view.
+
- - - - - - boolean + + + + + + + boolean - isCheckable() - -
Check if the UI element's checkable property is currently true
- + 		+ isCheckable() + +
Checks if the UI element's checkable property is currently true.
+
- - - - - - boolean + + + + + + + boolean - isChecked() - + + isChecked() +
Check if the UI element's checked property is currently true
- +
- - - - - - boolean + + + + + + + boolean - isClickable() - -
Check if the UI element's clickable property is currently true
- + 		+ isClickable() + +
Checks if the UI element's clickable property is currently true.
+
- - - - - - boolean + + + + + + + boolean - isEnabled() - -
Check if the UI element's enabled property is currently true
- + 		+ isEnabled() + +
Checks if the UI element's enabled property is currently true.
+
- - - - - - boolean + + + + + + + boolean - isFocusable() - -
Check if the UI element's focusable property is currently true
- + 		+ isFocusable() + +
Check if the UI element's focusable property is currently true.
+
- - - - - - boolean + + + + + + + boolean - isFocused() - + + isFocused() +
Check if the UI element's focused property is currently true
- +
- - - - - - boolean + + + + + + + boolean - isLongClickable() - -
Check if the UI element's long-clickable property is currently true
- + 		+ isLongClickable() + +
Check if the view's long-clickable property is currently true
+
- - - - - - boolean + + + + + + + boolean - isScrollable() - -
Check if the UI element's scrollable property is currently true
- + 		+ isScrollable() + +
Check if the view's scrollable property is currently true
+
- - - - - - boolean + + + + + + + boolean - isSelected() - -
Check if the UI element's selected property is currently true
- + 		+ isSelected() + +
Checks if the UI element's selected property is currently true.
+
- - - - - - boolean + + + + + + + boolean - longClick() - + + longClick() +
Long clicks the center of the visible bounds of the UI element
- +
- - - - - - boolean + + + + + + + boolean - longClickBottomRight() - + + longClickBottomRight() +
Long clicks bottom and right corner of the UI element
- +
- - - - - - boolean + + + + + + + boolean - longClickTopLeft() - + + longClickTopLeft() +
Long clicks on the top and left corner of the UI element
- +
- - - - - - boolean + + + + + + + boolean - setText(String text) - + + performMultiPointerGesture(PointerCoords... touches) + +
Performs a multi-touch gesture.
+ +
+ + + + + + boolean + + performTwoPointerGesture(Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps) + +
Generates a two-pointer gesture with arbitrary starting and ending points.
+ +
+ + + + + + boolean + + pinchIn(int percent, int steps) + +
Performs a two-pointer gesture, where each pointer moves diagonally + toward the other, from the edges to the center of this UiObject .
+ +
+ + + + + + boolean + + pinchOut(int percent, int steps) + +
Performs a two-pointer gesture, where each pointer moves diagonally + opposite across the other, from the center out towards the edges of the + this UiObject.
+ +
+ + + + + + boolean + + setText(String text) +
Sets the text in an editable field, after clearing the field's content.
- +
- - - - - - boolean + + + + + + + boolean - swipeDown(int steps) - -
Perform the action on the UI element that is represented by this object, Also see - #scrollToBeginning(int), #scrollToEnd(int), #scrollBackward(), - #scrollForward().
- + 		+ swipeDown(int steps) + +
Performs the swipe down action on the UiObject.
+
- - - - - - boolean + + + + + + + boolean - swipeLeft(int steps) - -
Perform the action on the UI element that is represented by this object.
- + 		+ swipeLeft(int steps) + +
Performs the swipe left action on the UiObject.
+
- - - - - - boolean + + + + + + + boolean - swipeRight(int steps) - -
Perform the action on the UI element that is represented by this object.
- + 		+ swipeRight(int steps) + +
Performs the swipe right action on the UiObject.
+
- - - - - - boolean + + + + + + + boolean - swipeUp(int steps) - -
Perform the action on the UI element that is represented by this UiObject.
- + 		+ swipeUp(int steps) + +
Performs the swipe up action on the UiObject.
+
- - - - - - boolean + + + + + + + boolean - waitForExists(long timeout) - -
Waits a specified length of time for a UI element to become visible.
- + 		+ waitForExists(long timeout) + +
Waits a specified length of time for a view to become visible.
+
- - - - - - boolean + + + + + + + boolean - waitUntilGone(long timeout) - -
Waits a specified length of time for a UI element to become undetectable.
- + 		+ waitUntilGone(long timeout) + +
Waits a specified length of time for a view to become undetectable.
+
+ + + + + + + + + + +
Protected Methods
+ + + + + + AccessibilityNodeInfo + + findAccessibilityNodeInfo(long timeout) + +
Finds a matching UI element in the accessibility hierarchy, by + using the selector for this UiObject.
+ +
+ + @@ -746,7 +936,7 @@ parent.link=index.html
Inherited Methods
- +
Throws
- +
+ @@ -1154,41 +1616,40 @@ From class - + -
+

- public - - - - + public + + + + boolean clickAndWaitForNewWindow ()

-
+
+ -
- -
- -

See clickAndWaitForNewWindow(long) - This method is intended to reliably wait for window transitions that would typically take - longer than the usual default timeouts.

+ +

Waits for window transitions that would typically take longer than the + usual default timeouts. + See clickAndWaitForNewWindow(long)

Returns
  • true if the event was triggered, else false
Throws
-
UiObjectNotFoundException
+
+ @@ -1200,31 +1661,29 @@ From class - + -
+

- public - - - - + public + + + + boolean clickBottomRight ()

-
+
+ -
- -
- +

Clicks the bottom and right corner of the UI element

Returns
@@ -1232,11 +1691,8 @@ From class
Throws
-
UiObjectNotFoundException
- - - +
Exception -
+ @@ -1248,31 +1704,29 @@ From class - + -
+

- public - - - - + public + + + + boolean clickTopLeft ()

-
+
+ -
- -
- +

Clicks the top and left corner of the UI element

Returns
@@ -1280,11 +1734,8 @@ From class
Throws
-
UiObjectNotFoundException
- - - +
Exception -
+ @@ -1296,134 +1747,243 @@ From class - + -
+

- public - - - - + public + + + + + boolean + + dragTo + (UiObject destObj, int steps) +

+
+ +

Drags this object to a destination UiObject. + The number of steps specified in your input parameter can influence the + drag speed, and varying speeds may impact the results. Consider + evaluating different speeds when using this method in your tests.

+
+
Parameters
+
UiObjectNotFoundException
+ + + + + + +
destObj + the destination UiObject.
steps + usually 40 steps. You can increase or decrease the steps to change the speed.
+
+
+
Returns
+ +
+
+
Throws
+ + + + + +
UiObjectNotFoundException +
+
+
+
Since
+ +
+
+ + + + + +
+

+ + public + + + + + boolean + + dragTo + (int destX, int destY, int steps) +

+
+ +

Drags this object to arbitrary coordinates. + The number of steps specified in your input parameter can influence the + drag speed, and varying speeds may impact the results. Consider + evaluating different speeds when using this method in your tests.

+
+
Parameters
+ + + + + + + + + + +
destX + the X-axis coordinate.
destY + the Y-axis coordinate.
steps + usually 40 steps. You can increase or decrease the steps to change the speed.
+
+
+
Returns
+
  • true if successful
+
+
+
Throws
+ + + + + +
UiObjectNotFoundException +
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + boolean exists ()

-
+
+ -
- -
- -

Check if UI element exists. + +

Check if view exists. This methods performs a waitForExists(long) with zero timeout. This - basically returns immediately whether the UI element represented by this UiObject - exists or not. If you need to wait longer for this UI element, then see + basically returns immediately whether the view represented by this UiObject + exists or not. If you need to wait longer for this view, then see waitForExists(long).

Returns
-
  • true if the UI element represented by this UiObject does exist -
+
  • true if the view represented by this UiObject does exist
- + -
+

- public - - - - + public + + + + Rect getBounds ()

-
+
+ -
- -
- -

Returns the UI element's bounds property. See getVisibleBounds()

+ +

Returns the view's bounds property. See getVisibleBounds()

Returns
  • Rect
Throws
- +
+
UiObjectNotFoundException
+
- + -
+

- public - - - - - UiObject + public + + + + + UiObject getChild (UiSelector selector)

-
+
+ -
- -
- -

Creates a new UiObject representing a child UI element of the element currently represented - by this UiObject.

+ +

Creates a new UiObject for a child view that is under the present UiObject.

Parameters
- - +
selectorfor UI element to matchselector + for child view to match
Returns
-
  • a new UiObject representing the matched UI element -
+
  • a new UiObject representing the child view
Throws
- +
@@ -1435,40 +1995,38 @@ From class - + -
+

- public - - - - + public + + + + int getChildCount ()

-
+
+ -
- -
- -

Counts the child UI elements immediately under the UI element currently represented by - this UiObject.

+ +

Counts the child views immediately under the present UiObject.

Returns
-
  • the count of child UI elements.
+
  • the count of child views.
Throws
-
UiObjectNotFoundException
+
+ @@ -1480,31 +2038,68 @@ From class - + -
+

- public - - - - + public + + + + + String + + getClassName + () +

+
+ +

Retrieves the className property of the UI element.

+
+
Returns
+
  • class name of the current node represented by this UiObject
+
+
+
Throws
+
UiObjectNotFoundException
+ + + +
UiObjectNotFoundException + if no match was found
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + String getContentDescription ()

-
+
+ -
- -
- +

Reads the content_desc property of the UI element

Returns
@@ -1512,7 +2107,8 @@ From class
Throws
- +
+ @@ -1524,51 +2120,48 @@ From class - + -
+

- public - - - - - UiObject + public + + + + + UiObject getFromParent (UiSelector selector)

-
+
+ -
- -
- -

Creates a new UiObject representing a child UI element from the parent element currently - represented by this object. Essentially this is starting the search from the parent - element and can also be used to find sibling UI elements to the one currently represented - by this UiObject.

+ +

Creates a new UiObject for a sibling view or a child of the sibling view, + relative to the present UiObject.

Parameters
UiObjectNotFoundException
- - +
selectorfor the UI element to matchselector + for a sibling view or children of the sibling view
Returns
-
  • a new UiObject representing the matched UI element
+
  • a new UiObject representing the matched view
Throws
- +
+ @@ -1580,39 +2173,38 @@ From class - + -
+

- public - - - - + public + + + + String getPackageName ()

-
+
+ -
- -
- -

Reads the UI element's package property

+ +

Reads the view's package property

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -1624,68 +2216,63 @@ From class - + -
+

- public - - final - - + public + + final + + UiSelector getSelector ()

-
+
+ -
- -
- +

Debugging helper. A test can dump the properties of a selector as a string to its logs if needed. getSelector().toString();

Returns
- +
- + -
+

- public - - - - + public + + + + String getText ()

-
+
+ -
- -
- +

Reads the text property of the UI element

Returns
@@ -1693,11 +2280,10 @@ From class
Throws
-
UiObjectNotFoundException
+
+
UiObjectNotFoundException - if no match could be found -if no match could be found
@@ -1706,34 +2292,26 @@ From class
- + -
+

- public - - - - + public + + + + Rect getVisibleBounds ()

-
-
- -
- - - -
- -

Returns the visible bounds of the UI element. - If a portion of the UI element is visible, only the bounds of the visible portion are +

Returns the visible bounds of the view. + + If a portion of the view is visible, only the bounds of the visible portion are reported.

Returns
@@ -1741,58 +2319,59 @@ From class
Throws
- - - - +
- UiObjectNotFoundException
+
UiObjectNotFoundException
-
-
Since
-
  • Android API Level 17
-
+
+
See Also
+ +
+
+
Since
+
  • Android API Level 17
+
- + -
+

- public - - - - + public + + + + boolean isCheckable ()

-
+
+ -
- -
- -

Check if the UI element's checkable property is currently true

+ +

Checks if the UI element's checkable property is currently true.

Returns
  • true if it is else false
Throws
- +
+ @@ -1804,40 +2383,37 @@ From class - + -
+

- public - - - - + public + + + + boolean isChecked ()

-
+
+ -
- -
- +

Check if the UI element's checked property is currently true

Returns
-
  • true if it is else false -
+
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
@@ -1849,39 +2425,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isClickable ()

-
+
+ -
- -
- -

Check if the UI element's clickable property is currently true

+ +

Checks if the UI element's clickable property is currently true.

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -1893,39 +2468,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isEnabled ()

-
+
+ -
- -
- -

Check if the UI element's enabled property is currently true

+ +

Checks if the UI element's enabled property is currently true.

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -1937,39 +2511,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isFocusable ()

-
+
+ -
- -
- -

Check if the UI element's focusable property is currently true

+ +

Check if the UI element's focusable property is currently true.

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -1981,31 +2554,29 @@ From class - + -
+

- public - - - - + public + + + + boolean isFocused ()

-
+
+ -
- -
- +

Check if the UI element's focused property is currently true

Returns
@@ -2013,7 +2584,8 @@ From class
Throws
-
UiObjectNotFoundException
+
+ @@ -2025,39 +2597,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isLongClickable ()

-
+
+ -
- -
- -

Check if the UI element's long-clickable property is currently true

+ +

Check if the view's long-clickable property is currently true

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -2069,39 +2640,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isScrollable ()

-
+
+ -
- -
- -

Check if the UI element's scrollable property is currently true

+ +

Check if the view's scrollable property is currently true

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -2113,39 +2683,38 @@ From class - + -
+

- public - - - - + public + + + + boolean isSelected ()

-
+
+ -
- -
- -

Check if the UI element's selected property is currently true

+ +

Checks if the UI element's selected property is currently true.

Returns
  • true if it is else false
Throws
-
UiObjectNotFoundException
+
+ @@ -2157,31 +2726,29 @@ From class - + -
+

- public - - - - + public + + + + boolean longClick ()

-
+
+ -
- -
- +

Long clicks the center of the visible bounds of the UI element

Returns
@@ -2189,7 +2756,8 @@ From class
Throws
-
UiObjectNotFoundException
+
+ @@ -2201,31 +2769,29 @@ From class - + -
+

- public - - - - + public + + + + boolean longClickBottomRight ()

-
+
+ -
- -
- +

Long clicks bottom and right corner of the UI element

Returns
@@ -2233,7 +2799,8 @@ From class
Throws
-
UiObjectNotFoundException
+
+ @@ -2245,31 +2812,29 @@ From class - + -
+

- public - - - - + public + + + + boolean longClickTopLeft ()

-
+
+ -
- -
- +

Long clicks on the top and left corner of the UI element

Returns
@@ -2277,7 +2842,8 @@ From class
Throws
-
UiObjectNotFoundException
+
+ @@ -2289,31 +2855,254 @@ From class - + -
+

- public - - - - + public + + + + + boolean + + performMultiPointerGesture + (PointerCoords... touches) +

+
+ +

Performs a multi-touch gesture. You must specify touch coordinates for + at least 2 pointers. Each pointer must have all of its touch steps + defined in an array of MotionEvent.PointerCoords. You can use this method to + specify complex gestures, like circles and irregular shapes, where each + pointer may take a different path. + + To create a single point on a pointer's touch path: + + PointerCoords p = new PointerCoords(); + p.x = stepX; + p.y = stepY; + p.pressure = 1; + p.size = 1; +

+
+
Parameters
+
UiObjectNotFoundException
+ + + +
touches + represents the pointers' paths. Each MotionEvent.PointerCoords + array represents a different pointer. Each MotionEvent.PointerCoords in an + array element represents a touch point on a pointer's path.
+
+
+
Returns
+
  • true if all touch events for this gesture are injected successfully, + false otherwise
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + boolean + + performTwoPointerGesture + (Point startPoint1, Point startPoint2, Point endPoint1, Point endPoint2, int steps) +

+
+ +

Generates a two-pointer gesture with arbitrary starting and ending points.

+
+
Parameters
+ + + + + + + + + + + + + + + + +
startPoint1 + start point of pointer 1
startPoint2 + start point of pointer 2
endPoint1 + end point of pointer 1
endPoint2 + end point of pointer 2
steps + the number of steps for the gesture. Steps are injected + about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.
+
+
+
Returns
+
  • true if all touch events for this gesture are injected successfully, + false otherwise
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + boolean + + pinchIn + (int percent, int steps) +

+
+ +

Performs a two-pointer gesture, where each pointer moves diagonally + toward the other, from the edges to the center of this UiObject .

+
+
Parameters
+ + + + + + + +
percent + percentage of the object's diagonal length for the pinch gesture
steps + the number of steps for the gesture. Steps are injected + about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.
+
+
+
Returns
+
  • true if all touch events for this gesture are injected successfully, + false otherwise
+
+
+
Throws
+ + + + + +
UiObjectNotFoundException +
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + + boolean + + pinchOut + (int percent, int steps) +

+
+ +

Performs a two-pointer gesture, where each pointer moves diagonally + opposite across the other, from the center out towards the edges of the + this UiObject.

+
+
Parameters
+ + + + + + + +
percent + percentage of the object's diagonal length for the pinch gesture
steps + the number of steps for the gesture. Steps are injected + about 5 milliseconds apart, so 100 steps may take around 0.5 seconds to complete.
+
+
+
Returns
+
  • true if all touch events for this gesture are injected successfully, + false otherwise
+
+
+
Throws
+ + + + + +
UiObjectNotFoundException +
+
+
+
Since
+
  • Android API Level 18
+
+
+
+ + + + +
+

+ + public + + + + boolean setText (String text)

-
+
+ -
- -
- +

Sets the text in an editable field, after clearing the field's content. The UiSelector selector of this object must reference a UI element that is editable. @@ -2328,7 +3117,7 @@ From class

Parameters
- +
texttext string to set
@@ -2339,7 +3128,8 @@ From class
Throws
- +
+ @@ -2351,41 +3141,44 @@ From class - + -
+

- public - - - - + public + + + + boolean swipeDown (int steps)

-
+
+ -
- -
- -

Perform the action on the UI element that is represented by this object, Also see - #scrollToBeginning(int), #scrollToEnd(int), #scrollBackward(), - #scrollForward(). This method will perform the swipe gesture over any - surface. The targeted UI element does not need to have the attribute - scrollable set to true for this operation to be performed.

+ +

Performs the swipe down action on the UiObject. + The swipe gesture can be performed over any surface. The targeted + UI element does not need to be scrollable. + See also: +

Parameters
UiObjectNotFoundException
- + @@ -2397,7 +3190,8 @@ From class
Throws
-
stepssteps indicates the number of injected move steps into the system. Steps are injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.
+
+ @@ -2409,41 +3203,44 @@ From class - + -
+

- public - - - - + public + + + + boolean swipeLeft (int steps)

-
+
+ -
- -
- -

Perform the action on the UI element that is represented by this object. Also see - #scrollToBeginning(int), #scrollToEnd(int), #scrollBackward(), - #scrollForward(). This method will perform the swipe gesture over any - surface. The targeted UI element does not need to have the attribute - scrollable set to true for this operation to be performed.

+ +

Performs the swipe left action on the UiObject. + The swipe gesture can be performed over any surface. The targeted + UI element does not need to be scrollable. + See also: +

Parameters
UiObjectNotFoundException
- + @@ -2455,7 +3252,8 @@ From class
Throws
-
stepssteps indicates the number of injected move steps into the system. Steps are injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.
+
+ @@ -2467,41 +3265,44 @@ From class - + -
+

- public - - - - + public + + + + boolean swipeRight (int steps)

-
+
+ -
- -
- -

Perform the action on the UI element that is represented by this object. Also see - #scrollToBeginning(int), #scrollToEnd(int), #scrollBackward(), - #scrollForward(). This method will perform the swipe gesture over any - surface. The targeted UI element does not need to have the attribute - scrollable set to true for this operation to be performed.

+ +

Performs the swipe right action on the UiObject. + The swipe gesture can be performed over any surface. The targeted + UI element does not need to be scrollable. + See also: +

Parameters
UiObjectNotFoundException
- + @@ -2513,7 +3314,8 @@ From class
Throws
-
stepssteps indicates the number of injected move steps into the system. Steps are injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.
+
+ @@ -2525,39 +3327,42 @@ From class - + -
+

- public - - - - + public + + + + boolean swipeUp (int steps)

-
+
+ -
- -
- -

Perform the action on the UI element that is represented by this UiObject. Also see - #scrollToBeginning(int), #scrollToEnd(int), #scrollBackward(), - #scrollForward().

+ +

Performs the swipe up action on the UiObject. + See also: +

Parameters
UiObjectNotFoundException
- + @@ -2569,7 +3374,8 @@ From class
Throws
-
stepssteps indicates the number of injected move steps into the system. Steps are injected about 5ms apart. So a 100 steps may take about 1/2 second to complete.
+
+ @@ -2581,86 +3387,81 @@ From class - + -
+

- public - - - - + public + + + + boolean waitForExists (long timeout)

-
+
+ -
- -
- -

Waits a specified length of time for a UI element to become visible. - This method waits until the UI element becomes visible on the display, or +

Waits a specified length of time for a view to become visible. + + This method waits until the view becomes visible on the display, or until the timeout has elapsed. You can use this method in situations where the content that you want to select is not immediately displayed.

Parameters
UiObjectNotFoundException
- +
timeouttimeout the amount of time to wait (in milliseconds)
Returns
-
  • true if the UI element is displayed, else false if timeout elapsed while waiting -
+
  • true if the view is displayed, else false if timeout elapsed while waiting
- + -
+

- public - - - - + public + + + + boolean waitUntilGone (long timeout)

-
+
+ -
- -
- -

Waits a specified length of time for a UI element to become undetectable. - This method waits until a UI element is no longer matchable, or until the +

Waits a specified length of time for a view to become undetectable. + + This method waits until a view is no longer matchable, or until the timeout has elapsed. - A UI element becomes undetectable when the UiSelector of the object is + A view becomes undetectable when the UiSelector of the object is unable to find a match because the element has either changed its state or is no longer displayed. @@ -2670,7 +3471,7 @@ From class

Parameters
- +
timeouttimeout time to wait (in milliseconds)
@@ -2678,10 +3479,65 @@ From class
Returns
  • true if the element is gone before timeout elapsed, else false if timeout elapsed - but a matching element is still found. -
+ but a matching element is still found.
+ + + + + + +

Protected Methods

+ + + + + +
+

+ + protected + + + + + AccessibilityNodeInfo + + findAccessibilityNodeInfo + (long timeout) +

+
+
+ + + +
+
+ +

Finds a matching UI element in the accessibility hierarchy, by + using the selector for this UiObject.

+
+
Parameters
+ + + + +
timeout + in milliseconds
+
+
+
Returns
+
  • AccessibilityNodeInfo if found else null
+
+ +
+ + + + + + diff --git a/docs/html/tools/help/uiautomator/UiObjectNotFoundException.jd b/docs/html/tools/help/uiautomator/UiObjectNotFoundException.jd index 02c607d75c29c..b41cfe5590d7d 100644 --- a/docs/html/tools/help/uiautomator/UiObjectNotFoundException.jd +++ b/docs/html/tools/help/uiautomator/UiObjectNotFoundException.jd @@ -9,29 +9,6 @@ parent.link=index.html to any UI element displayed.

- - - - - - - - - - - - - - - - - - - - -
- -

Summary

@@ -627,4 +604,3 @@ From class

-
diff --git a/docs/html/tools/help/uiautomator/UiScrollable.jd b/docs/html/tools/help/uiautomator/UiScrollable.jd index 33566a2ecdfa7..7405f3b6d8e43 100644 --- a/docs/html/tools/help/uiautomator/UiScrollable.jd +++ b/docs/html/tools/help/uiautomator/UiScrollable.jd @@ -5,33 +5,9 @@ parent.link=index.html -

UiScrollable is a UiCollection and provides support for searching for items in a - scrollable user interface (UI) elements. This class can be used with horizontally or vertically scrollable controls.. -

- - - - - - - - - - - - - - - - - - - - - -
- - +

A UiCollection +that supports searching for items in scrollable layout elements. This class can +be used with horizontally or vertically scrollable controls.

Summary

@@ -49,6 +25,90 @@ parent.link=index.html + + + + + + + + + + + + +
+ [Expand] +
Inherited Constants
+ + From class +com.android.uiautomator.core.UiObject +
+ + +
+
+ + @@ -61,22 +121,21 @@ parent.link=index.html - + - - - - - - - + + + + + + + - - UiScrollable(UiSelector container) - -
UiScrollable is a UiCollection and as such requires a UiSelector to - identify the container UI element of the scrollable collection.
- + + UiScrollable(UiSelector container) + +
Constructor.
+ @@ -93,480 +152,500 @@ parent.link=index.html - + - - - - - - - boolean + + + + + + + boolean - - flingBackward() - -
See scrollBackward(int)
- + + flingBackward() + +
Performs a backwards fling action with the default number of fling + steps (5).
+ - + - - - - - - - boolean + + + + + + + boolean - - flingForward() - -
A convenience version of scrollForward(int), performs a fling
- + + flingForward() + +
Performs a forward fling with the default number of fling steps (5).
+ - + - - - - - - - boolean + + + + + + + boolean - - flingToBeginning(int maxSwipes) - -
See scrollToBeginning(int, int)
- + + flingToBeginning(int maxSwipes) + +
Performs a fling gesture to reach the beginning of a scrollable layout element.
+ - + - - - - - - - boolean + + + + + + + boolean - - flingToEnd(int maxSwipes) - -
See scrollToEnd(int, int)
- + + flingToEnd(int maxSwipes) + +
Performs a fling gesture to reach the end of a scrollable layout element.
+ - + - - - - - - - UiObject + + + + + + + UiObject - - getChildByDescription(UiSelector childPattern, String text, boolean allowScrollSearch) - -
See getChildByDescription(UiSelector, String)
- + + getChildByDescription(UiSelector childPattern, String text, boolean allowScrollSearch) + +
Searches for a child element in the present scrollable container.
+ - + - - - - - - - UiObject + + + + + + + UiObject - - getChildByDescription(UiSelector childPattern, String text) - -
Searches for child UI element within the constraints of this UiScrollable UiSelector + + getChildByDescription(UiSelector childPattern, String text) + +
Searches for a child element in the present scrollable container.
+ + + + + + + + + + + + + UiObject + + + getChildByInstance(UiSelector childPattern, int instance) + +
Searches for a child element in the present scrollable container that + matches the selector you provided.
+ + + + + + + + + + + + + UiObject + + + getChildByText(UiSelector childPattern, String text, boolean allowScrollSearch) + +
Searches for a child element in the present scrollable container.
+ + + + + + + + + + + + + UiObject + + + getChildByText(UiSelector childPattern, String text) + +
Searches for a child element in the present scrollable container.
- + - + - - - - - - - UiObject + + + + + + + int - - getChildByInstance(UiSelector childPattern, int instance) - -
Searches for child UI element within the constraints of this UiScrollable UiSelector - selector.
- + + getMaxSearchSwipes() + +
Gets the maximum number of scrolls allowed when performing a + scroll action in search of a child element.
+ - + - - - - - - - UiObject + + + + + + + double - - getChildByText(UiSelector childPattern, String text, boolean allowScrollSearch) - -
See getChildByText(UiSelector, String)
- + + getSwipeDeadZonePercentage() + +
Returns the percentage of a widget's size that's considered as a no-touch + zone when swiping.
+ - + - - - - - - - UiObject + + + + + + + boolean - - getChildByText(UiSelector childPattern, String text) - -
Searches for child UI element within the constraints of this UiScrollable UiSelector - container.
- + + scrollBackward(int steps) + +
Performs a backward scroll.
+ - + - - - - - - - int + + + + + + + boolean - - getMaxSearchSwipes() - -
#getChildByDescription(String, boolean) and #getChildByText(String, boolean) - use an arguments that specifies if scrolling is allowed while searching for the UI element.
- + + scrollBackward() + +
Performs a backward scroll with the default number of scroll steps (55).
+ - + - - - - - - - double + + + + + + + boolean - - getSwipeDeadZonePercentage() - -
Returns the percentage of a widget's size that's considered as a no touch zone when swiping.
- + + scrollDescriptionIntoView(String text) + +
Performs a forward scroll action on the scrollable layout element until + the content-description is found, or until swipe attempts have been exhausted.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollBackward(int steps) - -
Perform a scroll backward.
- + + scrollForward() + +
Performs a forward scroll with the default number of scroll steps (55).
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollBackward() - -
See scrollBackward(int)
- + + scrollForward(int steps) + +
Performs a forward scroll.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollDescriptionIntoView(String text) - -
Performs a swipe Up on the UI element until the requested content-description - is visible or until swipe attempts have been exhausted.
- + + scrollIntoView(UiSelector selector) + +
Perform a scroll forward action to move through the scrollable layout + element until a visible item that matches the selector is found.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollForward() - -
A convenience version of scrollForward(int), performs a regular scroll
- + + scrollIntoView(UiObject obj) + +
Perform a forward scroll action to move through the scrollable layout element until + a visible item that matches the UiObject is found.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollForward(int steps) - -
Perform a scroll forward.
- + + scrollTextIntoView(String text) + +
Performs a forward scroll action on the scrollable layout element until + the text you provided is visible, or until swipe attempts have been exhausted.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollIntoView(UiSelector selector) - -
Perform a scroll search for a UI element matching the UiSelector selector argument.
- + + scrollToBeginning(int maxSwipes) + +
Scrolls to the beginning of a scrollable layout element.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollTextIntoView(String text) - -
Performs a swipe up on the UI element until the requested text is visible - or until swipe attempts have been exhausted.
- + + scrollToBeginning(int maxSwipes, int steps) + +
Scrolls to the beginning of a scrollable layout element.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollToBeginning(int maxSwipes) - -
See scrollToBeginning(int, int)
- + + scrollToEnd(int maxSwipes, int steps) + +
Scrolls to the end of a scrollable layout element.
+ - + - - - - - - - boolean + + + + + + + boolean - - scrollToBeginning(int maxSwipes, int steps) - -
Scrolls to the beginning of a scrollable UI element.
- + + scrollToEnd(int maxSwipes) + +
Scrolls to the end of a scrollable layout element.
+ - + - - - - - - - boolean + + + + + + + UiScrollable - - scrollToEnd(int maxSwipes, int steps) - -
Scrolls to the end of a scrollable UI element.
- + + setAsHorizontalList() + +
Set the direction of swipes to be horizontal when performing scroll actions.
+ - + - - - - - - - boolean + + + + + + + UiScrollable - - scrollToEnd(int maxSwipes) - -
See {@link UiScrollable#scrollToEnd(int, int)
- + + setAsVerticalList() + +
Set the direction of swipes to be vertical when performing scroll actions.
+ - + - - - - - - - void + + + + + + + UiScrollable - - setAsHorizontalList() - -
Set the direction of swipes when performing scroll search -
- + + setMaxSearchSwipes(int swipes) + +
Sets the maximum number of scrolls allowed when performing a + scroll action in search of a child element.
+ - + - - - - - - - void + + + + + + + UiScrollable - - setAsVerticalList() - -
Set the direction of swipes when performing scroll search -
- - + + setSwipeDeadZonePercentage(double swipeDeadZonePercentage) +
Sets the percentage of a widget's size that's considered as no-touch + zone when swiping.
- - - - - - - - - void - - - setMaxSearchSwipes(int swipes) - -
#getChildByDescription(String, boolean) and #getChildByText(String, boolean) - use an arguments that specifies if scrolling is allowed while searching for the UI element.
- - - - - - - - - - - - - void - - - setSwipeDeadZonePercentage(double swipeDeadZonePercentage) - -
Sets the percentage of a widget's size that's considered as a no touch zone when swiping.
- @@ -576,6 +655,34 @@ parent.link=index.html + + + + + + + + + + + + +
Protected Methods
+ + + + + + boolean + + exists(UiSelector selector) + +
Used privately when performing swipe searches to decide if an element has become + visible or not.
+ +
+ + @@ -585,7 +692,7 @@ parent.link=index.html
Inherited Methods
- +