humanemulator.net . , . | | | API |

get_all_by_properties

get_all_by_properties($properties,$tree_scope="subtree",$ignore_case=false); - Получить все элементы с заданными значениями нескольких свойств

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

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

  • $properties – Массив свойств
  • $tree_scope – Область поиска
  • $ignore_case – Игнорировать регистр

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • результат – Найденные элементы
  • пусто / null – ошибка

    Пример использования
    <?php
// Scenario: Demonstrates how to find UI elements by multiple properties

$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: Find elements by multiple properties
$properties = array("Name" => "Quick Start", "IsSelectionItemPatternAvailable" => "true");
$foundElements = $xheElement->get_all_by_properties($properties);

if ($foundElements && $foundElements->count() > 0) {
    echo("Example 1: Found " . $foundElements->count() . " elements matching the properties\n");
    foreach($foundElements as $index => $element) {
        $elementInfo = $element->get_info();
        echo("Element #$index: " . $elementInfo->Name . "\n");
    }
} else {
    echo("Example 1: No elements found matching the specified properties\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();
properties = { "Name" : "Быстрый Старт" , "IsSelectionItemPatternAvailable" : "true" }
qstart=xhe.get_all_by_properties(properties);
echo(qstart.get_info());

# конец
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 properties = new Dictionary<string,string>();
			properties["Name"] = "Быстрый Старт";
			properties["IsSelectionItemPatternAvailable"] = "true";

			var qstart=xhe.get_all_by_properties(properties);
			echo(qstart.get_info()[0].ToString());

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

			app.quit();            
	  }
}
    // подключим функциональные объекты, если еще не подключен
xhe_host="127.0.0.1:3039";
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();
properties = { "Name" : "Быстрый Старт" , "IsSelectionItemPatternAvailable" : "true" }
qstart=xhe.get_all_by_properties(properties);
console.log(qstart.get_info());

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

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

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