PlayerPlayer.choosePopupAt
Syntax
Player.choosePopupAt(x, y, item)
Player.choosePopupAt(x, y, 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.
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 pop-up menu (with two parameters to specify the location).
Returns
True.
Examples
Player.choosePopup(220, 147, "points" ) « height
Errors
The item does not exist or is not enabled.
Notes
- This verb is identical to calling choosePopup(...) with a point or list for location.
- As shown in the example, even if the popup itself must be specified by XY location, the item can usually be specified by name.
- You can make a script a little faster by setting extraClick to false. Unfortunately, it won't work in all cases. Even though the popup visibly changes, some applications don't notice the change without the extra click.
- 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.chooseHierPopupAt
Player.choosePopup
Keywords
menus[5] dialogItems XY modifiers
clickButton