check selected items
Check the selection status of specified items in a multiple selection control. Result is Passed if all the specified items are selected, otherwise Failed.
Name | Description | Type | Modifier |
---|---|---|---|
window | TA name of the window. | Interface Entity | None |
control | TA name of the multiple selection control. | Interface Element | None |
item<index> | Items to be checked, as identified by their display text or indexes. All except item1 are optional. | String | None |
Result is Passed if all the specified items are selected, otherwise Failed.
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, list view.
Example - Case 1: Use text value to specify list view item
Action lines
window control item1
check selected items search song list My Heart Will Go On|Celine Dion|3966|5:23|mp3|128
Result
Example - Case 2: Use numerical index value
Action lines
window control item1
check selected items search songs list 5
Result
Example - Case 3: Use text value to specify list box item
Action lines
window control item1 item2 item3
check selected items sample item list one three five
Result
Example - Case 4: Use numerical index value to specify list box item
Action lines
window control item1 item2 item3
check selected items sample item list 1 3 4
Result
- item argument:
- There is no practical limit to the number of item arguments that may be specified. In the action line, you may continue listing them in consecutive columns beyond those that have column headers. This action returns a passing result if all items specified in the argument list (item1 through itemN) are selected. The states of items not listed are ignored.
- Each individual item argument may be specified by either of two means: its displayed text, or its numerical index. (Indexes are one-based. That is, numbering begins at 1)
- For list view controls only, to specify an item argument by its text content, enter the combined values of every cell, from left to right, with vertical bars ( | ) as delimiters.
- 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.