is toolbar button pressed

Return a Boolean value to indicate whether a button on a toolbar is depressed.
NameDescriptionTypeModifier
window

TA name of the window.

Interface EntityNone
toolbar

TA name of the toolbar control.

Interface ElementNone
item

Button, as identified by its caption or index value.

StringNone
variable

(Optional) Variable to receive the returned Boolean value.

Possible returned values:

  • 1: Button is pressed.
  • 0: Button is not pressed.

StringNone
A Boolean value to indicate whether a button on a toolbar is depressed.
This action may be used within the following project items: test modules and user-defined actions.
The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only, object wait, window wait.
This action is applicable to the following controls: toolbar.
Example - Case 1: Use text value

        
        	interface			
use interface	Music Library			
&nbsp				
	window	toolbar	item	variable
is toolbar button pressed	library	toolbar	About	boolean
        
    
Example - Case 2: Use numerical index value

        
        	window	toolbar	item	variable
is toolbar button pressed	library	toolbar	4	boolean
        
    
  • item argument:
    • The item argument may be specified by either of two means:the button’s caption text, or its numerical index (Indexes are one-based. That is, numbering begins at 1).
    • 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