PlayerPlayer.chooseHierPopupAt
Syntax
Player.chooseHierPopupAt(x, y, submenu, item)
Player.chooseHierPopupAt(x, y, submenu, item, holding: modifierKeys, extraClick: desiredState)
Parameters
x is the number of pixels from the left side of the frontmost dialog or window.
y is the number of pixels from the top of the frontmost dialog or window.
submenu is either a name or position number.
item is either a name or position number.
holding: modifierKeys, an optional parameter, is one or more modifier keys (command, shift, option, control, caps lock) or their abbreviations (cmd, shft, opt, ctrl, caps), added together in any order.
extraClick: desiredState, set to 'false' to disable the extra click (for a slight increase in speed but at the risk of the app not noticing the changed popup value)
Action
Chooses from a hierarchical pop-up menu (with two parameters to specify the location).
Returns
True.
Examples
Player.chooseHierPopupAt(24, 36, "Nested", "Interface")
Errors
The submenu or item does not exist or is not enabled.
Notes
- This verb is identical to calling chooseHierPopup(...) with a point or list for location.
- The holding label may be left off, though the result may be less readable.
- Use Player's balloon help to determine the ID number (if any) and location.
- 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.choosePopupAt
Player.chooseHierPopup
Keywords
menus[6] dialogItems XY modifiers
chooseMenu