• EN
    RU

ui/get_by_property

get_by_property($property_name, $property_value, $tree_scope="subtree", $ignore_case=false)

Данная команда используется для получения UI интерфейса окна, находя его по заданному значению одного из его свойств.

Команда на вход принимает параметры:
  • property_name – имя свойства;
  • property_value – значение свойства;
  • tree_scope – область поиска:
    • "none" – область исключает поддерево из поиска;
    • "element" – область включает сам элемент;
    • "children" – область включает дочерние элементы элемента;
    • "descendants" – область включает дочерние элементы и более отдалённых потомков элемента;
    • "subtree" – область включает элемент и все его потомки, этот флаг представляет собой комбинацию значений element и descendants (является значением по умолчанию);
    • "parent" – область включает родителя элемента;
    • "ancestors" – область включает родителя и более отдаленных предков элемента;
  • ignore_case – игнорировать ли регистр.

После отработки команда возвращает результат своей работы в робот:
  • XHEUI - интерфейс - интерфейс по значению свойства;
  • false (boolean) - в случае неудачи.





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

<?php $xhe_host = "127.0.0.1:3039";
 
// подключим объект для управления RPAbot, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>windowinterface->".basename (__FILE__)."</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>";
 
// Quit
$app->quit();
?>