Console
La console est la fenêtre propre au moteur pour diagnostiquer et faire des essais. Elle affiche ce que signale le moteur (problèmes dans votre configuration, scripts qui ont échoué, plugins remplacés par le dessin intégré), affiche ce que vos scripts impriment, et comporte un éditeur où vous pouvez écrire et exécuter un script sur-le-champ.
Ouvrir la console
Choisissez Afficher la console dans le menu de l'icône de la zone de notification
(L'icône de la zone de notification), ou exécutez la fonction intégrée UIShowConsole depuis
une action — par exemple en l'associant à un raccourci. Rien n'ouvre la console automatiquement, sauf si
vous le demandez avec Sur message (ci-dessous).
Si votre configuration est protégée par un mot de passe, la console le demande à l'ouverture, sauf s'il
est encore mémorisé (Sécurité). Tant que la console est ouverte, le mot de passe
mémorisé n'expire pas. UIShowConsole attend que la console soit ouverte, y compris pendant la demande de
mot de passe, et renvoie false si elle ne s'est pas ouverte, par exemple parce que la demande de mot de
passe a été annulée.
La console se ferme avec son bouton de fermeture. La fermer libère la mémoire qu'elle utilisait.
Les trois sections
Les boutons en haut ① permettent de passer d'une section à l'autre parmi trois, chacune avec sa propre barre d'outils.
| Section | Ce qu'elle affiche | Barre d'outils |
|---|---|---|
| Système | Ce que signale le moteur : notes sur votre configuration lors du dernier chargement, actions et scripts qui ont échoué et pourquoi, un plugin qui n'a pas pu dessiner de sorte que le dessin intégré a pris le relais, etc. | Copier, Effacer, Sur message |
| Utilisateur | Tout ce que vos scripts impriment avec UtilityPrint, depuis toutes les actions. | Copier, Effacer, Sur message |
| Script | Un éditeur de script au-dessus d'un volet de sortie. | Exécuter, Tout arrêter, Masquer la console, Aide sur les scripts, Copier, Coller, Effacer |
Copier copie le texte sélectionné, ou toute la section si rien n'est sélectionné. Effacer vide la section.
Tant que la section Script est affichée, les nouvelles lignes de Système et Utilisateur apparaissent aussi dans son volet de sortie : vous pouvez ainsi suivre un script en cours sans changer de section.
Pendant que la console est fermée
Les lignes qui arrivent pendant que la console est fermée ne sont pas perdues : elles sont conservées dans des fichiers temporaires et affichées à la prochaine ouverture de la console. Quand Input.Observer se ferme, elles sont supprimées, sauf ce qu'imprime l'événement Arrêt du moteur, que la console de la session suivante affiche.
Sur message ① dans les barres d'outils Système et Utilisateur choisit ce que fait une nouvelle ligne pendant que la console est fermée :
| Choix | Ce qui se passe |
|---|---|
| Ne rien faire | La ligne attend que vous ouvriez la console. Par défaut. |
| Afficher UIShowMessageBox | La ligne s'affiche aussi dans une boîte de message. |
| Ouvrir la console | La console s'ouvre sur cette section. |
Quand la console est ouverte, une nouvelle ligne est simplement ajoutée ; elle n'ouvre jamais de boîte de message et ne change jamais de section. Les mêmes choix figurent sur la page Console sous Nouveaux messages Système et Nouveaux messages Utilisateur.
Exécuter un script
- Ouvrez la section Script de la console.
- Tapez ou collez un script dans l'éditeur. Il utilise le langage de script d'Input.Observer (Référence du langage de script).
- Choisissez Exécuter ② ou appuyez sur F5. Si du texte est sélectionné, seule la sélection s'exécute ; sinon, tout le contenu de l'éditeur s'exécute.
- La sortie et les éventuelles erreurs apparaissent dans le volet de sortie sous l'éditeur. Masquer la console masque ou affiche ce volet.
- Un script exécuté ici fonctionne comme une action : toutes les fonctions intégrées sont disponibles, et il s'exécute jusqu'à ce qu'il se termine ou soit arrêté. Tout arrêter arrête tous les scripts et actions en cours, pas seulement celui-ci.
- C'est le seul endroit où des scripts s'exécutent en mode sans échec, pour que vous puissiez inspecter et réparer pendant que rien d'autre ne s'exécute (Dépannage).
- L'éditeur complète les noms des fonctions intégrées pendant la frappe ; Ctrl+Espace liste tout, et taper un nom de domaine suivi d'un point liste les fonctions de ce domaine. Après le choix d'une fonction, une info-bulle affiche ses paramètres, avec le paramètre en cours en surbrillance. Le menu contextuel propose Commenter et Décommenter pour les lignes sélectionnées.
- Le texte de l'éditeur est conservé d'une session à l'autre dans
console.toml.
Aide sur les scripts ③ ouvre la référence du langage de script dans la fenêtre d'aide (La fenêtre d'aide), dans la langue qu'utilise Input.Observer (ou en anglais s'il n'existe pas d'aide dans cette langue).
La page Console
Mode Avancé. La page Console est masquée en mode Simple. Ses paramètres restent en vigueur.
La page Console de la fenêtre de configuration contient les paramètres de la console. Ils prennent effet quand vous choisissez Appliquer ou Enregistrer et fermer.
| Paramètre | Ce qu'il fait | Par défaut | Plage |
|---|---|---|---|
| Limite de lignes de la console | Dès qu'une section contient ce nombre de lignes, les plus anciennes sont abandonnées à l'arrivée de nouvelles. 0 conserve tout. Prend effet à la ligne suivante. | 5 000 lignes | 0–1 000 000 |
| Libérer la mémoire à la fermeture de la console | Rend à Windows la mémoire de la console dès que vous la fermez. L'événement de souris ou de clavier suivant peut alors être très légèrement plus lent. | Activé | Activé ou désactivé |
| Nouveaux messages Système | Ce que fait une nouvelle ligne Système pendant que la console est fermée : Rien, Boîte de message ou Ouvrir la console (comme Sur message ci-dessus) | Rien | — |
| Nouveaux messages Utilisateur | La même chose pour les lignes Utilisateur | Rien | — |
| Police des fenêtres du moteur | La police et la taille des libellés et boutons de la console et des boîtes de dialogue du moteur (mot de passe, licence) | Segoe UI, 12 pt | 6–72 pt |
| Police de l'éditeur du moteur | La police et la taille des sections de la console et de son éditeur de script | Consolas, 13 pt | 6–72 pt |
Une console ouverte conserve ses polices jusqu'à ce que vous la fermiez puis la rouvriez.