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 operations

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:

Possible click operations for the parameter Action

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:

Possible 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.