Device Touch Operation

Applies to TestComplete 15.47, last modified on January 20, 2023

Description

Use the Device Touch operation to simulate a touch action on the device's screen (a touch at the specified X Y coordinates).

Requirements

This operation is available only if you have a license for the TestComplete Mobile module.

Scripting Analogue

The operation is an analogue of the Device.Touch() scripting method.

Child Operations

The operation cannot have child operations.

Operation Parameters

The operation uses the following parameters:

ClientX

Integer. Specifies the horizontal coordinate (in pixels) of the point where a touch will be simulated.

ClientY

Integer. Specifies the vertical coordinate (in pixels) of the point where a touch will be simulated.

To modify the operation’s parameters:

  • Select the operation’s row in the test.

  • Select the Value cell and then click within it or press F2. This will activate the in-place editor.

  • Click the ellipsis button in the in-place editor. This will call the dialog, which is similar to the one described above. In this dialog, you can specify the parameter values.

  • Alternatively, to invoke this dialog, simply double-click the operation in the Keyword Test editor.

  • Click OK to close the dialog and apply the changes.

  • Press Enter to confirm the changes and close the in-place editor, or press Esc to close the editor discarding any changes.

Remarks

Before calling this operation, you need to choose a mobile device or a virtual machine that will be the current device (or machine) during testing. You can do this by calling the Select Device or Device Loop operation.

This operation is asynchronous. This means that TestComplete continues running the test, no matter whether it has finished or not. For more information, see Possible Issues.

For information on testing mobile applications with TestComplete, see the topics of the Testing Mobile Applications section.

See Also

Mobile Category
Image Touch Operation
Device Keys Operation
Simulating User Actions Over Android Devices (Legacy)
Testing Mobile Applications

Highlight search results