humanemulator.net — справка. Продукт, демо и покупка — на хуманэмулятор.рф | Демо | Купить | API | Changelog

get_window_interface

get_window_interface($find_in_parents=false); - Получить интерфейс окна если есть

Функция на вход принимает параметры:

  • $find_in_parents – Искать первый родительский элемент, который поддерживает NativeWindowHandle

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • число (Интерфейс окна)
  • -1 – ошибка

    Пример использования
    <?php
    // Scenario: Demonstrates how to get the window interface from 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();
    
    // Example 1: Get window interface and its text
    $windowInterface = $xheElement->get_window_interface();
    
    if ($windowInterface) {
        $windowText = $windowInterface->get_text();
        echo("Example 1: Successfully retrieved window interface\n");
        echo("Window text: '" . $windowText . "'\n");
    } else {
        echo("Example 1: Failed to retrieve window interface\n");
    }
    
    // Example 2: Get window interface from a nested UI element
    // Step: Navigate to a nested element (zoom pane in status bar)
    $childElement = $xheElement->get_child(0);
    $nextElement = $childElement->get_next(1);
    $zoomPane = $nextElement->get_child(0)->get_next();
    
    // Step: Check if this UI element has a direct window
    $zoomPaneWindowInfo = $zoomPane->get_window_info();
    $zoomPaneInfo = $zoomPane->get_info();
    echo("Zoom pane name: '" . $zoomPaneInfo->Name . "'\n");
    
    // Example 3: Get window interface that contains this UI element
    $containingWindow = $zoomPane->get_window_interface(true);
    
    if ($containingWindow) {
        $windowClassName = $containingWindow->get_class_name();
        echo("Example 3: Successfully retrieved containing window interface\n");
        echo("Containing window class name: '" . $windowClassName . "'\n");
    } else {
        echo("Example 3: Failed to retrieve containing window interface\n");
    }
    
    // Quit the application
    WINDOW::$app->quit();
    ?>
    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
    
    xhe_host = "127.0.0.1:7025"
    from xweb_human_emulator import *
    
    # начало
    echo("<hr><font color=blue>ui.xxxxxxxxx</font><hr>")
    
    # 1 
    echo("1. Получим window interface по UI элементу и его текст: ");
    xhe=window.get_by_text("localhost").get_ui_element();
    echo(xhe.get_window_interface().get_text());
    
    # 2
    xhe=window.get_by_text("localhost").get_ui_element();
    # панель в строке статуса
    zoom_pane = xhe.get_child(0).get_next(1).get_child(0).get_next();
    # убедимся что нет окна у этого UI
    echo(zoom_pane.get_window_info());
    # выведем имя UI
    echo(zoom_pane.get_info());
    echo("\n2. Получим window interface окна, содержащего этот UI элементу и его класс: ");
    echo(zoom_pane.get_window_interface(true).get_class_name());
    
    # конец
    echo("<hr><br>")
    
    # уведомляем среду что скрипт закончил работать
    echo(app.quit())
    #region using
    
    using System;
    using System.Diagnostics;
    using System.Collections.Generic;
    using System.Linq;
    using System.IO;
    using System.Text;
    using System.Threading;
    
    using XHE;
    using XHE.XHE_DOM;
    using XHE.XHE_System;
    using XHE.XHE_Window;
    using XHE.XHE_Web;
    
    #endregion
    
     class Program:XHEScript
     {
    	  static void Main(string[] args)
    	  {
    			// init XHE
    			server = Environment.GetEnvironmentVariable("RPABOT_HOST_URL");
    			InitXHE();
    
    			// начало
    			echo("<hr><font color=blue>windowinterface.set_text</font><hr>");
    				
    			// 1 
    			echo("1. Получим window interface по UI элементу и его текст: ");
    			var xhe=window.get_by_text("localhost").get_ui_element();
    			echo(xhe.get_window_interface().get_text());
    
    			// 2			
    			// панель в строке статуса
    			var zoom_pane = xhe.get_child(0).get_next(1).get_child(0).get_next();
    			// убедимся что нет окна у этого UI
    			echo(zoom_pane.get_window_info());
    			// выведем имя UI
    			echo(" "+zoom_pane.get_info());
    			echo("\n2. Получим window interface окна, содержащего этот UI элементу и его класс: ");
    			echo(zoom_pane.get_window_interface(true).get_class_name());
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    // подключим функциональные объекты, если еще не подключен
    xhe_host="127.0.0.1:7025";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>ui.xxx</font><hr>");
    
    // 1 
    echo("1. Получим window interface по UI элементу и его текст: ");
    var xhe=window.get_by_text("localhost").get_ui_element();
    echo(xhe.get_window_interface().get_text());
    
    // 2
    var xhe=window.get_by_text("localhost").get_ui_element();
    // панель в строке статуса
    var zoom_pane = xhe.get_child(0).get_next(1).get_child(0).get_next();
    // убедимся что нет окна у этого UI
    echo(zoom_pane.get_window_info());
    // выведем имя UI
    echo(" "+zoom_pane.get_info().Name);
    echo("\n2. Получим window interface окна, содержащего этот UI элементу и его класс: ");
    echo(zoom_pane.get_window_interface(true).get_class_name());
    
    // конец
    echo("\n");
    
    // уведомляем среду что скрипт закончил работать
    echo(app.quit());

    =============================================
    ui    Объекты    DOM  System  Vision  Web  Window        
    =============================================
    если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум
    .