Win Check

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

Marca o desmarca una casilla de verificación (checkbox) de una aplicación de escritorio. Garantiza el estado final que quieres, sin depender de cómo estaba antes.

Cómo funciona

Localiza el control por su selector, trae su ventana al frente, lee su estado actual y solo lo cambia si hace falta:

checked: lo deja marcado (si ya lo estaba, no hace nada).
unchecked: lo deja desmarcado.
toggle: invierte el estado actual.

Por eso es idempotente: repetirla con checked o unchecked no cambia el resultado. Usa el patrón Toggle de UIA; en aplicaciones Java lee el estado por el puente con Swing y, si hay que cambiarlo, hace un clic físico sobre la casilla.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	La casilla.

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.
`state`	`string`	`checked`	Estado deseado: `checked` · `unchecked` · `toggle` (invierte).
`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
`El elemento no admite el patrón Toggle.`	El control no es una casilla para UI Automation. Los botones de opción (radio) estándar de Windows suelen estar en este caso: selecciónalos con Win Click.
`El elemento está fuera del área visible y no se pudo desplazar hasta él, …`	La casilla está oculta por el desplazamiento de su contenedor. Agrega un Win Scroll antes.
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.

Ejemplo

Win Check   selector = (casilla "Acepto términos")                    // marcar
Win Check   selector = (casilla "Recibir correos")   state = unchecked  // desmarcar

Marcar solo cuando un dato lo pide, y comprobarlo:

If   condition = exento
 └─ then:
      Win Check   selector = (casilla "Exento de impuesto")
Win Get Attribute   selector = (casilla "Exento de impuesto")   attribute = checked   → output: marcada

Actividades relacionadas

Win Click — para botones de opción y controles que no son casillas.
Win Get Attribute — leer el estado con checked.