Поиск элементов

Описание

Блок позволяет выполнить поиск UI-элементов десктопного приложения.

---

Описание параметров

Блок имеет несколько основных параметров:

1. Иерархия элементов;

   Блок позволяет получить:

   • Родительский элемент;
   • Дочерние элементы;
   • Объект текущего выбранного элемента.
   

2. Фокус на элементе - активация элемента на передний план перед выполнением действия;

   Тип данных: чекбокс

   Пример: True

3. Использовать объект элемента - при активации функция позволяет указать объект элемента или JSON-строку;

   Тип данных: объект элемента | строка

   Пример: [{"ControlTypeName":"WindowControl","Name":"Калькулятор"}]

   При использовании объекта элемента в разъём подключается блок вернуть значение переменной с объектом выбранного элемента.

   

   JSON-строка указывается с помощью блока создать строку.

   

---

Для выбора элемента можно использовать Master UI для десктопных приложений или выбрать элемент из выпадающего списка, если он уже был предварительно получен через Master UI.

Master UI для десктопных приложений Мастер UI для работы с десктопными приложениями - встроенный инструмент Puzzle RPA, который позволяет извлекать свойства элементов десктопных приложений. Подробнее...

---

Возвращаемое значение

Блок возвращает результат в виде списка объектов элементов:

[
    <uiautomation.uiautomation.ListItemControl object at 0x000001E85246C3D0>,
    <uiautomation.uiautomation.ListItemControl object at 0x000001E852557590>
]

---

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

Пример 1

В данном примере открывается приложение Калькулятор и выполняется поиск всех дочерних элементов кнопки “5”. Затем выполняется считывание свойства class_name каждого найденного элемента.

Для выбора элемента в блоке Поиск элементов используется инструмент Master UI для десктопных приложений. Для этого:

1. Открывается инструмент Master UI для десктопных приложений;
2. Выполняется выбор элемента, соответствующий кнопке 5 в приложение калькулятор.

---

Алгоритм состоит из блоков:

• Открыть приложение calc.exe;

• Поиск дочерних элементов;

• Цикл по найденным элементам - в переменную element записываются по порядку и обрабатываются внутри цикла значения (объекты элементов) из списка элементов elements;

• Внутри цикла: Считывание свойства class_name каждого дочернего элемента и вывод результата на экран.

  Заметка

  Блок Поиск элементов возвращает результат в виде списка объектов элементов. Цикл по найденным элементам позволяет получить каждый отдельный объект UI-элемента в переменной element.

  Для использования получаемого объекта в блоках для автоматизации Десктопных приложений необходимо активировать в блоке функцию Использовать объект элемента и указать переменную с полученным объектом.

  

---

Результат

Вывод результата на экран:

Пример 2

В данном примере открывается приложение Калькулятор и выполняется поиск всех дочерних элементов кнопки “5”. Затем выполняется считывание свойства class_name каждого найденного элемента.

В качестве выбранного элемента в блоке Поиск элементов используется JSON-строка. Для этого:

1. Открывается инструмент Master UI для десктопных приложений;
2. Выполняется выбор элемента, соответствующий кнопке 5 в приложение калькулятор;
3. JSON-строка выбранного элемента копируется из интерфейса Master UI.

---

Алгоритм состоит из блоков:

• Открыть приложение calc.exe;

• Поиск дочерних элементов;

• Цикл по найденным элементам - в переменную element записываются по порядку и обрабатываются внутри цикла значения (объекты элементов) из списка элементов elements;

• Внутри цикла: Считывание свойства class_name каждого дочернего элемента и вывод результата на экран.

  Заметка

  Блок Поиск элементов возвращает результат в виде списка объектов элементов. Цикл по найденным элементам позволяет получить каждый отдельный объект UI-элемента в переменной element.

  Для использования получаемого объекта в блоках для автоматизации Десктопных приложений необходимо активировать в блоке функцию Использовать объект элемента и указать переменную с полученным объектом.

  

---

Результат

Вывод результата на экран: