tap

Description

Administer a tap within the test device’s control, window or screen.

window
(Optional) TA name of the window.
control
(Optional) TA name of the control.
x
(Optional) Horizontal position of effective tap, specified as distance in pixels from left edge of the specified display element, which may be a control, window or screen (see note below). (Defaults to horizontal center of display element.)
y
(Optional) Vertical position of effective tap, specified as distance in pixels from top edge of the specified display element, which may be a control, window or screen (see note below). (Defaults to vertical center of display element.)
hold duration
(Optional) Duration of the tap operation (units: milliseconds; valid range: 500 to 60,000; default=0 [i.e., instantaneous]).

This action may be used within the following project items: test modules and user-defined actions.

Use of this action is supported on the following systems/platforms: Mobile operating systems.

As a general rule for all actions involving x, y coordinate arguments, the coordinates are specified in pixels relative to the top-left corner of the:
- control, if a control is specified as an argument;
- window, if a window is specified as an argument, but no control is;
- screen, if neither a window nor control is specified.
If all window, control, x and y arguments’ values are empty, TestArchitect taps in the middle of the device’s screen.
This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.