Obtener la lista de elementos de texto (ui_element.list_text_elements)

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

Declaración

lista_de_elementos, información_de_error = ui_element.list_text_elements([ pid_o_opciones ])

Parámetros

• pid_o_opciones Parámetro opcional, de tipo entero o tabla. El tipo entero indica el PID de la aplicación objetivo; el tipo tabla consulta la descripción de las opciones comunes.

Valor devuelto

• lista_de_elementos Tipo tabla: array de elementos UI. Es nil cuando falla.
• información de error Tipo texto: causa del error.

Descripción

Obtiene la lista de elementos de texto de la aplicación objetivo actual. Las unidades de los campos de coordenadas de los elementos devueltos son píxeles físicos. Esta interfaz se conserva para compatibilidad con scripts antiguos y su estrategia de consulta predeterminada es más conservadora; para localizar elementos en scripts nuevos, se recomienda considerar find o snapshot.

Ejemplo

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

Nota: el código anterior usa las funciones de fuera de este capítulo nLog y sys.toast