TouchItemXY Method (Specific to Xamarin.Forms TableView Controls)

Applies to TestComplete 15.70, last modified on December 17, 2024

Description

Simulates a touch at the specified point within the control’s item.

Declaration

TestObj.TouchItemXY(Section, Item, X, Y)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Section [in]    Required    Variant    
Item [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

To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.

Parameters

The method has the following parameters:

Section

Specifies the section of the desired item. You can enter the section’s index (from 0) or its caption. The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk (*) corresponds to a string of any length (including an empty string), the question mark corresponds to any single character (including none). To specify more complicated parts of a caption, use regular expressions.

The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

Item

Specifies the zero-based index of the desired item.

X

Specifies the horizontal coordinate (in pixels) of the touch action. This coordinate is specified relatively to the top-left corner of the underlying control.

Y

Specifies the vertical coordinate (in pixels) of the touch action. This coordinate is specified relatively to the top-left corner of the underlying control.

Result Value

None.

Example

This example script simulates a touch on the second item in the first section of the application’s TableView.

JavaScript, JScript

function Test()
{
  // Select the mobile device
  Mobile.SetCurrent("MyMobileDevice");
  // Obtain the TableView object
  var p = Mobile.Device().Process("SampleApp");
  var tableview = p.XFObject("MainPage", "").XFObject("Grid", "").XFObject("TableView");
  
  tableview.TouchItemXY(0, 1, 10, 10);
}

Python

def Test():
  # Select the mobile device
  Mobile.SetCurrent("MyMobileDevice")
  # Obtain the TableView object 
  p = Mobile.Device().Process("SampleApp")
  tableview = p.XFObject("MainPage", "").XFObject("Grid", "").XFObject("TableView")
  
  tableview.TouchItemXY(0, 1, 10, 10)

VBScript

Sub Test()
  Dim p, tableview
  ' Select the mobile device
  Mobile.SetCurrent("MyMobileDevice")
  ' Obtain the tableview object
  Set p = Mobile.Device.Process("SampleApp")
  Set tableview = p.XFObject("MainPage", "").XFObject("Grid", "").XFObject("TableView")
  
  Call tableview.TouchItemXY(0, 1, 10, 10)
End Sub

DelphiScript

procedure Test();
var
  p, tableview;
begin
  // Select the mobile device
  Mobile.SetCurrent('MyMobileDevice');
  // Obtain the tableview object
  p := Mobile.Device.Process('SampleApp');
  tableview := p.XFObject('MainPage', '').XFObject('Grid', '').XFObject('TableView');
  
  tableview.TouchItemXY(0, 1, 10, 10);
end;

C++Script, C#Script

function Test()
{
  // Select the mobile device
  Mobile["SetCurrent"]("MyMobileDevice");
  // Obtain the TableView object
  var p = Mobile["Device"].Process("SampleApp");
  var tableview = p["XFObject"]("MainPage", "")["XFObject"]("Grid", "")["XFObject"]("TableView");
  
  tableview["TouchItemXY"](0, 1, 10, 10);
}

See Also

TouchItem Method (Specific to Xamarin.Forms TableView Controls)
Xamarin.Forms TableView Support
Testing Xamarin.Forms Applications (Legacy)

Highlight search results