PlayerPlayer.getMenuAttribute
Syntax
Player.getMenuAttribute(theAttribute, menu)
Player.getMenuAttribute(theAttribute, menu, item)
Player.getMenuAttribute(theAttribute, menu, submenu)
Player.getMenuAttribute(theAttribute, menu, submenu, item)
Parameters
theAttribute is a named attribute.
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
Gets the specified attribute of the menu, submenu or item.
Returns
A string or number, depending on the attribute.
Examples
with Player « ", attributes" was required in 1.0x but is optional in 1.1
getMenuAttribute(enabled, "Graphics")
with Player « Player 1.0x example ("attributes." prefix is now optional)
getMenuAttribute(enabled, "Graphics")
with Player
getMenuAttribute(enabled, "Graphics") « a menu
getMenuAttribute(kind, "Graphics", "Grid On") « menu item OR submenu
getMenuAttribute(count, "Graphics", "Alignment") « item OR submenu
getMenuAttribute(checked, "Graphics", "Alignment", "Center") « a hierarchical menu item
Errors
Menu or item does not exist or is not enabled; menubar is not available.
The attribute does not exist.
Notes
- Because a variable number of parameters is required to specify a menu, submenu or item, the attribute is the first parameter.
- For a complete list of attributes for each type of object, see the Attributes section of Chapter 6.
- 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.menuExists
Player.popupExists
Player.getItemAttribute
Player.getWindowAttribute
Player.setCompleteMatch
Player.outlineMenus
Keywords
query[11] menus
getMenuInfo