MultiSelect Action (ListView Controls)

Applies to TestComplete 15.70, last modified on December 17, 2024

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 objects:

View Mode

This method is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.

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 wListSeparator characters.

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

ClickItem Action (ListView Controls)
DblClickItem Action (ListView Controls)
DblClickItemR Action (ListView Controls)
ClickItemXY Action (ListView Controls)

Highlight search results