Win Focus

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

Activa una ventana y la trae al primer plano (al frente de las demás). Útil cuando varias aplicaciones están abiertas y necesitas asegurarte de que el teclado y el mouse van a la ventana correcta.

Cómo funciona

Localiza el elemento por su selector —la ventana, o cualquier control dentro de ella— y activa la ventana que lo contiene: la restaura si estaba minimizada, la trae al frente y espera hasta timeout a que Windows confirme que quedó en primer plano. Si no lo logra, falla.

El mismo timeout se usa para buscar el elemento y para esperar el primer plano.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	La ventana a enfocar (o un control dentro de ella).

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`	`int`	`15000`	Máximo en ms a esperar a que la ventana llegue al frente (y a encontrar el elemento). Vacío = el tiempo de espera de interfaz del proyecto; si no lo define, 15000 para el primer plano y 30000 para la búsqueda.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`No se pudo activar la ventana en … ms.`	Windows no dejó traer la ventana al frente: un diálogo modal de otra aplicación, la ventana se ejecuta como administrador y el robot no, o la sesión está bloqueada. Revisa la máquina con la cuenta del robot.
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.

Ejemplo

Traer al frente la aplicación antes de enviarle un atajo de teclado global:

Win Focus       selector = (ventana "ERP")
Win Key Press   keys = "f5"

Actividades relacionadas

Win Attach — conectarse a la ventana.
Win Key Press — enviar teclas a la ventana activa.