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

Получение UI-элемента по координатам (ui_element.text_element_at_position)

Эта функция доступна в версиях после 20260507.

Объявление​

элемент, сообщение_об_ошибке = ui_element.text_element_at_position(абсцисса, ордината [, номер_процесса_или_параметры ])

Параметры​

  • абсцисса, ордината Целые числа — координаты на экране в физических пикселях.
  • номер процесса или параметры Необязательный целочисленный или табличный параметр. Целое число означает PID целевого приложения; для таблицы см. описание общих параметров.

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

  • элемент Таблица с UI-элементом, найденным в указанных координатах. При ошибке возвращается nil.
  • сообщение об ошибке Строка с причиной ошибки.

Описание​

Интерфейс удобен для обратного поиска UI-элемента по известной точке, например чтобы определить соседний элемент по результату распознавания изображения или OCR. Это не интерфейс нажатия по координатам; для нажатия в фиксированной точке используйте touch.tap. Операция может завершиться ошибкой, если в точке находится пустое место или целевой интерфейс не предоставляет читаемых элементов.

Пример​

local ui_element = require("ui_element")

local item, err = ui_element.text_element_at_position(300, 500, {
    include_hit_state = true,
    max_level = 1,
})

if item then
    nLog(item.text or item.value or "")
else
    sys.toast(err)
end

Примечание: в приведённом коде используются функции из других глав — nLog и sys.toast.