Function Reference


Perform a mouse click and drag operation.

MouseClickDrag ( "button", x1, y1, x2, y2 [, speed = 10] )


button The button to click:
    $MOUSE_CLICK_LEFT ("left")
    $MOUSE_CLICK_RIGHT ("right")
    $MOUSE_CLICK_MIDDLE ("middle")
    $MOUSE_CLICK_MAIN ("main")
    $MOUSE_CLICK_MENU ("menu")
    $MOUSE_CLICK_PRIMARY ("primary")
    $MOUSE_CLICK_SECONDARY ("secondary")

Constants are defined in "AutoItConstants.au3".
x1, y1 The x/y coords to start the drag operation from.
x2, y2 The x/y coords to end the drag operation at.
speed [optional] the speed to move the mouse in the range 1 (fastest) to 100 (slowest). A speed of 0 will move the mouse instantly. Default speed is 10.

Return Value

Success: 1.
Failure: 0, the button is not in the list.


If the button is an empty string, the left button will be clicked.

If the user has swapped the left and right mouse buttons in the control panel, then the behaviour of the buttons is different. "Left" and "right" always click those buttons, whether the buttons are swapped or not. The "primary" or "main" button will be the main click, whether or not the buttons are swapped. The "secondary" or "menu" buttons will usually bring up the context menu, whether the buttons are swapped or not. See the table in MouseClick for more explanation


MouseClick, MouseClickDragDelay (Option), MouseCoordMode (Option), MouseDown, MouseGetPos, MouseMove, MouseUp, MouseWheel


#include <AutoItConstants.au3>

; Left click drag from 0, 200 to 600, 700

MouseClickDrag($MOUSE_CLICK_LEFT, 0, 200, 600, 700)