Selecting Table View Items

Touching Items

Selecting or Unselecting Items

Selecting Multiple Items

Simulating Actions From Keyword Tests

The iOS TableView object, which is used to work with table views, provides a number of methods for simulating a touch on items: TouchItem, LongTouchItem, TouchItemXY and LongTouchItemXY are used to simulate touches on items.

All of these actions have parameters that specify the item to be touched. To specify the item, use a section name or index and an index of an item. Note that it is possible to use wildcards (* and ?) or regular expressions to specify a section’s caption. An asterisk (*) corresponds to a string of any length (including an empty string), a question mark corresponds to any single character (including none). If you wish to specify an asterisk (*) as part of an item’s caption, you should double it, because otherwise, it will be treated as a wildcard. To specify more complicated parts of a caption, use regular expressions. For more information, see Addressing Table View Items. Here is an example of how to select an item from any section:

The sample script below simulates a touch on the first item of the "SectionName" section and then a long touch on the third item in the same section of an application’s table view.

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

  # Touch items
  tableview.TouchItem("SectionName", 0)
  tableview.LongTouchItem("SectionName", 2)

To select or unselect individual items in the control, you can also use the SelectItem method. To select an item, set the method’s Select parameter to true (or leave the parameter unspecified); to unselect an item - set the parameter to false. The method simulates a touch on the item and sets the item to the specified state. If the item is already in the desired state, no action is performed. The following example demonstrates how to use the SelectItem method to select an item and then to unselect it:

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

  # Select items
  tableview.SelectItem("SectionName", 0)
  tableview.SelectItem("SectionName", 0, False)

You may also need to select multiple items. To do this, use the MultiSelect method and specify the items you want to select by their section’s name or index and the items’ indices. If there are items already selected in the specified sections of the object, the method first clears the selection in these sections and then selects the specified items. The item selection in other sections does not change. If the object does not support multiselection, the method performs no actions.

The following example selects the first six items in the first section:

def Test():
  # Select the mobile device
  Mobile.SetCurrent("iPhone")
  # Obtain the TableView object 
  p = Mobile.Device().Process("SampleApp")
  tableview = p.Window().TableView()
  
  # Create an array of items you want to select
  items = [i for i in range(tableview.wItemCount[0])]
    
  # Select the items 
  tableview.Multiselect(0, items)

To select items of table views from keyword tests, call the methods described above by using the On-Screen Action or Call Object Method operation. See Calling Object Methods.