PlayerPlayer.menuExists
Syntax
Player.menuExists(menu)
Player.menuExists(menu, item)
Player.menuExists(menu, submenu)
Player.menuExists(menu, submenu, item)
Parameters
menu is either a name or position number.
submenu is either a name or position number.
item is either a name or position number.
Action
Determines if the indicated menu, submenu or item exists.
Returns
True if it exists, false if not.
Examples
if Player.menuExists("Graphics") « a menu
if Player.menuExists("Graphics", "Grid On") « a menu item OR submenu
if Player.menuExists("Graphics", "Alignment") « a menu item OR submenu
if Player.menuExists("Graphics", "Alignment", "Center") « hier. menu item
Errors
Menubar is not available (e.g. a modal dialog is present).
Notes
- If you get unexplained errors, see the separate Tech Support FAQ document.
- Given 2 parameters, this verb does not distinguish between an item and a submenu. An additional call to getMenuAttributes(...) is required.
- For nested hierarchical menus, use the form "submenu;subsubmenu".
- By default, Player matches only the number of characters specified in the verb parameter. This feature has the benefit of ignoring trailing punctuation, but will occasionally find a false match.
- By default, name matching is not case sensitive.
See Also
Player.getMenuInfo
Player.getMenuAttribute
Player.chooseMenu
Player.chooseHierMenu
Player.setCompleteMatch
Player.outlineMenus
Keywords
query[1] menus
moveMouse