Automation Guide Action-based testing language Built-in actions User Interface actions List, Table, Grid

 get selected items

get selected items

Description

Retrieve the text values of the selected items in a multiple selection control.

Arguments

• window

  TA name of the window.

• control

  TA name of the multiple selection control.

• item1, item2, … itemN

  Variables to hold the returned values. Arguments item2 through itemN are optional.

Valid contexts

This action may be used within the following project items: test modules and user-defined actions.

Notes

• item arguments:
  • For the list view control, the content returned to each returned item variable is the concatenation of all cell values of the selected row, separated by vertical bars ( | ).
  • If the variables in argumentsitem1, item2, etc.have not been declared, the action creates them as globals.
• This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Applicable Built-In Settings

The following settings are applicable to this action: case sensitive, ignore blank space, remove double quotes from cells, standard ASCII only, page wait, object wait, value changed wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: list box, list view, combo box.

Example - Case 1: The list view control

Action Lines

Result

Example - Case 2: The list box control

Action Lines

Result

Related information

check selected items

click list item