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(); ?>