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

Описание

Блок выполняет поиск связанных UI-элементов десктопного приложения и возвращает список найденных объектов.

Примечание

Блок может искать родительский элемент, дочерние элементы или возвращать текущий выбранный элемент в зависимости от выбранного режима.

---

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

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

1. Иерархия элементов - определяет, какие элементы требуется получить: родительский, дочерние или текущий элемент.

   Тип данных: dropdown (Список)

   Пример: Дочерние элементы

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

   Тип данных: checkbox (Чекбокс)

   Пример: ✔

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

   Тип данных: object (Объект элемента) | str (Строка)

   Пример: [{"ControlTypeName":"ButtonControl","Name":"5"}]

   

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

   

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

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

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

Тип данных: list (Список)

Пример: [<element_1>, <element_2>]

Блок возвращает список объектов найденных UI-элементов в виде:

[
    <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.

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

  

---

Результат

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