Build 1.0_r1(from source)

android.test
Class TouchUtils

java.lang.Object
  extended by android.test.TouchUtils

public class TouchUtils
extends Object

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


Constructor Summary
TouchUtils()
           
 
Method Summary
static void clickView(InstrumentationTestCase test, View v)
          Simulate touching the center of a view and releasing.
static void drag(ActivityInstrumentationTestCase test, float fromX, float toX, float fromY, float toY, int stepCount)
          Simulate touching a specific location and dragging to a new location.
static void dragQuarterScreenDown(ActivityInstrumentationTestCase test)
          Simulate touching in the center of the screen and dragging one quarter of the way down
static void dragQuarterScreenUp(ActivityInstrumentationTestCase test)
          Simulate touching in the center of the screen and dragging one quarter of the way up
static int dragViewBy(ActivityInstrumentationTestCase test, View v, int gravity, int deltaX, int deltaY)
          Simulate touching a view and dragging it by the specified amount.
static int dragViewTo(ActivityInstrumentationTestCase 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)
          Simulate touching the center of a view and dragging to the bottom of the screen.
static void dragViewToBottom(ActivityInstrumentationTestCase test, View v, int stepCount)
          Simulate touching the center of a view and dragging to the bottom of the screen.
static void dragViewToTop(ActivityInstrumentationTestCase 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, int stepCount)
          Simulate touching the center of a view and dragging to the top of the screen.
static int dragViewToX(ActivityInstrumentationTestCase test, View v, int gravity, int toX)
          Simulate touching a view and dragging it to a specified location.
static int dragViewToY(ActivityInstrumentationTestCase 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)
          Simulate touching the center of a view, holding until it is a long press, and then releasing.
static void scrollToBottom(ActivityInstrumentationTestCase test, ViewGroup v)
          Scroll a VirewGroup to the bottom by repeatedly calling dragQuarterScreenUp(ActivityInstrumentationTestCase)
static void scrollToTop(ActivityInstrumentationTestCase test, ViewGroup v)
          Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(ActivityInstrumentationTestCase)
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 on click should fire, etc).
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TouchUtils

public TouchUtils()
Method Detail

dragQuarterScreenDown

public static void dragQuarterScreenDown(ActivityInstrumentationTestCase test)
Simulate touching in the center of the screen and dragging one quarter of the way down

Parameters:
test - The test cast that is being run

dragQuarterScreenUp

public static void dragQuarterScreenUp(ActivityInstrumentationTestCase test)
Simulate touching in the center of the screen and dragging one quarter of the way up

Parameters:
test - The test cast that is being run

scrollToBottom

public static void scrollToBottom(ActivityInstrumentationTestCase test,
                                  ViewGroup v)
Scroll a VirewGroup to the bottom by repeatedly calling dragQuarterScreenUp(ActivityInstrumentationTestCase)

Parameters:
test - The test cast that is being run
v - The ViewGroup that should be dragged

scrollToTop

public static void scrollToTop(ActivityInstrumentationTestCase test,
                               ViewGroup v)
Scroll a ViewGroup to the top by repeatedly calling dragQuarterScreenDown(ActivityInstrumentationTestCase)

Parameters:
test - The test cast that is being run
v - The ViewGroup that should be dragged

dragViewToBottom

public static void dragViewToBottom(ActivityInstrumentationTestCase test,
                                    View v)
Simulate touching the center of a view and dragging to the bottom of the screen.

Parameters:
test - The test cast that is being run
v - The view that should be dragged

dragViewToBottom

public static 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 - The test cast that is being run
v - The view that should be dragged
stepCount - How many move steps to include in the drag

tapView

public static void tapView(InstrumentationTestCase test,
                           View v)
Simulate touching the center of a view and releasing quickly (before the tap timeout).

Parameters:
test - The test cast that is being run
v - The view that should be clicked

touchAndCancelView

public static void touchAndCancelView(InstrumentationTestCase test,
                                      View v)
Simulate touching the center of a view and cancelling (so no on click should fire, etc).

Parameters:
test - The test cast that is being run
v - The view that should be clicked

clickView

public static void clickView(InstrumentationTestCase test,
                             View v)
Simulate touching the center of a view and releasing.

Parameters:
test - The test cast that is being run
v - The view that should be clicked

longClickView

public static 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 - The test cast that is being run
v - The view that should be clicked

dragViewToTop

public static void dragViewToTop(ActivityInstrumentationTestCase test,
                                 View v)
Simulate touching the center of a view and dragging to the top of the screen.

Parameters:
test - The test cast that is being run
v - The view that should be dragged

dragViewToTop

public static 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 - The test cast that is being run
v - The view that should be dragged
stepCount - How many move steps to include in the drag

dragViewBy

public static 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 - The test cast that is being run
v - The view that should be dragged
gravity - 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 - Amount to drag horizontally in pixels
deltaY - Amount to drag vertically in pixels
Returns:
distance in pixels covered by the drag

dragViewTo

public static 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 - The test cast that is being run
v - The view that should be dragged
gravity - 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 - Final location of the view after dragging
toY - Final location of the view after dragging
Returns:
distance in pixels covered by the drag

dragViewToX

public static 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 - The test cast that is being run
v - The view that should be dragged
gravity - 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 - Final location of the view after dragging
Returns:
distance in pixels covered by the drag

dragViewToY

public static 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 - The test cast that is being run
v - The view that should be dragged
gravity - 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 - Final location of the view after dragging
Returns:
distance in pixels covered by the drag

drag

public static void drag(ActivityInstrumentationTestCase test,
                        float fromX,
                        float toX,
                        float fromY,
                        float toY,
                        int stepCount)
Simulate touching a specific location and dragging to a new location.

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

Build 1.0_r1(from source)

Please submit a feedback, bug or feature