Перейти к содержимому
Puzzle RPA

Прочитать свойство элемента

image_1

Описание

Блок извлекает значение указанного свойства UI-элемента десктопного приложения.

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

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

  1. Извлекаемое свойство - извлекаемое свойство UI-элемента десктопного приложения; В выпадающем списке можно выбрать одно из свойств:

    • Name — имя элемента. Обычно отображается пользователю (например, текст на кнопке);
    • ControlType — тип элемента управления;
    • ClassName — класс UI-элемента;
    • AutomationId — уникальный идентификатор;
    • Активен (isEnabled) — указывает, активен ли элемент сейчас;
    • Видимый (IsOffscreen) — определяет, отображается ли элемент на экране;
    • FrameworkIdProperty — название фреймворка, с помощью которого реализован элемент (например, Win32, WPF, WinForms, XAML и т.п.);
    • NativeWindowHandleProperty — дескриптор окна (HWND) — уникальный идентификатор окна в Windows;
    • Координаты вершин (BoundingRectangle) — координаты углов элемента на экране;
    • Центр элемента — координаты центра элемента;
    • Родитель элемента — объект родительского элемента;
    • Дочерние элементы — объекты дочерних элементов;
    • Размеры элемента — размер элемента на экране;
    • IsKeyboardFocusable — имеет ли элемент в данный момент фокус;
    • HasKeyboardFocus — можно ли на элемент установить фокус;
    • IsDialog — является ли элемент диалоговым окном;
    • IsSelected — выбран ли элемент;
    • IsOffscreenProperty — находится ли элемент вне видимой области экрана (например, прокручен вверх/вниз);
    • IsPassword — является ли элемент полем пароля (т.е. его содержимое скрыто);
    • HelpText — вспомогательный текст, подсказка или описание (может быть отображено при наведении);
    • LegacyIaccessibleRole — роль элемента;
    • IsSelectionPattern — поддерживает ли элемент паттерн выбора (Selection Pattern);
    • ExpandCollapseProperty — свойство раскрытия/сворачивания элемента;
    • DefaultAction — действие по умолчанию при взаимодействии с элементом (например, “нажать”, “выбрать”, “открыть”).
    image_2

    Для извлечения набора свойств их наименования должны быть переданы в виде списка:

    image_10

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

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

    Пример: True

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

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

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

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

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

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

    image_4

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

При выборе одного свойства блок возвращает его значение:

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

Пример: Puzzle RPA

При выборе нескольких свойств результатом будет словарь: ключ — имя свойства, значение — его содержимое:

Тип данных: dict (Словарь)

Пример: {'Name': 'Puzzle RPA', 'ControlType': 'PaneControl', 'AutomationId': '1'}

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

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

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

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

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

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

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

  • Открыть приложение calc.exe;
  • Прочитать свойство элемента;
  • Уведомление пользователя с результатом прочитанного свойства. image_6

Результат

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

image_7