Click operations
Click operations must be indicated in curly brackets. By default, clicks are performed into the center of the respective control.
The following click operations are available:
Click operation |
Description |
{ALTCLICK} |
Performs a left click while holding the Alt key down |
{CLICK} |
Click with the left mouse button |
{CONTROLCLICK} |
Performs a left click while holding the Ctrl key down |
{DOUBLECLICK} |
Double click with the left mouse button |
{DRAG} |
This selects the object to be repositioned. The object in question must support drag and drop operations. |
{DROP} |
This inserts an object that was previously selected with {DRAG}. |
{LONGCLICK} |
Click with the left mouse button which lasts for two seconds |
{MOUSEOVER} |
Moves the mouse pointer over the control. |
{RIGHTCLICK} |
Click with the right mouse button |
{SHIFTCLICK} |
Performs a left click while holding the Shift key down. |
You can use the value X instead of {CLICK} for left clicks. X instructs the system to perform a click without using the mouse and it verifies whether or not the control is disabled. |
In this example, the START button is clicked.
Simple click on a button |
Define the click position for CLICK
You can define an offset for the click operations {CLICK} and {LONGCLICK}. The offset is defined in square brackets and specified in pixels px or in percent %.
Syntax: |
{Click[OffsetHorizontal][OffsetVertical]} |
The specification of Offsets is relative to the upper left border of the control area.
This example defines an offset of 10px along the horizontal axis and 10px along the vertical axis for performing a click onto the Next button:
Click on a button with defined offset in pixels This example defines an offset of 100% along the horizontal axis and 100% along the vertical axis. The click is performed onto the bottom right border of the control area.
Click on the bottom right border of a button |
Define mouse movements and click positions
Use {Mouse} operations to define click operations, mouse movements, and offsets:
Syntax: |
{MOUSE[Action][MoveMethod][OffsetHorizontal][OffsetVertical]} |
The parameter Action defines which click operation to perform. You can specify the following values:
Action |
Description |
CLICK |
Click with the left mouse button. |
DOUBLECLICK |
Double-click with the left mouse button. |
DRAG |
Selects the object with the left mouse button for repositioning. The object must support drag and drop operations. |
DROP |
Inserts an object that was previously selected with DRAG or RIGHTCLICKDRAG. |
LONGCLICK |
Click with the left mouse button which lasts for two seconds. |
MOUSEOVER |
Moves the mouse pointer over the control. |
RIGHTCLICK |
Click with the right mouse button. |
RIGHTCLICKDRAG |
Selects the object with the right mouse button for repositioning. The object must support right-click drag and drop operations. |
You can specify the following values for the parameter MoveMethod:
MoveMethod |
Description |
Jump |
The mouse pointer jumps directly to the clicked location. |
Smooth |
The mouse pointer moves smoothly towards the clicked location. |
HorizontalFirst |
The mouse pointer moves along the horizontal axis first. |
VerticalFirst |
The mouse pointer moves along the vertical axis first. |
Specify the offset parameters OffsetHorizontal and OffsetVertical as described above.
In this example, Tosca right-clicks onto the Option button, with an offset of 10% along the horizontal axis and 10% along the vertical axis:
Defining the click operation, the mouse movement, and the click position |
Use the {JUMPTO} operation
{JUMPTO} allows you to jump to a specific location and perform a click operation.
To do so, use one of the following options:
Syntax: |
{JUMPTO[Action]} {JUMPTO[Action][OffsetHorizontal][OffsetVertical]} |
Specify the parameters Action, OffsetHorizontal, and OffsetVertical as described above.