does toolbar button exist

Description

Return a Boolean value to indicate whether a specified button on a toolbar exists.

Arguments

window
TA name of the window.
control
TA name of the toolbar control.
button
Button, as identified by its caption or index value.
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

  • button argument:
    • The button may be specified by either of two means: the caption text, 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.
  • 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, object wait, window wait, load invisible controls.

Applicable Controls

This action is applicable to the following controls: toolbar.

Example - Case 1: Use text value



Action Lines

Result

Example - Case 2: Use numerical index value



Action Lines

Result