Desplazar un elemento UI o la página actual (ui_element.scroll)

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

Declaración

estado, información o información_de_error = ui_element.scroll(dirección [, opciones ])
estado, información o información_de_error = ui_element.scroll(selector_o_elemento, dirección [, opciones ])

Parámetros

• selector_o_elemento Parámetro opcional, tipo tabla; puede ser un selector, un elemento devuelto por una consulta o una tabla de coordenadas { x = coordenada_x, y = coordenada_y }.
• dirección Tipo texto: admite "down", "up", "left", "right", "top" y "bottom".
• opciones Parámetro opcional, tipo tabla. Se pueden usar point, x y y para especificar el punto de impacto, y steps para especificar el parámetro de pasos.

Valor devuelto

• estado Tipo booleano: true cuando tiene éxito y nil cuando falla.
• información o información de error Tipo tabla de información de acción cuando tiene éxito; tipo texto con la causa del error cuando falla.

Descripción

Si no se pasa un selector, se intenta desplazar la página actual de forma predeterminada. Si se pasa un selector, se intenta desplazar la región desplazable donde se encuentra el elemento objetivo. Si se necesita determinar que se han desplazado varias páginas, se recomienda llamar en bucle desde el script Lua y comprobar por cuenta propia los cambios de la página.

Ejemplo

local ui_element = require("ui_element")

ui_element.scroll("down", {
    point = { x = 200, y = 700 },
})

ui_element.scroll({
    text_contains = "列表",
}, "up")