send_mouse_left_down

<?php
// Scenario: Demonstrates how to send mouse left button down event to a UI element

$xhe_host = getenv("RPABOT_HOST_URL");
if (!isset($path)){
    // Path to the init.php file for connecting to the XHE API
    $path = "../../../Templates/init.php";
    // Including init.php grants access to all classes and functionality for working with the XHE API
    require($path);
}

// Step: Get UI element for interaction
$windowText = "localhost";
$xheElement = WINDOW::$window->get_by_text($windowText)->get_ui_element();

// Step: Find a specific element to click (Quick Start button)
$propertyName = "Name";
$propertyValue = "Quick Start";
$quickStartElement = $xheElement->get_by_property($propertyName, $propertyValue);

if ($quickStartElement && $quickStartElement->is_exist()) {
    // Example 1: Send mouse left button down event with offset
    $offsetX = 2;
    $offsetY = 2;
    $result1 = $quickStartElement->send_mouse_left_down($offsetX, $offsetY);
    
    if ($result1) {
        echo("Example 1: Successfully sent mouse left button down at offset ($offsetX, $offsetY)\n");
    } else {
        echo("Example 1: Failed to send mouse left button down\n");
    }
    
    // Step: Wait a moment
    sleep(1);
    
    // Example 2: Send mouse left button up event
    $result2 = $quickStartElement->send_mouse_left_up($offsetX, $offsetY);
    
    if ($result2) {
        echo("Example 2: Successfully sent mouse left button up at offset ($offsetX, $offsetY)\n");
    } else {
        echo("Example 2: Failed to send mouse left button up\n");
    }
} else {
    echo("Example 1: Quick Start element not found\n");
}

// Quit the application
WINDOW::$app->quit();
?>