check item exists
Description
Check for the existence of a specified item in a list box, list view, or combo box control. Result is Passed ifthe item is found; otherwise Failed.
Arguments
window
TA name of the window.
list
TA name of the list box, list view, or combo box control.
item
Identifying item textor index.
Valid contexts
This action may be used within the following project items: test modules and user-defined actions.
Notes
- item argument:
The item argumentmay 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.)
Restriction:Using numerical index values is not supported for Oracle Forms and Microsoft UI Automation (UIA).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.
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.
- 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, remove double quotes from cells, standard ASCII only, item wait, page wait, object 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: Use text value to specify list box item
Action Lines
Result
Example - Case 2: Use numerical index value to specify list box item
Action Lines
Result
Example - Case 3: Use text value to specify list view item
Action Lines
Result
Example - Case 4: Use numerical index value to specify list view item
Action Lines
Result
Related information