does toolbar button exist
Return a Boolean value to indicate whether a specified button on a toolbar exists.
| Name | Description | Type | Modifier | 
|---|---|---|---|
| window | TA name of the window.  | Interface Entity | None | 
| control | TA name of the toolbar control.  | Interface Element | None | 
| button | Button, as identified by its caption or index value.  | String | None | 
| variable | (Optional) Variable to receive the returned Boolean value. Possible returned values: 
  | String | None | 
A Boolean value to indicate whether a specified button on a toolbar exists.
This action may be used within the following project items: test modules and user-defined actions.
This action is applicable to the following controls: toolbar.
Example - Case 1: Use text value

        
        	interface			
use interface	Music Library			
 				
	window	control	button	variable
does toolbar button exist	library	toolbar	About	boolean
        
    
Example - Case 2: Use numerical index value

        
        	window	control	button	variable
does toolbar button exist	library	toolbar	2	bool1
does toolbar button exist	library	toolbar	4	bool2
        
    
- 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 passing12surrounded by quotation marks (that is,"12") instead of the numerical12. Passing the numerical12is treated as a reference to an item with an index of 12, rather than an item holding a text string value of12. 
 - 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.