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

Получение снимка UI (ui_element.snapshot)

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

Объявление​

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

Параметры​

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

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

Методы снимка​

элемент = снимок:find(селектор)
список_элементов = снимок:find_all(селектор)
состояние, информация = снимок:click(селектор_или_элемент [, параметры ])
состояние, информация = снимок:scroll([ селектор_или_элемент, ] направление [, параметры ])
состояние, информация = снимок:input_text(селектор_или_элемент, текст [, параметры ])
состояние, информация = снимок:set_text(селектор_или_элемент, текст [, параметры ])
состояние, информация = снимок:clear_text(селектор_или_элемент [, параметры ])
состояние, информация = снимок:toggle(селектор_или_элемент [, параметры ])
состояние, информация = снимок:set_checked(селектор_или_элемент, состояние_флажка [, параметры ])
состояние, информация = снимок:set_value(селектор_или_элемент, значение [, параметры ])
состояние, информация = снимок:increase(селектор_или_элемент [, параметры ])
состояние, информация = снимок:decrease(селектор_или_элемент [, параметры ])

Описание​

Снимок — это результат одного чтения состояния UI; он удобен для нескольких поисковых запросов или последовательных действий в одном интерфейсе. После перехода на другой экран, появления диалога, прокрутки или обновления содержимого следует снова вызвать snapshot(). Среди распространённых полей таблицы снимка — elements и count.

Пример​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "搜索",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

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