Parámetros de los pasos
Cuando selecciona un paso, sus campos se abren debajo, uno por cada detalle que necesita el paso. Cada campo tiene una etiqueta en palabras sencillas. Apunte a un campo para ver una información sobre herramientas que indica para qué sirve.
Tipos de campo
| Campo | Aspecto | Acepta |
|---|---|---|
| Texto | un cuadro de texto | cualquier texto |
| Número entero | un cuadro de texto | un número entero, como 250 o -3, un número hexadecimal que empieza con 0x, como 0xB3, o una constante con nombre, como VirtualKey.MediaPlayPause |
| Número | un cuadro de texto | un número con punto decimal, como 0.5, sea cual sea su configuración regional |
| Verdadero o falso | un interruptor | activado (true) o desactivado (false) |
| Una elección de valores con nombre | una lista desplegable ② | uno de los nombres de la lista, como MouseButton.Primary; también puede escribir en ella |
| Ventana | un cuadro de texto | una ventana del menú de valores o de una variable, normalmente Ventana de destino |
| Teclas (Enviar teclas) | un cuadro de captura de teclas | la combinación de teclas que presiona |
En cualquier tipo de campo también puede escribir $ y el nombre de una variable para usar un valor
que guardó un paso anterior (Variables).
Un número en el campo de un paso siempre usa un punto como separador decimal y ningún separador de miles, sea cual sea su configuración regional.
Constantes con nombre
Un campo Número entero o Número también acepta una constante con nombre: un espacio de nombres, un
punto y un nombre, como VirtualKey.MediaPlayPause o AudioEndpoint.Playback, los mismos nombres
que usa un script (Constantes con nombre). Escríbala exactamente, con
las mismas mayúsculas y sin espacios. El paso guarda el nombre y la acción usa su número cuando se
ejecuta. Un campo Texto conserva ese nombre como el texto que escribió.
El campo Teclas
Enviar teclas tiene un cuadro de captura en lugar de un cuadro de texto. Haga clic en él (Haga
clic para establecer un atajo) y luego presione la combinación. Solo se registra la combinación;
no se envía nada mientras la establece. Las teclas que una combinación de teclas no puede nombrar,
como las teclas multimedia, se rechazan con un mensaje. Para presionarlas, use el paso Presionar y
soltar tecla (KeyboardPressKey) con el nombre de la tecla, como VirtualKey.MediaPlayPause
(Recetas resueltas).
Los pasos nuevos empiezan completados
Los campos Ventana de un paso nuevo empiezan como Ventana de destino: la ventana sobre la que se dibujó el gesto, o la ventana con el foco para una tecla de acceso rápido o un texto escrito. Sus interruptores empiezan desactivados. Todos los demás campos empiezan vacíos, para que usted los complete.
Elegir un valor en el menú
Todos los campos, excepto Teclas y los interruptores, tienen una pequeña flecha al final (Elegir un valor). Abre un menú de valores que encajan en el campo ①. Además de en los campos propios de un paso, el menú está en los campos Valor y Comparado con de una condición y en su único Valor (Condiciones), en Veces de una repetición (Repetir pasos) y en Valor de un paso Asignar variable (Variables).
| Sección | Valores |
|---|---|
| De lo que inició la acción | Ventana de destino, Control de destino, Nombre del gesto, Nombre de la acción, Nombre del grupo de aplicaciones, Botón del gesto, y los valores del gesto Borde izquierdo del gesto, Borde superior del gesto, Ancho del gesto y Alto del gesto |
| Se lee al ejecutarse el paso | Ventana activa, Posición X del mouse, Posición Y del mouse, Texto del portapapeles, Fecha y hora actuales |
| Guardado por pasos anteriores | las variables que guardan los pasos que están encima de este |
El menú enumera solo los valores del tipo del campo: un campo Número también acepta números enteros, y un campo que acepta cualquier cosa los acepta todos. Veces ofrece solo números enteros; los campos de una condición y el valor de Asignar variable ofrecen todas las lecturas. Cuando nada encaja, el menú dice No hay nada que elegir para este campo.
Un valor elegido se muestra como un chip con su nombre en lugar del cuadro de texto. Apunte al chip para ver qué es y cómo lo escribe un script. Su botón Borrar vacía el campo para que pueda volver a escribir.
Los valores de De lo que inició la acción leen el disparador: para una acción iniciada por una tecla de acceso rápido o por un texto escrito, los valores del gesto están vacíos o son 0. Todos los valores se ofrecen en cualquier lugar donde se ejecutan pasos, porque un snippet se puede llamar desde cualquier lugar.
En un interruptor, una variable que escribió antes se muestra como un chip; borrar el chip desactiva el interruptor.
Comprobaciones al escribir
Cada campo se comprueba mientras escribe. Un problema se muestra en rojo debajo del campo, y el borde del campo se vuelve rojo:
| Mensaje | Significado |
|---|---|
| Este valor es obligatorio. | El nombre de la variable de un paso Asignar variable está vacío. |
| Escriba un número entero (decimal o hexadecimal 0x), una constante con nombre o una $variable. | Un campo Número entero contiene otra cosa. |
| No existe ninguna constante con nombre con este nombre. Revise la ortografía y las mayúsculas, como en VirtualKey.MediaPlayPause. | Un campo Número entero o Número contiene un espacio de nombres, un punto y un nombre que no es una constante con nombre. |
| Escriba un número, o una $variable. | Un campo Número contiene otra cosa. |
| Escriba true o false, o una $variable. | Un campo de verdadero o falso escrito como texto contiene otra cosa. |
| Un paso no puede ejecutar una función integrada dentro de un argumento. Muévala primero a una variable. | El campo contiene una llamada a una función integrada con algo entre sus paréntesis (más abajo). |
Mientras un campo contiene texto escrito que no pasa su comprobación, como letras en un campo Número
entero o Número, un nombre que no es una constante con nombre, o cualquier cosa que no sea true o
false en un campo de verdadero o falso, los pasos no se guardan: la acción conserva sus últimos
pasos guardados, y No se guardaron los pasos: el paso N tiene un campo que no es válido aparece
debajo de la lista hasta que corrija el campo (Problemas).
Un campo vacío no muestra ningún mensaje y nunca impide guardar; los pasos se guardan con el campo vacío. Cuando la acción se ejecuta, un paso con un campo de número, de verdadero o falso o de ventana vacío detiene la acción ahí, y la salida Sistema de la consola indica que ese argumento tiene el tipo equivocado. Un campo Texto vacío se ejecuta como texto vacío, lo que para algunas funciones integradas (un nombre de archivo, un título de ventana que buscar) significa que el paso no hace nada.
Mover a una variable
Un campo contiene un valor, una variable o una de las lecturas del menú de valores, nunca una llamada
a una función integrada con argumentos. Si escribe una, como WindowGetTitle($w), el campo ofrece
Mover a una variable. Agrega justo encima de este un paso que ejecuta la llamada y guarda el
resultado con un nombre tomado del campo (como window, y luego window2), y pone esa variable en el
campo.
Una llamada sin nada entre sus paréntesis, como ClipboardGetText(), está bien: es lo mismo que
elegir esa lectura en el menú de valores. Esto vale para todos los campos que tienen el menú de
valores, incluidos los campos de una condición, Veces y el valor de Asignar variable.
Conservar el resultado de un paso
La mayoría de las funciones integradas dan un resultado: el texto que leyeron, la ventana que
encontraron o si funcionaron. Guardar resultado como ③ lo conserva con un nombre, para que los
pasos posteriores puedan usarlo como $nombre. Déjelo vacío para ignorar el resultado.
Un paso que conserva su resultado muestra "→ $nombre" al final de su resumen. Los nombres siguen las reglas de Variables.
Tipos equivocados al ejecutarse
El editor comprueba la forma de lo que escribe, no todas las reglas de la función integrada. Cuando la acción se ejecuta, un valor del tipo equivocado (por ejemplo, una variable que contiene texto donde una función integrada necesita un número entero) o un valor que la función integrada rechaza detiene la acción con un error en la consola de diagnóstico. Consulte Errores.