TouchCellXY Action (Android Controls)

Applies to TestComplete 14.91, last modified on July 20, 2021
This method is available in legacy mobile tests that work with devices connected to the local computer. To learn how to simulate user actions in newer cloud-compatible mobile tests, see the Simulating user actions in tests section.

Description

The LongTouchCellXY simulates a long touch at the specified point (X, Y), which is relative to the top left corner of the grid cell in the specified row and column.

Declaration

TestObj.TouchCellXY(RowColumnXY)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Row [in]    Required    Integer    
Column [in]    Required    Integer    
X [in]    Required    Integer    
Y [in]    Required    Integer    
Result None

Applies To

The method is applied to the following object:

View Mode

This method is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

Parameters

The method has the following parameters:

Row

The zero-based index of the row that contains the desired cell. The index is zero-based, that is, the first visible row has index 0, the second - 1, and so on. The index of the last visible row is wRowCount - 1.

Column

Specifies the column (by its index) that contains the desired cell. The index is zero-based, that is, the first column has index 0, the second - 1, and so on. The index of the last column is wColumnCount-1.

X

Specifies the horizontal coordinate of the mouse pointer where long touch will be simulated. The coordinate is relative to the top left corner of the cell.

Y

Specifies the vertical coordinate of the mouse pointer where a long touch will be simulated. The coordinate is relative to the top left corner of the cell.

Result Value

None.

Remarks

If the specified cell is not found TouchCellXY fails and posts an error message to the log.

See Also

Testing Android Applications (Legacy)
Selecting Grid View Cells
TouchCell Action (Android Controls)
LongTouchCell Action (Android Controls)
LongTouchCellXY Action (Android Controls)

Highlight search results