check toolbar button exists

Check for the existence of a button on a toolbar.
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
Result is Passed if the specified button is found, otherwise Failed.
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: Using a text value for button

        
        	interface		
use interface	Music Library		
&nbsp			
	window	control	button
check toolbar button exists	library	toolbar	Search
check toolbar button exists	library	toolbar	About
check toolbar button exists	library	toolbar	Close
check toolbar button exists	library	toolbar	Show/Hide
        
    
Example - Case 2: Using a numerical index value for button

        
        	window	control	button
check toolbar button exists	library	toolbar	2
check toolbar button exists	library	toolbar	4
        
    
  • 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.
  • 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