does toolbar button exist

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

TA name of the window.

Interface EntityNone
control

TA name of the toolbar control.

Interface ElementNone
button

Button, as identified by its caption or index value.

StringNone
variable

(Optional) Variable to receive the returned Boolean value.

Possible returned values:

  • 1: Item found.
  • 0: Item not found.

StringNone
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			
&nbsp				
	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 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.

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333