added in API level 1
Deprecated since API level 24

Summary: Ctors | Methods | Inherited Methods

TouchUtils

public class TouchUtils
extends Object

java.lang.Object
↳	android.test.TouchUtils

This class was deprecated in API level 24.
Use Espresso UI testing framework instead. New tests should be written using the Android Testing Support Library.

Reusable methods for generating touch events. These methods can be used with InstrumentationTestCase or ActivityInstrumentationTestCase2 to simulate user interaction with the application through a touch screen.

Summary

Public constructors
`TouchUtils()`

Public methods
`static void`	`clickView(InstrumentationTestCase test, View v)` Simulate touching the center of a view and releasing.
`static void`	`drag(InstrumentationTestCase test, float fromX, float toX, float fromY, float toY, int stepCount)` Simulate touching a specific location and dragging to a new location.
`static void`	`drag(ActivityInstrumentationTestCase test, float fromX, float toX, float fromY, float toY, int stepCount)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragQuarterScreenDown(InstrumentationTestCase test, Activity activity)` Simulate touching in the center of the screen and dragging one quarter of the way down
`static void`	`dragQuarterScreenDown(ActivityInstrumentationTestCase test)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragQuarterScreenUp(ActivityInstrumentationTestCase test)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragQuarterScreenUp(InstrumentationTestCase test, Activity activity)` Simulate touching in the center of the screen and dragging one quarter of the way up
`static int`	`dragViewBy(InstrumentationTestCase test, View v, int gravity, int deltaX, int deltaY)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewBy(ActivityInstrumentationTestCase test, View v, int gravity, int deltaX, int deltaY)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewTo(ActivityInstrumentationTestCase test, View v, int gravity, int toX, int toY)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewTo(InstrumentationTestCase test, View v, int gravity, int toX, int toY)` Simulate touching a view and dragging it to a specified location.
`static void`	`dragViewToBottom(ActivityInstrumentationTestCase test, View v)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragViewToBottom(InstrumentationTestCase test, Activity activity, View v, int stepCount)` Simulate touching the center of a view and dragging to the bottom of the screen.
`static void`	`dragViewToBottom(ActivityInstrumentationTestCase test, View v, int stepCount)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragViewToBottom(InstrumentationTestCase test, Activity activity, View v)` Simulate touching the center of a view and dragging to the bottom of the screen.
`static void`	`dragViewToTop(InstrumentationTestCase test, View v)` Simulate touching the center of a view and dragging to the top of the screen.
`static void`	`dragViewToTop(ActivityInstrumentationTestCase test, View v)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`dragViewToTop(InstrumentationTestCase test, View v, int stepCount)` Simulate touching the center of a view and dragging to the top of the screen.
`static void`	`dragViewToTop(ActivityInstrumentationTestCase test, View v, int stepCount)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewToX(InstrumentationTestCase test, View v, int gravity, int toX)` Simulate touching a view and dragging it to a specified location.
`static int`	`dragViewToX(ActivityInstrumentationTestCase test, View v, int gravity, int toX)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewToY(ActivityInstrumentationTestCase test, View v, int gravity, int toY)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static int`	`dragViewToY(InstrumentationTestCase test, View v, int gravity, int toY)` Simulate touching a view and dragging it to a specified location.
`static void`	`longClickView(ActivityInstrumentationTestCase test, View v)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`longClickView(InstrumentationTestCase test, View v)` Simulate touching the center of a view, holding until it is a long press, and then releasing.
`static void`	`scrollToBottom(ActivityInstrumentationTestCase test, ViewGroup v)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`scrollToBottom(InstrumentationTestCase test, Activity activity, ViewGroup v)` Scroll a ViewGroup to the bottom by repeatedly calling `dragQuarterScreenUp(InstrumentationTestCase, Activity)`
`static void`	`scrollToTop(ActivityInstrumentationTestCase test, ViewGroup v)` This method was deprecated in API level 3. `ActivityInstrumentationTestCase` is deprecated in favor of `ActivityInstrumentationTestCase2`, which provides more options for configuring the Activity under test
`static void`	`scrollToTop(InstrumentationTestCase test, Activity activity, ViewGroup v)` Scroll a ViewGroup to the top by repeatedly calling `dragQuarterScreenDown(InstrumentationTestCase, Activity)`
`static void`	`tapView(InstrumentationTestCase test, View v)` Simulate touching the center of a view and releasing quickly (before the tap timeout).
`static void`	`touchAndCancelView(InstrumentationTestCase test, View v)` Simulate touching the center of a view and cancelling (so no onClick should fire, etc).

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Public constructors

TouchUtils

added in API level 1

TouchUtils ()

Public methods

clickView

added in API level 1

void clickView (InstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and releasing.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be clicked

drag

added in API level 3

void drag (InstrumentationTestCase test, 
                float fromX, 
                float toX, 
                float fromY, 
                float toY, 
                int stepCount)

Simulate touching a specific location and dragging to a new location.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`fromX`	`float`: X coordinate of the initial touch, in screen coordinates
`toX`	`float`: Xcoordinate of the drag destination, in screen coordinates
`fromY`	`float`: X coordinate of the initial touch, in screen coordinates
`toY`	`float`: Y coordinate of the drag destination, in screen coordinates
`stepCount`	`int`: How many move steps to include in the drag

drag

added in API level 1

void drag (ActivityInstrumentationTestCase test, 
                float fromX, 
                float toX, 
                float fromY, 
                float toY, 
                int stepCount)

This method was deprecated in API level 3.
ActivityInstrumentationTestCase is deprecated in favor of ActivityInstrumentationTestCase2, which provides more options for configuring the Activity under test

Simulate touching a specific location and dragging to a new location.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`fromX`	`float`: X coordinate of the initial touch, in screen coordinates
`toX`	`float`: Xcoordinate of the drag destination, in screen coordinates
`fromY`	`float`: X coordinate of the initial touch, in screen coordinates
`toY`	`float`: Y coordinate of the drag destination, in screen coordinates
`stepCount`	`int`: How many move steps to include in the drag

dragQuarterScreenDown

added in API level 3

void dragQuarterScreenDown (InstrumentationTestCase test, 
                Activity activity)

Simulate touching in the center of the screen and dragging one quarter of the way down

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case

dragQuarterScreenDown

added in API level 1

void dragQuarterScreenDown (ActivityInstrumentationTestCase test)

Simulate touching in the center of the screen and dragging one quarter of the way down

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run

dragQuarterScreenUp

added in API level 1

void dragQuarterScreenUp (ActivityInstrumentationTestCase test)

Simulate touching in the center of the screen and dragging one quarter of the way up

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run

dragQuarterScreenUp

added in API level 3

void dragQuarterScreenUp (InstrumentationTestCase test, 
                Activity activity)

Simulate touching in the center of the screen and dragging one quarter of the way up

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case

dragViewBy

added in API level 3

int dragViewBy (InstrumentationTestCase test, 
                View v, 
                int gravity, 
                int deltaX, 
                int deltaY)

Simulate touching a view and dragging it by the specified amount.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`deltaX`	`int`: Amount to drag horizontally in pixels
`deltaY`	`int`: Amount to drag vertically in pixels

Returns
`int`	distance in pixels covered by the drag

dragViewBy

added in API level 1

int dragViewBy (ActivityInstrumentationTestCase test, 
                View v, 
                int gravity, 
                int deltaX, 
                int deltaY)

Simulate touching a view and dragging it by the specified amount.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`deltaX`	`int`: Amount to drag horizontally in pixels
`deltaY`	`int`: Amount to drag vertically in pixels

Returns
`int`	distance in pixels covered by the drag

dragViewTo

added in API level 1

int dragViewTo (ActivityInstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toX, 
                int toY)

Simulate touching a view and dragging it to a specified location.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toX`	`int`: Final location of the view after dragging
`toY`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

dragViewTo

added in API level 3

int dragViewTo (InstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toX, 
                int toY)

Simulate touching a view and dragging it to a specified location.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toX`	`int`: Final location of the view after dragging
`toY`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

dragViewToBottom

added in API level 1

void dragViewToBottom (ActivityInstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged

dragViewToBottom

added in API level 3

void dragViewToBottom (InstrumentationTestCase test, 
                Activity activity, 
                View v, 
                int stepCount)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case
`v`	`View`: The view that should be dragged
`stepCount`	`int`: How many move steps to include in the drag

dragViewToBottom

added in API level 1

void dragViewToBottom (ActivityInstrumentationTestCase test, 
                View v, 
                int stepCount)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`stepCount`	`int`: How many move steps to include in the drag

dragViewToBottom

added in API level 3

void dragViewToBottom (InstrumentationTestCase test, 
                Activity activity, 
                View v)

Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case
`v`	`View`: The view that should be dragged

dragViewToTop

added in API level 3

void dragViewToTop (InstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged

dragViewToTop

added in API level 1

void dragViewToTop (ActivityInstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged

dragViewToTop

added in API level 3

void dragViewToTop (InstrumentationTestCase test, 
                View v, 
                int stepCount)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`stepCount`	`int`: How many move steps to include in the drag

dragViewToTop

added in API level 1

void dragViewToTop (ActivityInstrumentationTestCase test, 
                View v, 
                int stepCount)

Simulate touching the center of a view and dragging to the top of the screen.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`stepCount`	`int`: How many move steps to include in the drag

dragViewToX

added in API level 3

int dragViewToX (InstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toX)

Simulate touching a view and dragging it to a specified location. Only moves horizontally.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toX`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

dragViewToX

added in API level 1

int dragViewToX (ActivityInstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toX)

Simulate touching a view and dragging it to a specified location. Only moves horizontally.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toX`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

dragViewToY

added in API level 1

int dragViewToY (ActivityInstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toY)

Simulate touching a view and dragging it to a specified location. Only moves vertically.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toY`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

dragViewToY

added in API level 3

int dragViewToY (InstrumentationTestCase test, 
                View v, 
                int gravity, 
                int toY)

Simulate touching a view and dragging it to a specified location. Only moves vertically.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be dragged
`gravity`	`int`: Which part of the view to use for the initial down event. A combination of (TOP, CENTER_VERTICAL, BOTTOM) and (LEFT, CENTER_HORIZONTAL, RIGHT)
`toY`	`int`: Final location of the view after dragging

Returns
`int`	distance in pixels covered by the drag

longClickView

added in API level 1

void longClickView (ActivityInstrumentationTestCase test, 
                View v)

Simulate touching the center of a view, holding until it is a long press, and then releasing.

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be clicked

longClickView

added in API level 3

void longClickView (InstrumentationTestCase test, 
                View v)

Simulate touching the center of a view, holding until it is a long press, and then releasing.

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be clicked

scrollToBottom

added in API level 1

void scrollToBottom (ActivityInstrumentationTestCase test, 
                ViewGroup v)

Scroll a ViewGroup to the bottom by repeatedly calling dragQuarterScreenUp(InstrumentationTestCase, Activity)

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`ViewGroup`: The ViewGroup that should be dragged

scrollToBottom

added in API level 3

void scrollToBottom (InstrumentationTestCase test, 
                Activity activity, 
                ViewGroup v)

Scroll a ViewGroup to the bottom by repeatedly calling dragQuarterScreenUp(InstrumentationTestCase, Activity)

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case
`v`	`ViewGroup`: The ViewGroup that should be dragged

scrollToTop

added in API level 1

void scrollToTop (ActivityInstrumentationTestCase test, 
                ViewGroup v)

Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(InstrumentationTestCase, Activity)

Parameters
`test`	`ActivityInstrumentationTestCase`: The test case that is being run
`v`	`ViewGroup`: The ViewGroup that should be dragged

scrollToTop

added in API level 3

void scrollToTop (InstrumentationTestCase test, 
                Activity activity, 
                ViewGroup v)

Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(InstrumentationTestCase, Activity)

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`activity`	`Activity`: The activity that is in the foreground of the test case
`v`	`ViewGroup`: The ViewGroup that should be dragged

tapView

added in API level 1

void tapView (InstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and releasing quickly (before the tap timeout).

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be clicked

touchAndCancelView

added in API level 1

void touchAndCancelView (InstrumentationTestCase test, 
                View v)

Simulate touching the center of a view and cancelling (so no onClick should fire, etc).

Parameters
`test`	`InstrumentationTestCase`: The test case that is being run
`v`	`View`: The view that should be clicked