Extraits
Un extrait est un morceau nommé d'étapes ou de script qui n'est lié à aucun déclencheur. Les actions, les scripts avant et après, les événements globaux et d'autres extraits l'exécutent par son nom. Écrivez quelque chose une fois sous forme d'extrait, et chaque action qui l'appelle utilise la même copie : modifiez l'extrait, et toutes changent.
La liste des extraits
La liste affiche chaque extrait de la bibliothèque, sous un titre par catégorie : les catégories de A à Z, puis Sans catégorie, et de A à Z par nom à l'intérieur de chacune. Un extrait appelé par quelque chose affiche Utilisé par et le nombre d'appelants.
- + Nouveau ajoute un extrait nommé Nouvel extrait dans la catégorie de l'extrait sélectionné, rédigé sous forme d'étapes.
- Le bouton de duplication à côté de + Nouveau copie l'extrait sélectionné sous un nouveau nom unique.
- Le bouton de suppression d'une ligne supprime un extrait (Supprimer un extrait).
Nom et catégorie
- Le Nom ① est ce qui permet aux appelants de trouver l'extrait. Il doit être unique dans toute la bibliothèque, quelle que soit la catégorie, et deux noms qui ne diffèrent que par la casse comptent comme identiques. Il ne peut contenir ni guillemet double, ni barre oblique inverse, ni caractère de contrôle. Un nom qui enfreint une règle s'affiche en rouge avec la raison, et revient à l'ancien nom quand vous quittez la zone.
- Renommer un extrait réécrit chaque appel qui le nomme entre guillemets, partout dans votre configuration (Qui appelle un extrait).
- Catégorie ② ne fait que regrouper la liste. Elle ne change pas la façon dont l'extrait s'exécute.
Ce que fait l'extrait
Rédigé sous forme de choisit Étapes ou Script, comme pour une action (Étapes, Script et AutoHotkey). Passer des étapes au script propose de traduire les étapes, comme sur la page Actions.
- Avec Étapes, l'éditeur est le même que pour une action (L'éditeur d'étapes).
- Avec Script, Vérifier la syntaxe vérifie le script avec le compilateur propre au moteur. Il indique Analyse réussie avec le nombre de lignes, ou la première erreur, et souligne le problème dans l'éditeur.
- AutoHotkey n'est proposé que pour un extrait qui s'exécute déjà comme AutoHotkey.
- Il n'y a pas de bouton pour exécuter un extrait ici. Pour essayer des étapes sans risque, utilisez le Bac à sable.
Mode Avancé. Au-dessus de l'éditeur, l'appel qui exécute cet extrait ③ est affiché sous forme de script, avec un bouton qui le copie.
Appeler un extrait
Un extrait s'exécute quand une étape ou un script appelle la fonction intégrée SnippetExecuteScript
avec son nom :
- Avec Étapes, ajoutez une étape Exécuter un extrait (
SnippetExecuteScript) depuis la liste de toutes les fonctions intégrées (Ajouter des étapes) et tapez le nom de l'extrait comme Nom. - Avec Script, écrivez l'appel :
SnippetExecuteScript("Center window");
Comment il s'exécute :
- L'appelant attend que l'extrait se termine, puis continue.
- L'extrait voit ce qui a lancé l'appelant (sa fenêtre cible, son geste, etc.) : Fenêtre cible dans un extrait est donc la fenêtre cible de l'appelant.
- L'extrait a ses propres variables. Il ne peut pas lire celles de l'appelant, et l'appelant ne peut pas lire les siennes.
- Le nom doit correspondre exactement, casse comprise. Si aucun extrait ne porte ce nom, rien ne
s'exécute et l'appel renvoie
false. - L'appel ne renvoie
trueque si l'extrait s'est exécuté jusqu'au bout. Il renvoie aussifalsequand l'extrait est vide, contient une erreur ou est arrêté. - Un extrait peut appeler d'autres extraits. Rien n'empêche un extrait de s'appeler lui-même : assurez-vous donc qu'une telle chaîne se termine.
Qui appelle un extrait
La carte Appelé par ④ liste chaque action, script avant ou après, événement global (même désactivé) et extrait qui appelle cet extrait. Un événement global est marqué Événement global, et un extrait Extrait.
Seuls les appels qui écrivent le nom de l'extrait en toutes lettres entre guillemets sont trouvés. Un appel qui construit le nom pendant l'exécution n'est pas listé, alors qu'un appel dans un commentaire l'est. Les contenus AutoHotkey ne sont pas parcourus.
Supprimer un extrait
Vous ne pouvez pas supprimer un extrait tant qu'un élément listé sous Appelé par l'appelle encore. Le bouton de suppression affiche alors Impossible de supprimer… avec la liste des appelants ; modifiez ou supprimez d'abord ces appels. Un extrait que rien n'appelle est supprimé après une confirmation.
Un appel que la liste ne peut pas voir (un nom construit pendant l'exécution du script) n'est pas
protégé : si vous supprimez cet extrait, l'appel ne trouve rien et renvoie false.
Des extraits venus d'ailleurs
- Créer un extrait sur la page Enregistreur transforme un enregistrement en extrait.
- Enregistrer comme extrait sur la page Bac à sable enregistre les étapes ou le script que vous y avez essayés.
Les deux ouvrent le nouvel extrait sur cette page avec le curseur dans son Nom, prêt à être
renommé. Un nom déjà pris reçoit -1, -2, etc.