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

Получение списка текстовых элементов (ui_element.list_text_elements)

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

Объявление​

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

Параметры​

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

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

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

Описание​

Возвращает список текстовых элементов текущего целевого приложения. Координаты в возвращённых элементах указаны в физических пикселях. Интерфейс сохранён для совместимости со старыми скриптами и по умолчанию использует осторожную стратегию поиска; в новых скриптах для поиска элементов предпочтительнее find или snapshot.

Пример​

local ui_element = require("ui_element")

local list, err = ui_element.list_text_elements({
    max_level = 1,
    include_hit_state = true,
})

if list then
    for _, item in ipairs(list) do
        if item.text then
            nLog(item.text)
        end
    end
else
    sys.toast(err)
end

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