Paramètres des étapes
Quand vous sélectionnez une étape, ses champs s'ouvrent en dessous, un par information dont l'étape a besoin. Chaque champ a un libellé en termes simples. Pointez sur un champ pour voir une info-bulle qui indique à quoi il sert.
Types de champs
| Champ | Aspect | Accepte |
|---|---|---|
| Texte | une zone de texte | n'importe quel texte |
| Nombre entier | une zone de texte | un nombre entier, comme 250 ou -3, un nombre hexadécimal commençant par 0x, comme 0xB3, ou une constante nommée, comme VirtualKey.MediaPlayPause |
| Nombre | une zone de texte | un nombre avec un point comme séparateur décimal, comme 0.5, quel que soit votre format régional |
| Vrai ou faux | un interrupteur | activé (true) ou désactivé (false) |
| Un choix de valeurs nommées | une liste déroulante ② | l'un des noms listés, comme MouseButton.Primary ; vous pouvez aussi y taper |
| Fenêtre | une zone de texte | une fenêtre issue du menu des valeurs ou d'une variable, normalement Fenêtre cible |
| Touches (Envoyer des touches) | une zone de capture de touches | la combinaison de touches sur laquelle vous appuyez |
Dans tous les types de champs, vous pouvez aussi taper $ et le nom d'une variable pour utiliser une
valeur qu'une étape précédente a enregistrée (Variables).
Un nombre dans le champ d'une étape utilise toujours un point comme séparateur décimal et aucun séparateur de milliers, quel que soit votre format régional.
Constantes nommées
Un champ Nombre entier ou Nombre accepte aussi une constante nommée : un espace de noms, un point et un
nom, comme VirtualKey.MediaPlayPause ou AudioEndpoint.Playback, les mêmes noms qu'utilise un script
(Constantes nommées). Tapez-la exactement, avec les mêmes majuscules et
sans espace. L'étape enregistre le nom et l'action utilise son nombre à l'exécution. Un champ Texte
conserve un tel nom comme le texte que vous avez tapé.
Le champ Touches
Envoyer des touches a une zone de capture au lieu d'une zone de texte. Cliquez dessus (Cliquez pour
définir un raccourci), puis appuyez sur la combinaison. Seule la combinaison est enregistrée ; rien
n'est envoyé pendant que vous la définissez. Les touches qu'une combinaison de touches ne peut pas
nommer, comme les touches multimédias, sont refusées avec un message. Pour appuyer sur celles-ci,
utilisez l'étape Appuyer sur une touche et la relâcher (KeyboardPressKey) avec le nom de la touche,
comme VirtualKey.MediaPlayPause (Recettes détaillées).
Les nouvelles étapes sont préremplies
Les champs Fenêtre d'une nouvelle étape commencent par Fenêtre cible : la fenêtre sur laquelle le geste a été tracé, ou la fenêtre qui a le focus pour un raccourci ou un texte tapé. Ses interrupteurs commencent désactivés. Tous les autres champs commencent vides, pour que vous les remplissiez.
Choisir une valeur dans le menu
Chaque champ, sauf Touches et les interrupteurs, a une petite flèche à son extrémité (Choisir une valeur). Elle ouvre un menu de valeurs adaptées au champ ①. Outre les champs propres à une étape, le menu se trouve sur les champs Valeur et Comparée à d'une condition et sur sa Valeur unique (Conditions), sur le Nombre de fois d'une répétition (Répéter des étapes) et sur la Valeur d'une étape Définir une variable (Variables).
| Section | Valeurs |
|---|---|
| De ce qui a lancé l'action | Fenêtre cible, Contrôle cible, Nom du geste, Nom de l'action, Nom du groupe d'applications, Bouton du geste, ainsi que Bord gauche du geste, Bord supérieur du geste, Largeur du geste et Hauteur du geste |
| Lu à l'exécution de l'étape | Fenêtre active, Position X de la souris, Position Y de la souris, Texte du Presse-papiers, Date et heure actuelles |
| Enregistré par les étapes précédentes | les variables qu'enregistrent les étapes situées au-dessus de celle-ci |
Le menu ne liste que les valeurs du type du champ : un champ Nombre accepte aussi les nombres entiers, et un champ qui accepte tout les accepte toutes. Nombre de fois ne propose que des nombres entiers ; les champs d'une condition et la valeur de Définir une variable proposent toutes les lectures. Quand rien ne convient, le menu indique Rien à choisir pour ce champ.
Une valeur choisie s'affiche sous forme de puce portant son nom, à la place de la zone de texte. Pointez sur la puce pour voir ce qu'elle est et comment un script l'écrit. Son bouton Effacer vide le champ pour que vous puissiez taper de nouveau.
Les valeurs sous De ce qui a lancé l'action lisent le déclencheur : pour une action lancée par un raccourci ou un texte tapé, les valeurs de geste sont vides ou valent 0. Toutes les valeurs sont proposées partout où des étapes s'exécutent, car un extrait peut être appelé de n'importe où.
Sur un interrupteur, une variable tapée auparavant s'affiche sous forme de puce ; effacer la puce désactive l'interrupteur.
Vérifications pendant la frappe
Chaque champ est vérifié pendant la frappe. Un problème s'affiche en rouge sous le champ et la bordure du champ devient rouge :
| Message | Signification |
|---|---|
| Cette valeur est obligatoire. | Le nom de variable d'une étape Définir une variable est vide. |
| Entrez un nombre entier (décimal ou hexadécimal 0x), une constante nommée ou une $variable. | Un champ Nombre entier contient autre chose. |
| Aucune constante nommée ne porte ce nom. Vérifiez l'orthographe et les majuscules, comme dans VirtualKey.MediaPlayPause. | Un champ Nombre entier ou Nombre contient un espace de noms, un point et un nom qui n'est pas une constante nommée. |
| Entrez un nombre, ou une $variable. | Un champ Nombre contient autre chose. |
| Entrez true ou false, ou une $variable. | Un champ Vrai ou faux saisi sous forme de texte contient autre chose. |
| Une étape ne peut pas exécuter une fonction intégrée à l'intérieur d'un argument. Placez-la d'abord dans une variable. | Le champ contient un appel de fonction intégrée avec quelque chose entre ses parenthèses (ci-dessous). |
Tant qu'un champ contient un texte tapé qui échoue à sa vérification, comme des lettres dans un champ
Nombre entier ou Nombre, un nom qui n'est pas une constante nommée, ou autre chose que true ou false
dans un champ Vrai ou faux, les étapes ne sont pas enregistrées : l'action conserve ses dernières étapes
enregistrées, et Étapes non enregistrées : l'étape N a un champ non valide s'affiche sous la liste
jusqu'à ce que vous corrigiez le champ (Problèmes).
Un champ vide n'affiche aucun message et n'empêche jamais l'enregistrement ; les étapes sont enregistrées avec le champ vide. Quand l'action s'exécute, une étape dont un champ nombre, vrai ou faux, ou fenêtre est vide arrête l'action à cet endroit, et la sortie Système de la console indique que cet argument a le mauvais type. Un champ Texte vide s'exécute comme un texte vide, ce qui, pour certaines fonctions intégrées (un nom de fichier, un titre de fenêtre à chercher), signifie que l'étape ne fait rien.
Placer dans une variable
Un champ contient une valeur, une variable ou l'une des lectures du menu des valeurs, jamais un appel de
fonction intégrée avec des arguments. Si vous en tapez un, comme WindowGetTitle($w), le champ propose
Placer dans une variable. Cela ajoute juste au-dessus de celle-ci une étape qui exécute l'appel et
enregistre le résultat sous un nom tiré du champ (comme window, puis window2), et place cette variable
dans le champ.
Un appel sans rien entre ses parenthèses, comme ClipboardGetText(), est accepté : c'est la même chose
que de choisir cette lecture dans le menu des valeurs. Cela vaut pour tous les champs dotés du menu des
valeurs, y compris les champs d'une condition, Nombre de fois et la valeur de Définir une
variable.
Conserver le résultat d'une étape
La plupart des fonctions intégrées donnent un résultat : le texte qu'elles ont lu, la fenêtre qu'elles ont
trouvée, ou le fait qu'elles ont fonctionné. Enregistrer le résultat sous ③ le conserve sous un nom,
pour que les étapes suivantes puissent l'utiliser sous la forme $nom. Laissez-le vide pour ignorer le
résultat.
Une étape qui conserve son résultat affiche « → $nom » à la fin de son résumé. Les noms suivent les règles de Variables.
Types incorrects à l'exécution
L'éditeur vérifie la forme de ce que vous tapez, pas chaque règle de la fonction intégrée. Quand l'action s'exécute, une valeur du mauvais type (par exemple une variable contenant du texte là où une fonction intégrée a besoin d'un nombre entier) ou une valeur que la fonction refuse arrête l'action avec une erreur dans la console de diagnostic. Voir Erreurs.