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 - в случае неудачи
Пример использования (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();
?>