Win List Items

Tipo: win-list-items · Paquete: Desktop Activities v1.0.8 · Salida: string[]

Devuelve todos los ítems disponibles de un ComboBox o lista. Útil para conocer las opciones antes de elegir, validar que existe la que buscas, o recorrer cada opción.

Cómo funciona

Localiza el control por su selector (esperando hasta timeout). Si es un combo desplegable, lo abre, espera 200 ms a que muestre sus opciones, lee el texto de cada ítem y lo vuelve a cerrar. En una lista normal lee los ítems directamente. En aplicaciones Java las opciones se leen por el puente con Swing.

No cambia la opción seleccionada.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El ComboBox o lista.

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.
`timeout`	`number`	`30000`	Máximo en ms a esperar el control. Vacío = el tiempo de espera de interfaz del proyecto o, si no lo define, 30000.

Salida

Devuelve un string[] (arreglo de textos) con el texto de cada ítem, en el orden en que aparecen. Si el control no tiene ítems, devuelve un arreglo vacío (no es un error). La posición de cada texto en el arreglo (desde 0) es la misma que acepta item en Win Select.

Errores comunes

Mensaje	Causa y solución
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.
`No se pudo localizar el control Java sin ambigüedad, así que no se hizo nada. …`	En una app Java hay varios combos iguales. Agrega un ancla o un `idx` al selector.

Si un combo carga sus opciones despacio al abrirse, el arreglo puede llegar incompleto o vacío: ábrelo antes con Win Click y espera una opción con Win Wait For.

Ejemplo

Comprobar que una opción existe antes de seleccionarla:

Win List Items   selector = (combo "Bodega")   → output: bodegas
If   condition = bodegas.Contains("Principal")
 └─ then:
      Win Select   selector = (combo "Bodega")   item = "Principal"

Recorrer todas las opciones:

Win List Items   selector = (lista "Reportes")   → output: reportes
For Each   items = reportes   itemVariable = reporte
 └─ activities:
      Log   message = "Disponible: " + reporte

Actividades relacionadas

Win Select — seleccionar uno de los ítems.
For Each — recorrer todos los ítems.