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

Модуль доступен в версиях после 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.

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

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

Описание

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