Перейти к основному содержимому

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

Модуль доступен в версиях после 20260507.

Несколько интерфейсов ui_element принимают таблицу параметров для задания целевого App, количества результатов, глубины рекурсии, проверки попадания и шага прокрутки.

Параметры поиска​

local options = {
pid = app.front_pid(),
max_level = 2,
max_elements = 200,
include_hit_state = true,
}
  • pid
    Целое число, идентификатор процесса целевого App. Если не задан, обычно используется App на переднем плане.
  • max_level
    Целое число, глубина рекурсии дочерних элементов. Обычно 1 или 2 регулирует объём возвращаемых данных.
  • max_elements
    Целое число, максимальное число возвращаемых элементов верхнего уровня.
  • fallback_children
    Логическое значение, пробовать ли читать дочерние элементы при пустом обычном списке. Значение по умолчанию зависит от интерфейса.
  • include_hit_state
    Логическое значение, добавлять ли поля состояния попадания.
  • hit_test
    Логическое значение, включать ли попадание по выборке экрана. Обычным скриптам обычно не требуется.
  • fallback_hit_test
    Логическое значение, пробовать ли попадание по выборке экрана при пустом обычном списке.
  • hit_test_spacing
    Число, интервал выборки экрана в логических координатах. По умолчанию 40.

Параметры исключения атрибутов​

Доступны начиная с версии 20261115. Только для snapshot() и list_text_elements(). Все параметры логические, по умолчанию равны false и также действуют на дочерние элементы. Если эти состояния не нужны, включение параметров исключения может снизить затраты на запросы и ускорить получение снимка UI.

  • exclude_visibility
    При true пропускает запросы видимости и не возвращает isVisible.
  • exclude_map
    При true пропускает проверку атрибута карты и не возвращает isMap; сами элементы карты сохраняются.
  • exclude_hit_state
    При true пропускает проверку попадания в центральную точку и не возвращает canHit, hitVerified, hitTestPoint и hitTestPointLogical. Нельзя сочетать с include_hit_state = true.

Состав элементов, текст, координаты и правила дополнительного поиска элементов через hit_test / fallback_hit_test не меняются. Не исключайте поле состояния, если оно нужно для фильтрации.

Параметры действий​

  • point
    Таблица, точка координат для прокрутки или попадания, например { x = 200, y = 700 }, в физических пикселях.
  • x / y
    Целое число, эквивалентно point, можно указать непосредственно в таблице параметров.
  • steps
    Число, шаг прокрутки, увеличения или уменьшения. Эффект зависит от целевого элемента.

Описание​

list_text_elements() по умолчанию работает осторожнее для совместимости со старыми скриптами. find(), find_all(), snapshot() и интерфейсы действий больше подходят для прямого использования в новых скриптах. hit_test может вернуть элементы, более близкие к текущему верхнему уровню интерфейса, но требует больше ресурсов; используйте его только если обычный поиск не находит элементы.