does control exist

Automation Guide

Action-based testing language

Built-in actions

User Interface actions

Control, Element

does control exist

Description

Return a Boolean value to indicate whether the specified control is found to exist.

Arguments

window
TA name of the window.
control
TA name of the control.
variable
(Optional) Variable to receive the returned Boolean value.
Possible returned values:
- 1
  Control found.
- 0
  Control not found.
timeout
(Optional) Maximum wait time for the control to appear (units: seconds; default = the current value of built-in setting object wait probe).
Note:
timeout is an unsupported argument and hence invisible. To use it, you must specify both the value and the header “timeout” in the cells to the right of the variable argument.

Valid contexts

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

Notes

timeout is an unsupported argument and hence invisible. To use it, you must specify both its value and header, in the cell to the right of last visible argument.
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 probe, window wait, load invisible controls.

This action is applicable to the following controls: activity indicator view, button, check box, checklist, clock, collection view, collection view cell, combo box, date picker, datetime, frame, image, label, list box, list view, map view, menu, navigation bar, page control, password, picker view, picture box, progress bar, radio button, rating bar, richtext, scroll bar, scroll view, search bar, segmented control, separator, slider, spin, status bar, stepper, switch, tab bar, tab control, table, table view, table view cell, text box, text view, toggle button, toolbar, trackbar, tree view, view, web view, window.