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

 does item exist

does item exist

Description

Return a Boolean value to indicate whether a specified item within a list box, list view, or combo box control exists.

Arguments

• window

  TA name of the window.

• control

  TA name of the list box, list view, or combo box control.

• item

  The item caption.

• variable

  (Optional) Variable to receive the returned Boolean value.

  Possible returned values:

  • 1

    Item found.

  • 0

    Item not found.

Valid contexts

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

Notes

• 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.
• variable argument:
  • If the variable in argumentvariablehas not been declared, the action creates it as a global.
  • If the variable argument is left empty, TestArchitect supplies a global variable with the name _result.
• 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, 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: List box control

Action Lines

Result

Example - Case 2: List view control

Action Lines

Result

Related information

check item exists

check item not exists