PlayerPlayer.clickButton
Syntax
Player.clickButton(theButton)
Player.clickButton(theButton, holding: modifierKeys)
Parameters
theButton is either a name, ID number, or location (an {x, y} list or a point datatype)
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.
Action
Clicks the indicated button.
Returns
True.
Examples
Player.clickButton("OK")
Player.clickButton(14) « ID
Player.clickButton( {10, 20} ) « location
Player.clickButton("Find Next", holding: command + option)
Errors
The button does not exist or is not enabled.
Notes
- The holding label may be left off, though the result may be less readable.
- e.g. clickButton("Find Next", command + option)
- To click a whole series of dialog items in one step, use clickSequence(...).
- 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.clickDefaultButton
Player.acceptDialog
Player.cancelDialog
Player.buttonExists
Player.getItemInfo
Player.getItemAttribute
Player.clickItem
Player.clickSequence
Player.setCompleteMatch
Player.setForcedYield
Keywords
dialogItems[1] buttons location modifiers
clickDefaultButton