Working With iOS Picker View Controls - Basic Concepts

It is possible to specify an item by its name or index. In most cases, you specify an item by its name in the following way:

If an item does not have a name, you can specify it using its index (in other words, its position). Indexes are zero-based: the first item of each wheel of the picker view has index 0, the second - 1, and so on. The total number of items is specified by the wItemCount property. The last item has index wItemCount - 1.

To address a wheel different from the first, you need to specify the wheel index, as well. The total number of wheels is specified by the wWheelCount property. The last wheel has index wWheelCount - 1.

For instance, the script below simulates a touch on the fifth item of the second wheel:

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

  # Touch PickerView item
  pickerview.TouchItem(4, 1)

TestComplete recognizes items of PickerView controls as objects. It displays appropriate test objects as child nodes of the PickerView node in the object hierarchy.

We do not recommend working with picker view items through these child objects. Use appropriate methods and properties of the PickerView test object instead.

During the playback, the picker view iOS objects use the following principles for simulating user actions:

• In properties and methods of the picker view objects, you can specify the desired picker view item using its index or caption. When specifying item caption, you can use wildcards (* and ?) 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.

  In addition, TestComplete can treat the item captions as case-sensitive or case-insensitive depending on the Use case-sensitive parameters project setting (you can change it on the Properties page of your project’s editor).

• If the target picker view item is out of the device’s screen bound, it cannot be displayed in the Object Browser panel. As a result, you cannot perform a touch on the item. To do this, you should use internal methods of the picker view object (TouchItem, LongTouchItem and so on). In this case, the control is automatically scrolled to the specified item and simulates the desired action.