get mouse position

Description

Retrieve the coordinates of the current mouse pointer position.

window
(Optional) TA name of the window.
control
(Optional) TA name of the control.
x
(Optional) Variable to receive the current horizontal position of mouse pointer, specified as distance in pixels from left edge of the display element, which may be a control, window or screen (see note below). (Defaults to horizontal center of the display element.)
y
(Optional) Variable to receive the current vertical position of mouse pointer, specified as distance in pixels from top edge of the display element, which may be a control, window or screen (see note below). (Defaults to horizontal center of the display element.)

This action may be used within the following project items: test modules and user-defined actions.

As a general rule for all actions involving x,y coordinate arguments, the coordinates are specified in pixels relative to the top-left corner of the:
- control, if the action has window and control arguments, and values are specified for both of them;
- window, if the action has a value specified for a window argument, but has no control value specified (whether or not the control argument exists);
- screen, if neither a window nor control value is specified, whether or not such arguments exist.
Notes:
As for TestArchitect 8.4 Update 2, the coordinates are determined in pixels relative to the top-left corner of the working document.
Restriction:
This rule should not be taken to imply that any control or window arguments are optional if their associated actions don’t explicitly state that.
This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.