Win Key Press

Tipo: win-key-press · Paquete: Desktop Activities v1.0.8

Envía una tecla, una combinación o una secuencia de combinaciones a la aplicación: atajos como ctrl+s (guardar), alt+f4 (cerrar), f5 (refrescar), teclas como enter y tab, o varias seguidas como ctrl+a, ctrl+c (seleccionar todo y copiar). Indispensable para operar apps de escritorio que dependen de atajos de teclado.

Cómo funciona

Combinaciones: los modificadores y la tecla se unen con + (ej. ctrl+shift+n). Cada combinación lleva una sola tecla principal. No distingue mayúsculas (Ctrl+S = ctrl+s).
Secuencias: varias combinaciones se separan con comas y se envían en orden, con una pausa de 60 ms entre una y otra para que la app procese cada una (ej. home, shift+end selecciona la línea actual).
Con selector: primero localiza el elemento (hasta timeout), trae al frente su ventana (espera hasta 3 s) y lo enfoca; luego envía las teclas. Si la ventana no se puede traer al frente, no se envía nada y la actividad falla (así las teclas nunca terminan en otra aplicación). Si a mitad de una secuencia otra ventana toma el foco, la secuencia se detiene ahí y la actividad falla indicando cuántas combinaciones alcanzó a enviar.
Sin selector: las teclas van a la ventana que tenga el foco en ese momento, y session no se usa. Trae antes la ventana correcta con Win Focus.

Las teclas de edición y navegación se envían como las envía un teclado real, así que las selecciones funcionan igual que a mano: shift+end, shift+home o ctrl+shift+right seleccionan texto correctamente. El registro solo anota cuántas combinaciones se enviaron, no cuáles (pueden llevar un código o un PIN).

Teclas disponibles

Tipo	Nombres
Modificadores	`ctrl` (o `control`), `alt`, `shift`, `win` (o `windows`)
Letras y dígitos	`a`–`z`, `0`–`9`
Edición y navegación	`enter` (o `return`), `tab`, `esc` (o `escape`), `space`, `backspace`, `delete` (o `del`), `insert` (o `ins`), `home`, `end`, `pageup` (o `pgup`), `pagedown` (o `pgdn`), `up`, `down`, `left`, `right`
Funciones	`f1`–`f24`
Sistema	`printscreen` (o `prtsc`), `pause` (o `break`), `capslock`, `numlock`, `scrolllock`, `menu` (tecla de menú contextual; también `apps`)
Teclado numérico	`num0`–`num9` (o `numpad0`–`numpad9`), `multiply`, `add`, `subtract`, `decimal`, `divide`
Símbolos por nombre	`plus`, `minus` (o `dash`), `comma`, `period` (o `dot`), `slash`, `backslash`, `semicolon`, `quote`, `equals`, `backquote` (o `backtick`), `openbracket`, `closebracket`
Símbolos tal cual	`-` `.` `/` `;` `=` `'` `[` `]` `\` `

Los símbolos se traducen con la distribución de teclado de la máquina: si en esa distribución el símbolo necesita Shift o AltGr, se añaden solos. Así, plus funciona igual en un teclado en español (donde + tiene tecla propia) que en uno en inglés (donde es Shift + =).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`keys`	`string`	—	Tecla, combinación o secuencia separada por comas. Ej: `ctrl+s`, `alt+f4`, `enter`, `f5`, `ctrl+shift+n`, `ctrl+a, ctrl+c`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanDesktopSession`	—	Sesión de Win Attach, para buscar el `selector` dentro de su ventana. Dentro de un `body` se toma sola. Sin `selector` no se usa.
`selector`	`selector`	—	Elemento a enfocar antes de enviar las teclas. Vacío = las teclas van a la ventana activa.
`timeout`	`number`	`30000`	Máximo en ms a esperar el elemento (si hay selector). 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
`Tecla desconocida: '…'. Consulta la ayuda del parámetro para ver los nombres de las teclas.`	Un nombre de tecla no existe o el símbolo no está en la distribución de teclado de la máquina. Revisa la tabla de teclas.
`'…' tiene más de una tecla principal. Usa comas para enviar teclas una tras otra (p. ej. 'ctrl+a, ctrl+c').`	Una combinación como `a+b`. Sepáralas con comas.
`No se indicó una tecla principal en '…'.`	Una combinación solo con modificadores (`ctrl+shift`). Agrega la tecla.
`'keys' está vacío.` / `'keys' es obligatorio.`	No hay teclas que enviar.
`No se pudo traer al frente la ventana del elemento, así que no se enviaron teclas (habrían ido a otra ventana). …`	La ventana está detrás de un diálogo, minimizada o se ejecuta como administrador. Cierra el diálogo o revisa los permisos.
`Otra ventana tomó el foco después de … de … combinaciones de teclas; el resto no se envió.`	Apareció otra ventana a mitad de la secuencia. Espera a que se estabilice con Win Wait For y reintenta.
`Windows rechazó las pulsaciones de teclas (error …). …`	La ventana de destino se ejecuta como administrador y el robot no, o la sesión está bloqueada.
`No se encontró el elemento con el selector {…}.`	Ver errores comunes.

Ejemplos

Guardar con Ctrl+S y confirmar un diálogo con Enter:

Win Key Press   selector = (área de texto)   keys = "ctrl+s"
Win Wait For    selector = (diálogo "Confirmar")   state = visible
Win Key Press   selector = (botón "Aceptar")   keys = "enter"

Seleccionar la línea actual de un campo de texto:

Win Key Press   selector = (campo "Notas")   keys = "home, shift+end"

Copiar todo el contenido de un campo y pegarlo en otro:

Win Key Press   selector = (campo "Origen")    keys = "ctrl+a, ctrl+c"
Win Key Press   selector = (campo "Destino")   keys = "ctrl+v"

Escribir un número con el teclado numérico y pasar al siguiente campo:

Win Key Press   selector = (campo "Cantidad")   keys = "num1, num2, num0, tab"

Actividades relacionadas

Win Type — escribir texto (no teclas especiales).
Win Focus — traer la ventana correcta al frente antes de enviar teclas sin selector.
Win Click — alternativa con un botón.