Saltar al contenido principal

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")