ExtendedReleaseMouse Method

Class

AnyWin class.

Action

Releases the mouse with one or more key modifiers.

Availability

This functionality is supported only if you are using the Open Agent.

Syntax

ExtendedReleaseMouse (keyModifiers, iButton, x, y)
Variable Description
keyModifiers Defines which additional keys should be pressed while releasing the mouse. MODIFIERKEYSTATE.
iButton Optional: The mouse button to press: Windows: 1 for left (default), 2 for right, and 3 for center. INTEGER.
x Optional: The horizontal coordinate (relative to the window) at which to release the mouse. If you specify x, you must also specify y. The default is 0 for a window, or the button center for a pushbutton. INTEGER.
y Optional: The vertical coordinate (relative to the window) at which to release the mouse. The default is 0 for a window, or the button center, for a pushbutton. INTEGER.

Notes

ExtendedReleaseMouse moves the mouse to the windowand releases the specified mouse button (if it is not already released).

ExtendedReleaseMouse is a low-level method that most scripts do not have to call. In general, when interacting with an application, you use the ExtendedClick method to click the mouse, or a method designed to perform the action desired, such as Pick to pick a menu item.

The mouse is moved to the coordinates specified by x and y before performing the release. These coordinates are relative to the client area of the window (that is, the window's internal area, excluding its caption, menu bar, and border). If you do not specify the coordinates of the release point, the release occurs in the upper left corner (0, 0) of the client area of the window.

To specify to ignore coordinates outside of the window, set the OPT_VERIFY_COORD option, using the SetOption method or the Verify that Coordinates Passed to a Method Are Inside the Window option on the Verification panel of the Agent Options dialog box.