Win Scroll

Tipo: win-scroll · Paquete: Desktop Activities v1.0.8

Desplaza (hace scroll) un elemento con barra de desplazamiento —una lista larga, una grilla, un panel— en la dirección indicada. Útil para llevar a la vista un ítem o una fila que está fuera del área visible antes de interactuar con ella.

Cómo funciona

Localiza el elemento desplazable por su selector, trae su ventana al frente y lo desplaza amount pasos en la direction indicada:

Si el control admite el patrón Scroll de UIA, cada paso mueve el 10 % del recorrido total (sin pasar del principio ni del final). Si el control no se puede desplazar en esa dirección, no hace nada.
Si no lo admite, pone el mouse en el centro del control y gira la rueda del mouse un paso por cada amount (rueda horizontal para left/right).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El elemento desplazable (la lista, la grilla o el panel, no un ítem de dentro).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanDesktopSession`	—	Sesión de Win Attach. Dentro de un `body` se toma sola; sin sesión, el selector debe incluir la ventana.
`direction`	`string`	`down`	Dirección: `down` · `up` · `right` · `left`.
`amount`	`int`	`3`	Número de pasos de desplazamiento, de 1 a 20 (los valores fuera de ese rango se ajustan al límite).
`timeout`	`number`	`30000`	Máximo en ms a esperar el elemento. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.

Si el contenido no se mueve, comprueba que el selector apunte al contenedor con barra de desplazamiento y no a un elemento de dentro.

Ejemplo

Win Scroll   selector = (lista "Resultados")   direction = down   amount = 5
Win Click    selector = (ítem "Pedido 1042")

Actividades relacionadas

Win Extract Table — para grillas, extrae los datos sin desplazar a mano.
Win Wait For — esperar a que aparezca un elemento tras desplazar.