Working With Android Expandable List Controls - Basic Concepts

With TestComplete, you can simulate actions over expandable list controls in Android applications. Expandable list controls are associated with the Android ExpandableList objects, and TestComplete uses various methods provided by these objects (such as TouchItem, Expand and other). The Android ExpandableList object’s properties allow you to retrieve data from the expandable list and check an item’s properties. For instance, the wIsExpanded property returns True if the specified group is expanded. For more information on available actions, see the object description and Working With Android Expandable List Controls.

In addition to expandable list controls, TestComplete supports standard list views and works with them via the Android ListView object. For detailed information, see Working With Android List View Controls

Currently, TestComplete does not support recording tests for Android Open Applications. In order to use extended support for expandable list controls, you need to create tests manually. For detailed information, see About Testing Android Applications (Legacy) and Creating Tests for Android Open Applications (Legacy).

During playback, the list view Android objects use the following principles for simulating user actions:

• In properties and methods of the expandable list objects, you can specify the desired group using its index or caption. When specifying its caption, you can use wildcard characters (* and ?) or regular expressions. The asterisk (“*”) indicates a substring of any length and the question mark (“?”) matches any single character. To specify a more complex string, use a regular expression.

  In addition, TestComplete can treat the group 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). For more information, see Addressing Expandable List Groups and Items.

• If the target list item is out of the device’s screen bounds, it cannot be displayed in the Object Browser panel. As a result, you cannot perform a touch on the item. To touch it, you should use internal methods of the Android ExpandableList object (TouchItem, LongTouchItem and so on). In this case, TestComplete automatically scrolls the control to the specified group, expands it and simulates the desired action.