Set Location
ActionStep Reference » Windows » Mouse » Set Location
The ActionStep Mouse Set Location places the mouse cursor to a specified position based on its x-coordinate and y-coordinate. See also the ActionStep Move Mouse To Symbol, that moves the mouse cursor to a specific symbol or visual element on the screen.
- Open the Windows node in the Workspace Explorer.
- In the Mouse node, select the Set Location ActionStep.
Parameters:
The ActionStep has the following input parameters:
| name |
Description
|
|---|---|
|
Screen
|
The target screen of the operation.
Accepted values: Primary Screen, Virtual Screen Allowed Context Scope [Fixed, Local, Global] |
|
Position Mode
|
Determines the initial position of the mouse cursor on the screen. Accepted Values: Absolute (from the top left of the screen) or Relative (relative to its current position) Allowed Context Scope [Fixed] |
| X |
The position of the mouse cursor on the x-coordinate.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
|
Y
|
The position of the mouse cursor on the y-coordinate.
Allowed Context Scopes[Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
|
Pixels Per Second [px/s]
|
Determines the mouse cursor speed as it moves on the screen.
Allowed Context Scopes [Fixed, Local, Global] Allowed Context Types [Variable, Parameter, Enum] |
|
The screen position can be selected directly on the screen. Multiple monitors are also recognized. Identifiers can be used as values for the input parameters. |
Example 1 (Set mouse cursor over the Windows button):
This example initially gets the coordinates of the Windows Start Menu button when the symbol is detected on the screen. The y-coordinate is then adjusted using the Add ActionStep and later applied to set the mouse cursor's location over the Windows button. It is then clicked to open the Windows Start Menu.
