Mouse and Keyboard

Click Relative

Click Relative activity allows you to click any point in an application by reference to specified X and Y coordinates. This activity moves the focus to the place where click is done.

The parameter Offset From allows you to choose the reference point of the control - horizontal and vertical offset will be calculated from that point. Positive numbers increase offset value to the right (X) and to the bottom (Y) while negative numbers to the left (X) and to the top (Y). The offset is measured in pixels.

Fill in the application custom internal name. Drop the control on the activity. Choose click type (generic click relative, generic double click relative, generic right click relative). Choose the reference point of the control from the dropdown (top right, top left, bottom right, bottom feft, center, left edge center, right edge center, bottom edge center, top edge center). Declare the offset values (X offset, Y offset).

To successfully use Click Relative activity be sure your application is on top of your screen (its advised to use Window Activity before using Click Relative). Remember that essential to success is the same position of application on screen (and control's edges as well) during building the scenario and in production environment. Check the screen resolution - it has to be the same during building the scenario and in production environment.

v2_mouse_click-rel-001
v2_mouse_click-rel-002
Parameter NameParameter TypeIn/OutDescription
Alternative Scenario If FailedBooleanInputcheckbox; default is "on"
Application NameStringInputcustom internal name for application in which the action is taken, in order to use in Wizlink
Display NameLiteralInputyou can change the name of activity for greater clarity of the scenario
Exclude from Transaction CheckBooleanInputcheckbox; default is "off"
Offset FromDropdownInputselect the appropriate option from the dropdown list; start point to calculate vertical and horizontal offset
Retry timeout [s]DoubleInputwaiting time until the activity will execute: 1. any negative value means try once, if you fail – set Result to False and finish activity; 2. “0” means try until you get the effect; 3. any positive value is time in seconds in which the activity will persist trying until successful or the time elapses, if failed – set Result to False and finish activity
X OffsetInt32Inputhorizontal offset
Y OffsetInt32Inputvertical offset
ResultBooleanOutputreturns the Boolean value: it will return True if no error is in activity, otherwise it will return False
Result CodeInt32OutputResult Code will return 0 if there is no error in activity, otherwise in most cases it will return 1, the extended result code will show only in several chosen activities

Last updated: 2023, 15 May