PlayerPlayer.dragMouse
Syntax
Player.dragMouse(fromLocation, toLocation)
Player.dragMouse(fromLocation, toLocation, holding: modifierKeys)
Parameters
fromLocation is an {x, y} list or a point datatype.
toLocation is 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
Drags the mouse from one location to another.
Returns
True.
Examples
Player.dragMouse( {4, 27}, {4, 60} )
Player.dragMouse( point.set(4, 27), point.set(4, 60) )
Player.dragMouse( {30, -10}, Player.screenCoordinates( {31, 28} ) ) « drag window to the upper left corner of the screen
Notes
- This verb may operate too quickly for an application to keep up. Use setMouseDelay(...) to set a short delay.
- By default, coordinates are relative to the frontmost dialog or window. Changing to a different screen size or having the window come up in a different location should have no effect.
- Use screenCoordinates(...) to treat coordinates as an absolute screen position.
- In most applications, the location is relative to the inside of the window. Negative y values reach into the title bar (if any).
- The holding label may be left off, though the result may be less readable.
See Also
Player.dragSequence
Player.clickMouse
Player.moveMouse
Player.setMouseDelay
Player.setTargetWindow
Player.screenCoordinates
Player.dragMouseFromTo
Keywords
mouse[5] location modifiers
dragMouseFromTo