does menu item exist

Return a Boolean value to indicate whether a specified item on a menu exists.
NameDescriptionTypeModifier
window

TA name of the window.

Interface EntityNone
menu

(Optional/Mandatory based on platform – see the section below) TA name of the menu control.

Interface ElementNone
item

Menu item or menu item path (see ).

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 item on a menu 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: menu.
Example - Case 1: Item on main menu of a Windows application

        
        	interface			
use interface	Window Application			
&nbsp				
	window	menu	item	variable
does menu item exist	notepad		File->Exit	i1
        
    
Example - Case 2: Item on menu of a Java application

        
        	interface			
use interface	Car Rental			
&nbsp				
	window	menu	item	variable
does menu item exist	welcome	main menu	File->View Cars	i1
        
    
  • menu argument:
    • The menu argument does not apply in the case of an AUT with a user interface based on the Windows API. In such cases, the argument should be omitted.
    • For other platforms, the menu control of interest should be captured as an interface element and passed to this action through the menu argument.
  • item argument:
    • Menu items are identified by their caption properties.
    • If a menu path of more than one item must be specified, use arrow symbols ( -> ) as delimiters between menu items. For example, Vehicles->Cars->Four-door sedans.
  • 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 © 2024 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 (650) 572-1400