Справка Human Emulator ui: get_all_by

Интерфейс

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

get_all_by_property

get_all_by_property($property_name,$property_value,$tree_scope="subtree",$ignore_case=false,$exactly=true); - Получить все элементы с заданным значением свойства

Варианты значений для tree_scope поиск включает:
"element" - сам элемент;
"children" - непосредственные дочерние элементы данного элемента;
"descendants" - потомки и дочерние элементы;
"subtree" - корневой элемент и всех потомков;
"parent" - родительский элемент (не поддерживается);
"ancestors" - родительские элементы (не поддерживается)

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

$property_name – Имя свойства

$property_value – Значение свойства

$tree_scope – Область поиска

$ignore_case – Игнорировать регистр

$exactly – Точное совпадение

После выполнения функции возвращаемое значение будет равно одному из двух :

результат – Найденные элементы

пусто / null – ошибка

Пример использования

<?php
// Scenario: Demonstrates how to find UI elements by a single property

$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 all clickable menu items by exact match
$propertyName = "LocalizedControlType";
$propertyValue = "menu item";
$menuItems = $xheElement->get_all_by_property($propertyName, $propertyValue);

if ($menuItems && $menuItems->count() > 0) {
    echo("Example 1: Found " . $menuItems->count() . " clickable menu items\n");
    foreach($menuItems as $index => $menuItem) {
        $menuItemInfo = $menuItem->get_info();
        echo("Menu item #$index: " . $menuItemInfo->Name . "\n");
    }
} else {
    echo("Example 1: No clickable menu items found\n");
}

// Example 2: Get all elements by partial match
$propertyName2 = "LocalizedControlType";
$propertyValue2 = "element";
$exactly = false;
$allElements = $xheElement->get_all_by_property($propertyName2, $propertyValue2, $exactly);

if ($allElements && $allElements->count() > 0) {
    echo("\nExample 2: Found " . $allElements->count() . " elements with partial match\n");
    foreach($allElements as $index => $element) {
        $elementInfo = $element->get_info();
        echo("Element #$index: " . $elementInfo->Name . "\n");
    }
} else {
    echo("\nExample 2: No elements found with partial match\n");
}

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

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:3039"
from xweb_human_emulator import *

# начало
echo("<hr><font color=blue>ui.xxxxxxxxx</font><hr>")

# 1 
echo("1. Щелкнем меню файл : ");
xhe=window.get_by_text("localhost").get_ui_element();
mfile=xhe.get_by_property("Name","Файл");
echo(mfile.invoke());
mprint=mfile.get_by_property("Name","Печать");
echo(mprint.invoke());

# конец
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. Получим имена всех доступных для щелчка меню: ");
			var xhe=window.get_by_text("localhost").get_ui_element();
			var menus=xhe.get_all_by_property("LocalizedControlType","элемент меню");
			for (int i=0;i<menus.get_count();i++)
				echo(menus.get(i).get_info().GetValue("Name").ToString()+"\n");

			// конец
			echo("\n\n");

			app.quit();            
	  }
}

// подключим функциональные объекты, если еще не подключен
xhe_host="127.0.0.1:7010";
echo=require("../../../Templates JS/init.js");

// начало
echo("<hr><font color=blue>ui.xxx</font><hr>");

// 1 
echo("1. Щелкнем меню файл : ");
var xhe=window.get_by_text("localhost").get_ui_element();
var mfile=xhe.get_by_property("Name","Файл");
echo(mfile.invoke());
var mprint=mfile.get_by_property("Name","Печать");
echo(mprint.invoke());

// конец
echo("\n");

// уведомляем среду что скрипт закончил работать
echo(app.quit());

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

Интерфейс

get_all_by_property

Функционал