Snippets

Un snippet es un fragmento de pasos o de script con nombre que no está vinculado a ningún disparador. Las acciones, los scripts antes y después, los eventos globales y otros snippets lo ejecutan por su nombre. Escriba algo una vez como snippet, y todas las acciones que lo llaman usan la misma copia: cambie el snippet y todas cambian.

Input.ObserverSimpleAvanzado

AUTOMATIZACIÓN

Acciones

Expansión de texto

Snippets

Grabadora

Entorno de prueba

Grupos de aplicaciones

Grupos de omisión

Gestos

MOTOR

Eventos globales

Zonas de exclusión

Scripts

Complementos

CONFIGURACIÓN

General

Apariencia

Perfiles

Consola

Seguridad

Ayuda

Acerca de

Sus snippets

Center window

Usado por 2

Pegar texto sin formato

+ Nuevo

Snippets

Center window

1Center window

2Ventanas

Solo para mostrar. No cambia cómo se ejecuta el snippet.

Script

3SnippetExecuteScript("Center window");

PasosScript

1Centrar ventanaVentana de destino

4

Llamado por

Deslizar a la izquierda

Navegadores: script de Antes

La lista de snippets

La lista muestra todos los snippets de la biblioteca, bajo un encabezado por categoría: las categorías de la A a la Z, luego Sin categoría, y de la A a la Z por nombre dentro de cada una. Un snippet al que algo llama muestra Usado por y el número de llamadores.

• + Nuevo agrega un snippet llamado Nuevo snippet en la categoría del snippet seleccionado, escrito como Pasos.
• El botón de duplicar junto a + Nuevo copia el snippet seleccionado con un nombre nuevo y único.
• El botón de eliminar de una fila elimina un snippet (Eliminar un snippet).

Nombre y categoría

• Nombre ① es como los llamadores encuentran el snippet. Debe ser único en toda la biblioteca, sea cual sea la categoría, y dos nombres que solo difieren en mayúsculas y minúsculas cuentan como el mismo. No puede contener comillas dobles, una barra invertida ni un carácter de control. Un nombre que incumple una regla se muestra en rojo con el motivo, y vuelve al nombre anterior cuando sale del cuadro.
• Cambiar el nombre de un snippet reescribe todas las llamadas que lo nombran entre comillas, en toda su configuración (Quién llama a un snippet).
• Categoría ② solo agrupa la lista. No cambia cómo se ejecuta el snippet.

Qué hace el snippet

Escrita como elige Pasos o Script, igual que para una acción (Pasos, Script y AutoHotkey). Cambiar de Pasos a Script ofrece traducir los pasos, como en la página Acciones.

• En Pasos, el editor es el mismo que el de una acción (El editor de Pasos).
• En Script, Comprobar sintaxis revisa el script con el propio compilador del motor. Informa Análisis correcto con el recuento de líneas, o el primer error, y subraya el problema en el editor.
• AutoHotkey solo se ofrece para un snippet que ya se ejecuta como AutoHotkey.
• Aquí no hay ningún botón para ejecutar un snippet. Para probar pasos sin riesgo, use el Entorno de prueba.

nota

Modo Avanzado. Encima del editor, se muestra en forma de Script la llamada que ejecuta este snippet ③, con un botón que la copia.

Llamar a un snippet

Un snippet se ejecuta cuando un paso o un script llama a la función integrada SnippetExecuteScript con su nombre:

• En Pasos, agregue un paso Ejecutar un snippet (SnippetExecuteScript) desde la lista de todas las funciones integradas (Agregar pasos) y escriba el nombre del snippet como su Nombre.
• En Script, escriba la llamada:

SnippetExecuteScript("Center window");

Cómo se ejecuta:

• El llamador espera hasta que el snippet termina y luego continúa.
• El snippet ve lo que inició al llamador (su ventana de destino, su gesto, etc.), así que Ventana de destino dentro de un snippet es la ventana de destino del llamador.
• El snippet tiene sus propias variables. No puede leer las del llamador, y el llamador no puede leer las suyas.
• El nombre debe coincidir exactamente, incluidas las mayúsculas y minúsculas. Si ningún snippet tiene ese nombre, no se ejecuta nada y la llamada devuelve false.
• La llamada devuelve true solo cuando el snippet se ejecutó hasta el final. También devuelve false cuando el snippet está vacío, tiene un error o se detiene.
• Un snippet puede llamar a otros snippets. Nada impide que un snippet se llame a sí mismo, así que asegúrese de que esa cadena termine.

Quién llama a un snippet

La tarjeta Llamado por ④ enumera cada acción, script antes o después, evento global (incluso uno desactivado) y snippet que llama a este snippet. Un evento global se marca con Evento global, y un snippet con Snippet.

Solo se encuentran las llamadas que escriben el nombre del snippet completo entre comillas. Una llamada que arma el nombre mientras se ejecuta no aparece, y una llamada dentro de un comentario sí. Los contenidos de AutoHotkey no se revisan.

Eliminar un snippet

No puede eliminar un snippet mientras algo de Llamado por todavía lo llame. El botón de eliminar muestra entonces No se puede eliminar con la lista de llamadores; primero cambie o quite esas llamadas. Un snippet al que nada llama se elimina después de una confirmación.

Una llamada que la lista no puede ver (un nombre que se arma mientras se ejecuta el script) no está protegida: si elimina ese snippet, la llamada no encuentra nada y devuelve false.

Snippets de otros lugares

• Crear snippet en la página Grabadora convierte una grabación en un snippet.
• Guardar como snippet en la página Entorno de prueba guarda los pasos o el script que probó ahí.

Ambos abren el snippet nuevo en esta página con el cursor en su Nombre, listo para cambiarle el nombre. A un nombre que ya está en uso se le agrega -1, -2, etc.