LeftMouseClick
void LeftMouseClick(String control)void LeftMouseClick(String control, float x, float y)
Description
Simulates a left mouse button click on the specified control.
The function locates the given UI control (identified by its control name) and performs a click action at its position.
This is typically used to automate user interaction with buttons, menus, or other controls in the application under test.
Optionally, relative coordinates x and y (values between 0.0 and 1.0) can be provided to click at a specific position within the control's bounding rectangle.
If omitted, the click is performed at the center of the control.
Parameter
- control - The identifier or name of the control to be clicked.
- x (optional) - Relative horizontal position within the control (0.0 = left, 1.0 = right). Default: 0.5 (center).
- y (optional) - Relative vertical position within the control (0.0 = top, 1.0 = bottom). Default: 0.5 (center).
Example
void main()
{
LeftMouseClick("BTN_LOGIN"); // Clicks the center of the login button
LeftMouseClick("CANVAS", 0.25, 0.75); // Clicks at 25% from left, 75% from top
}