Win Click

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

Hace clic en un control de una aplicación de escritorio: un botón, un ítem de menú, una pestaña, una celda. Es la actividad de interacción más común en escritorio.

Cómo funciona

Localiza el control por su selector (esperando hasta timeout), trae su ventana al frente y, si el control está fuera del área visible, intenta desplazarlo a la vista. Luego hace el clic según clickType (ver métodos de interacción):

invoke (por defecto), cuando el control es un botón: lo activa sin mover el mouse. Los botones nativos de Windows (Win32, WinForms) reciben el clic en cola, así que un botón que abre un diálogo modal (“¿Está seguro?”) no bloquea la actividad; el siguiente paso puede actuar sobre ese diálogo. En otros botones usa el patrón Invoke de UIA y, si la acción tarda más de 3 s (un diálogo abierto), sigue sin esperarla. En este modo el botón se activa siempre con clic normal, aunque button diga otra cosa.
invoke en controles que no son botones, o mouse: hace un clic físico con el mouse en el centro actual del control, con el botón indicado en button.
En aplicaciones Java el clic siempre es físico, en la posición real del control que localiza el puente con Swing.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	El elemento al que hacer clic.

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.
`button`	`string`	`left`	Botón: `left` · `right` · `double` (doble clic).
`clickType`	`string`	`invoke`	Método: `invoke` (activa los botones sin mover el mouse) · `mouse` (clic físico).
`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 {…}.` seguido de `Diagnóstico: …`	El control no apareció en `timeout`. Espera antes con Win Wait For o revisa el selector. Ver errores comunes.
`El elemento está fuera del área visible y no se pudo desplazar hasta él, …`	El control está oculto por el desplazamiento de su contenedor y no se pudo traer a la vista; el clic habría caído en otro sitio. Agrega un Win Scroll antes.
`No se pudo localizar el control Java sin ambigüedad, así que no se hizo nada. …`	En una app Java hay varios controles iguales o el puente no lo ve. Agrega un ancla o un `idx` al selector.
`No se pudieron llevar a la pantalla las coordenadas del control Java …`	Pantalla escalada (125 %, 150 %) y no se pudo medir la ventana Java. Prueba con la escala al 100 % en la máquina del robot.

Ejemplo

Win Click   selector = (botón "Guardar")
Win Click   selector = (fila "Factura 001")   button = double   clickType = mouse
Win Click   selector = (archivo "reporte.xlsx")   button = right   clickType = mouse    // menú contextual

Un botón que abre una confirmación, y el clic en el diálogo:

Win Click      selector = (botón "Eliminar")
Win Wait For   selector = (botón "Sí")   state = visible
Win Click      selector = (botón "Sí")

Actividades relacionadas

Win Type — escribir en un campo.
Win Wait For — esperar a que el control esté listo.
Win Check — para casillas, sin depender de su estado previo.