LongTouchItemXY Action (Specific to iOS TableView Controls)

Applies to TestComplete 14.72, last modified on January 20, 2021

Description

Simulates a long touch at the specified point within the control’s item specified by its index or name.

Declaration

TestObj.LongTouchItemXY(SectionItemXYHoldDuration)

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    Variant    
X [in]    Required    Integer    
Y [in]    Required    Integer    
HoldDuration [in]    Optional    Integer Default value: 1000   
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 desired item. You can enter the item’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.

X

Specifies the horizontal coordinate (in pixels) of the long 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 long touch action. This coordinate is specified relatively to the top-left corner of the underlying control.

HoldDuration

Specifies the touch duration (in milliseconds).

Result Value

None.

Example

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

JavaScript, JScript

function Test()
{
  // Select the mobile device
  Mobile.SetCurrent("iPhone");
  // Obtain the TableView object
  var p = Mobile.Device().Process("SampleApp");
  var tableview = p.Window().TableView();
  
  tableview.LongTouchItemXY(0, 1, 10, 10);
}

Python

def Test():
  # Select the mobile device
  Mobile.SetCurrent("iPhone")
  # Obtain the TableView object 
  p = Mobile.Device().Process("SampleApp")
  tableview = p.Window().TableView()
  
  tableview.LongTouchItemXY(0, 1, 10, 10)

VBScript

Sub Test()
  Dim p, tableview
  ' Select the mobile device
  Mobile.SetCurrent("iPhone")
  ' Obtain the tableview object
  Set p = Mobile.Device.Process("SampleApp")
  Set tableview = p.Window(0).TableView(0)
  
  Call tableview.LongTouchItemXY(0, 1, 10, 10)
End Sub

DelphiScript

procedure Test();
var
  p, tableview;
begin
  // Select the mobile device
  Mobile.SetCurrent('iPhone');
  // Obtain the tableview object
  p := Mobile.Device.Process('SampleApp');
  tableview := p.Window(0).TableView(0);
  
  tableview.LongTouchItemXY(0, 1, 10, 10);
end;

C++Script, C#Script

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

See Also

Using Coordinates to Touch Table View Items
Testing iOS Applications
TouchItemXY Method (Specific to iOS TableView Controls)

Highlight search results