does context menu item exist

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

Name	Description	Type	Modifier
window	TA name of the window.	Interface Entity	None
control	TA name of the control holding the context menu.	Interface Element	None
item	Menu item or menu item path (see ).	String	None
variable	(Optional) Variable to receive the returned Boolean value. Possible returned values: 1: Item found. 0: Item not found.	String	None
x	(Optional) Horizontal position of effective click on menu control, specified as distance in pixels from left edge of the control. Default Value: horizontal center of the control.	String	None
y	(Optional) Vertical position of effective click on menu control, specified as distance in pixels from top edge of the control. Default Value: vertical center of the control.	String	None

A Boolean value to indicate whether a specified item on a context menu exists.

This action may be used within the following project items: test modules and user-defined actions.

Desktop Web, WPF, Java, .Net, Win32

Windows, Linux

The following settings are applicable to this action: case sensitive, remove double quotes from cells, standard ASCII only, menu interact delay, object wait, page wait, window wait, menu interact type.

This action is applicable to the following controls: button, check box, checklist, clock, combo box, datetime, frame, label, list box, list view, menu, password, picture box, progress bar, radio button, rating bar, richtext, scroll bar, separator, spin, status bar, tab control, table, text box, toggle button, toolbar, trackbar, tree view, window.

Example - Case 1: Use text value

Action lines

        
        	interface			
use interface	Music Library			
&nbsp				
	window	control	item	variable
does context menu item exist	search	songs list	Show artist	result

Result

Example - Case 2: Use numerical index value

Action lines

        
        	window	control	item	variable
does context menu item exist	search	songs list	5	result

Result

item argument:
- The menu item may be specified by its caption property or numerical index representing its cardinal placement in the menu, with index values starting at 1.
  Restriction:
  Using numerical index values is not supported for Oracle Forms and Microsoft UI Automation (UIA).
- 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.
- 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.
- In order for TestArchitect to access the items of a context menu, it must activate the menu by simulating a mouse click on the host control. In some cases, the default click location at the center of the control will not bring up the menu. Hence it is sometimes necessary to supply the click location via the x and y arguments.
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.