Ceci est une ancienne révision du document !
Table des matières
Actions
Un script d'Actionaz est composé d'actions qui sont exécutées séquentiellement.
Chaque action possède :
- une case à cocher permettant de déactiver l'action
- un numéro de ligne ou un label qui permettra de l'identifier
- une liste de paramètres
- un commentaire (optionnel)
Il est également possible de paramétrer une pause avant et après l'action ainsi qu'un temps d'exécution maximum.
Numéro de ligne/label
Le numéro de ligne ou label permet de définir la cible d'un changement de position dans le script.
Un label permet de définir un emplacement fixe dans le script, au contraire du numéro de ligne.
Pour définir un label, double-cliquez sur la partie gauche de la ligne de l'action. Ne pas entrer de texte supprime le label. Même si un label existe, il est toujours possible d'utiliser le numéro de ligne pour identifier l'action.
Liste de paramètres
Paramètres d'entrée
Les paramètres d'entrée (fond violet) peuvent être de plusieurs types et peuvent également être vides. Dans ce cas, la valeur par défaut sera utilisée.
Paramètres de sortie
Les paramètres de sortie (fond jaune) vous permettent de récupérer des données après que l'action ait été exécutée. Ces données sont stockées dans des variables dont le nom est la valeur du paramètre de sortie correspondant.
Paramètres communs
Certains paramètres sont communs à toutes les actions :
- pause avant : pause à effectuer avant d'exécuter l'action
- pause après : pause à effectuer après avoir exécuté l'action
- temps d'exécution maximum : temps d'exécution au bout duquel une exception de Délai écoulé est déclenchée
Exceptions
Les exceptions sont des évènements pouvant être déclenchés durant l'exécution d'une action.
Il s'agit le plus souvent d'une erreur dans le paramétrage de l'action. Une exception est également déclenchée lorsque la durée d'exécution maximum d'une action est écoulée.
Suivant le paramétrage une exception peut interrompre l'exécution du script, passer l'action courante ou aller à une autre ligne du script.
Commentaire
Il est également possible d'entrer un commentaire pour aider à identifier ce que fait une action.
Couleur
Chaque action peut également avoir une couleur de fond. Cela peut permettre d'identifier visuellement des groupes d'actions. Sélectionnez une ou plusieurs action(s) et choisissez "Couleur de l'action" → "Changer la couleur de l'action" ou pressez Ctrl+E pour modifier la couleur de fond.
Listes des actions
Voici les actions officielles d'Actionaz 3.
Fenêtres
Les actions de cette catégorie agissent sur le système de fenêtrage du système d'exploitation.
- Boîte de dialogue : affiche un message ou pose une question
- Condition de fenêtre : vérifie si une fenêtre existe et agit en conséquence
- Entrée de donnée : demande à l'utilisateur d'entrer une donnée
- Liste de sélection : demande à l'utilisateur de choisir un élément parmi une liste
- Fenêtre : agit sur une fenêtre
Périphériques
Ces actions agissent sur les périphériques de l'ordinateur.
- Chemin du curseur : déplace le curseur de la souris le long d'un chemin
- Clic : simule un clic de souris
- Déplacement du curseur : déplace le curseur de la souris à un endroit de l'écran
- Molette : simule le mouvement de la molette de la souris
- Touche : simule la pression d'une touche
- Écriture de texte : simule l'écriture de texte
Système
Ces actions agissent directement sur le système d'exploitation.
- Commande : exécute une commande ou démarre un processus
- Commande détachée : exécute une commande ou démarre un processus en mode détaché
- Couleur de pixel : vérifie la couleur d'un pixel à l'écran et agit en conséquence
- Fermer processus : ferme un processus
- Lire son : lit un fichier son ou un flux distant
- Ouvrir URL : ouvre une URL avec le navigateur par défaut
- Notification : affiche une notification (GNU/Linux seulement)
- Système : redémarre, arrête, ou met en veille le système d'exploitation
- Trouver image : recherche une image sur l'écran, dans une fenêtre ou dans une autre image
Interne
Ces actions agissent sur l'exécution du script.
- Aller à : change l'action suivante à exécuter
- Aucune opération : n'effectue aucune action
- Boucle : change l'action suivante à exécuter un certain nombre de fois
- Code : exécute du code Javascript
- Condition de variable : vérifie la valeur d'une variable et agit en conséquence
- Condition temporelle : vérifie une condition temporelle et agit en conséquence
- Console : écrit une entrée dans la console d'Actionaz
- Pause : met en pause l'exécution du script pour une certaine durée
- Quitter Actionaz : quitte le programme
- Variable : agit sur une variable
- Stop : arrête l'exécution du script
Données
Ces actions agissent sur des données.
- Copier fichier : copie un fichier
- Lire fichier INI : lit une entrée d'un fichier INI
- Lire fichier binaire : lit des données d'un fichier binaire
- Lire fichier texte : lit un fichier texte
- Lire presse-papiers : lit le contenu du presse-papiers
- Lire registre : lit une entrée de la base de registre (Windows seulement)
- Lire variables d'environnement : lit une ou toutes les variables d'environnement (Depuis Actionaz 3.6.0)
- Écrire fichier INI : écrit une entrée d'un fichier INI
- Écrire fichier binaire : écrit des données dans un fichier binaire
- Écrire fichier texte : écrit dans un fichier texte
- Écrire presse-papier : écrit le contenu du presse-papiers
- Écrire registre : écrit une entrée dans la base de registre (Windows seulement)
- Téléchargement Web : télécharge une page web ou un fichier à partir du Web
Procédures
Ces actions permettent de créer et d'utiliser des procédures.
- Début de procédure: déclare une nouvelle procédure
- Fin de procédure: termine une déclaration de procédure
- Appel de procédure: appelle une procédure