MultiSelect Action (Android Controls)

Applies to TestComplete 15.70, last modified on December 17, 2024
This method is available in legacy mobile tests that work with devices connected to the local computer. To learn how to simulate user actions in newer cloud-compatible mobile tests, see the Simulating user actions in tests section.

Description

Use the MultiSelect action to select several items in the specified control.

Declaration

TestObj.MultiSelect(Items)

TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
Items [in]    Required    Variant    
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 parameter:

Items

This parameter can be either of the following:

  • An array containing captions or indexes of items to select. You can use “native” JavaScript, JScript, Python, VBScript and DelphiScript arrays as well as arrays created using the CreateVariantArray function.
  • A string holding the captions of items to select, separated by the pipeline character ( | ).

Item captions can contain wildcard characters - * and ?. The asterisk (*) corresponds to a string of any length, the question mark (?) - to any single character. Captions can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.

Result Value

None.

Remarks

In order for this action to execute successfully, the control must support multiselection. If an item is not found or the control does not support multiselection, MultiSelect fails and posts an error message to the test log.

See Also

Testing Android Applications (Legacy)
Selecting List View Items
CheckItem Action (Android Controls)
Touch Action (Mobile Objects)
TouchItem Method (Mobile Controls)

Highlight search results