Pular para o conteúdo principal

Obter um instantâneo da UI (ui_element.snapshot)

Esta função está disponível somente a partir da versão 20260507.

Declaração​

instantaneo, mensagem_de_erro = ui_element.snapshot([ opcoes ])

Parâmetros​

Valores retornados​

  • instantaneo Tabela que contém a lista de elementos de UI atual e os métodos do instantâneo. nil em caso de falha.
  • mensagem_de_erro Texto; motivo da falha.

Métodos do instantâneo​

elemento = instantaneo:find(seletor)
elementos = instantaneo:find_all(seletor)
estado, informacoes = instantaneo:click(seletor_ou_elemento [, opcoes])
estado, informacoes = instantaneo:scroll([ seletor_ou_elemento, ] direcao [, opcoes])
estado, informacoes = instantaneo:input_text(seletor_ou_elemento, texto [, opcoes])
estado, informacoes = instantaneo:set_text(seletor_ou_elemento, texto [, opcoes])
estado, informacoes = instantaneo:clear_text(seletor_ou_elemento [, opcoes])
estado, informacoes = instantaneo:toggle(seletor_ou_elemento [, opcoes])
estado, informacoes = instantaneo:set_checked(seletor_ou_elemento, estado_de_selecao [, opcoes])
estado, informacoes = instantaneo:set_value(seletor_ou_elemento, valor [, opcoes])
estado, informacoes = instantaneo:increase(seletor_ou_elemento [, opcoes])
estado, informacoes = instantaneo:decrease(seletor_ou_elemento [, opcoes])

Descrição​

O instantâneo é um resultado pontual, adequado para várias localizações ou operações consecutivas na mesma interface. Depois de uma navegação, janela pop-up, rolagem ou atualização de conteúdo, chame snapshot() novamente. Os campos comuns da tabela do instantâneo incluem elements e count.

Exemplo​

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

Observação: o código acima usa a função sys.toast, que não pertence a este capítulo.