LongTouchItem Action (Specific to Xamarin.Forms TableView Controls)

Applies to TestComplete 15.64, last modified on June 12, 2024


The LongTouchItem action simulates a long touch over an item specified by its section and index.


TestObj.LongTouchItem(Section, Item, HoldDuration)

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    
HoldDuration [in]    Optional    Integer Default value: 1000   
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.


The method has the following parameters:


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.


Specifies the zero-based index of the desired item.


Specifies the touch duration (in milliseconds).

Result Value



The following example 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
  // Obtain the TableView object
  var p = Mobile.Device().Process("SampleApp");
  var tableview = p.XFObject("MainPage", "").XFObject("Grid", "").XFObject("TableView");
  tableview.LongTouchItem(0, 1);


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


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


procedure Test();
  p, tableview;
  // Select the mobile device
  // Obtain the tableview object
  p := Mobile.Device.Process('SampleApp');
  tableview := p.XFObject('MainPage', '').XFObject('Grid', '').XFObject('TableView');
  tableview.LongTouchItem(0, 1);

C++Script, C#Script

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

See Also

LongTouchItemXY Action (Specific to Xamarin.Forms TableView Controls)
Xamarin.Forms TableView Support
Testing Xamarin.Forms Applications (Legacy)

Highlight search results