select
Select an item in a combo box control or one or more items of a list box control.
Name | Description | Type | Modifier |
---|---|---|---|
window | TA name of the window. | Interface Entity | None |
control | TA name of the list box or the combo box control. | Interface Element | None |
value | Identifying text of the item(s) to be selected, or item’s index value(s). | String | None |
None
This action may be used within the following project items: test modules and user-defined actions.
This action is applicable to the following controls: combo box, list box.
Example - Case 1: Using a text value to select an item
Action lines
interface
use interface Car Rental
 
window control item1
check selected items date and location pickup state Alabama
 
window control value
select date and location pickup state California
 
window control item1
check selected items date and location pickup state California
Result
Example - Case 2: Using numerical index to select an item
Action lines
window control item1
check selected items date and location pickup state 1
 
window control value
select date and location pickup state 8
 
window control item1
check selected items date and location pickup state 8
Result
Example - Case 3: Using text values to select multiple items in a list box control
Action lines
window control item1
check selected items sample item list one
 
window control value value1 value2
select sample item list five six seven
 
window control item1 item2 itemn
check selected items sample item list five six seven
Result
Example - Case 4: Using numerical index values to select multiple items in a list box control
Action lines
window control item1
check selected items sample item list 1
 
window control value value1 value2
select sample item list 3 4 5
 
window control item1 item2 itemn
check selected items sample item list 3 4 5
Result
- value argument:
- The value argument may be specified by either of two means: the displayed text of the item, or its numerical index. (Indexes are one-based. That is numbering begins at 1)
- In the case of a list box control, more than one item may be selected. Do this by providing additional value arguments in the cells to the right of the first value argument, along with arbitrary argument header names of your own choosing. (See example above). Note: However, that it is not possible to mix data types (index and text) of multiple value arguments in a single action line.
- Enclose a numerical text string in quotation marks to differentiate it from a numerical index value. For example, if a text value of an item in a control has a value of 12, you should reference that item by passing 12 surrounded by quotation marks (that is, “12”) instead of the numerical 12. Passing the numerical 12 is treated as a reference to an item with an index of 12, rather than an item holding a text string value of 12.
- 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.