does control exist


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


TA name of the window.
TA name of the control.
(Optional) Variable to receive the returned Boolean value.
Possible returned values:
Control found.
Control not found.
time out
(Optional) Maximum wait time for the control to appear (units: seconds; default = the current value of built-in setting object wait probe).
Note: time out is an unsupported argument and hence invisible. To use it, you must specify both the value and the header time out 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.


  • time out 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 argument variable has 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.

Applicable 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.


Action Lines