Saltar al contenido principal

Obtener una instantánea de la UI (ui_element.snapshot)

Esta función solo está disponible a partir de las versiones posteriores a 20260507

Declaración​

instantánea, información_de_error = ui_element.snapshot([ opciones ])

Parámetros​

Valor devuelto​

  • instantánea Tipo tabla: contiene la lista de elementos UI actual y métodos de instantánea. Es nil cuando falla.
  • información de error Tipo texto: causa del error.

Métodos de la instantánea​

elemento = instantánea:find(selector)
lista_de_elementos = instantánea:find_all(selector)
estado, información = instantánea:click(selector_o_elemento [, opciones ])
estado, información = instantánea:scroll([ selector_o_elemento, ] dirección [, opciones ])
estado, información = instantánea:input_text(selector_o_elemento, texto [, opciones ])
estado, información = instantánea:set_text(selector_o_elemento, texto [, opciones ])
estado, información = instantánea:clear_text(selector_o_elemento [, opciones ])
estado, información = instantánea:toggle(selector_o_elemento [, opciones ])
estado, información = instantánea:set_checked(selector_o_elemento, estado_de_selección [, opciones ])
estado, información = instantánea:set_value(selector_o_elemento, valor [, opciones ])
estado, información = instantánea:increase(selector_o_elemento [, opciones ])
estado, información = instantánea:decrease(selector_o_elemento [, opciones ])

Descripción​

Una instantánea es un resultado de un solo momento, adecuado para buscar varias veces o ejecutar operaciones consecutivas dentro de la misma interfaz. Después de navegar a otra interfaz, abrir un cuadro de diálogo, desplazarse o actualizarse el contenido, se debe volver a llamar a snapshot(). Los campos habituales de una tabla de instantánea incluyen elements y count.

Ejemplo​

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

Nota: el código anterior usa la función de fuera de este capítulo sys.toast