Scite4AutoIt3

Scite4AutoIt3

Tutoriel sur les outils :
– CodeWizard
– Tidy
– SciTEConfig
– Koda
– Scite Jump
– Open Include
– OrganizeIncludes
Les raccourcis clavier de Scite4AutoIt3

Scite4AutoIt3.exe est un éditeur de texte (gratuit) multi plate-forme. SciTE4AutoIt3 contient SciTE et ceci dans un seul programme d’ installation avec tous les réglages et options : AutoIt3Wrapper , SciTEConfig ,CodeWizard, Tidy, etc…
Le Lexer personnalisé pour AutoIt3 gère la coloration syntaxique et le pliage de code.

Image
Les outils
La liste complète par défaut est longue nous allons voir ici quelques exemples.
Modification de la liste sous SciTe Config > Tools Sélection
Image
Pour commencer surement un indispensable
CodeWizard
Menu Outils ou Alt+W
Permet de créer une MsgBox, un ToolTip, ou un InputBox à mot de passe, etc … CodeWizard va vous faciliter la tâche.
  • Message Box : Affiche une simple boîte de message, avec temporisation optionnelle.
  • Input Box : Affiche une boîte de saisie pour demander à l’utilisateur de saisir une chaîne.
  • ToolTip : Crée une info-bulle n’importe où sur l’écran.
  • SplashText : Crée une fenêtre de texte popup personnalisable.
  • SplashImage : Crée une fenêtre d’image popup personnalisable.
  • GUISetBkColor : Définit la couleur de fond de la fenêtre GUI.
  • GUICtrlSetColor : Définit la couleur du texte d’un contrôle.
  • GUICtrlSetBkColor : Définit la couleur de fond d’un contrôle.
  • GUICtrlSetFont : Définit la police d’un contrôle.
  • GUICtrlSetCursor : Définit l’icône du curseur de la souris pour un contrôle particulier.
– MsgBox (Boite de message) pour afficher une information ou confirmer une action.
Image
Cliquer sur Copy 2 SciTE pour afficher le code
Image
InputBox permet de saisir une valeur au clavier.
Image
ToolTip (Infobulle)message qui apparaît lors du passage du pointeur de la souris
Image
Splash Text Crée une fenêtre de texte personnalisable.
Image
Splash Image Crée une fenêtre d’image popup personnalisable
Image
Ensuite nous avons deux onglets qui nous permettent de gérer les couleurs et pointeur.
Image
Image
Tidy AutoIt Source
Menu Outils ou Ctrl+T
Soit via le menu Outils ou Ctrl+T
Il permet de contrôler, nettoyer et de bien présenter votre script.
– Lien
– Nettoie l’indentation.
– Change toutes les fonctions / Mots-clés / Macros comme dans les fichiers de configuration.
– Toutes les fonctions de l’utilisateur et toutes les définitions Func dans le script sont chargés dans la table des fonctions.
– Normalise tous les noms de variables en majuscules, minuscules ou majuscules à la première déclaration / événement.
– Ajoute un espace ou supprimer des espaces supplémentaires autour des opérateurs / mots-clés / fonctions.
– Retire les lignes vides.
– Retire les espaces de fin.
– Ajoute le nom de la fonction comme un commentaire après EndFunc (fin de la fonction).
– Génère un fichier de documentation avec la logique du programme et des rapports Xref pour les variables et UDF.
– Vérifie les erreurs de codage comme manquant EndIf / WEnd ou la définition d’un Func intérieur d’une boucle.
– Trier tous les blocs Func-EndFunc dans l’ordre alphabétique limité par # règion- blocs # de endRegion si utilisés
Pour l’exemple j’ai pris deux fonctions et j’ai mis un peu la bazar :III
Avant le passage de Tidy
Image
Après avoir cliqué sur Tidy
Image
SciTEConfig
Menu Outils ou Ctrl+1
L’utilitaire a 5 onglets qui permettent le réglage de diverses options dans SciTE4AutoIt3:
– Onglet General 1
Explorateur AU3 Paramètres fichier:
Lors de l’installation Autoit il y a une option soit : Exécuter ou modifier les fichiers .au3. Cela vous permet de modifier cette option.
Stratégie de sauvegarde:
SciTE peut conserver des copies de sauvegarde de votre script chaque fois que vous modifiez et enregistrez puis, exécutez ou compilez – si vous avez plus d’un, ils sont nommés « filename_old1.au3 « , « filename_old2.au3 « , « filename_old3.au3  » etc… .
Paramètres du dossier AutoIt3:
Le chemin de l’installation de AutoIt est affiché. L’entrée vous permet de définir un utilisateur pour les UFD inclus.
AutoIt Script de la police:
Utilisez ces options pour sélectionner la police utilisée – la valeur par défaut est de 10pt.
Divers:
Auto-Propercase qui modifiera la capitalisation (écriture) des mots-clés dans le script pour correspondre à celui défini dans les fichiers de configuration.

Image
– Onglet General 2

Erreurs Inline:
Définissez la couleur pour les erreurs de surbrillance et les avertissements de Au3Check – et si elles doivent apparaître.
Mot courant Highlight:
Définissez si SciTE mettra en évidence toutes les occurrences du texte sélectionné. D’autres options permettent au texte d’être étroitement défini avec la couleur de surbrillance.
Fonction CallTip et Paramètre Highlight:
Lors de la saisie des paramètres pour une fonction, SciTE affiche les paramètres pertinents et mettre en évidence la prochaine requise. La position et la couleur de ce calltip peuvent être modifiés.

Image
– Onglet Éditeur de couleurs
Sur cet onglet, vous pouvez sélectionner les couleurs que l’éditeur SciTE utilisera pour différents éléments de votre code. Les nouvelles couleurs sont appliquées immédiatement.
Image
– Onglet Sélection Outils
Par défaut, tous les outils sont affichés dans le menu Outils. Décocher une case pour masquer l’entrée de cet outil dans le menu.
Image
– Onglet Autres outils
– Les deux premiers outils gèrent les abréviations et les appels des appels UDF.
– Le troisième outil extrait les paramètres spécifiques de registre de AutoIt pour aider dans le débogage des problèmes de configuration.
– Les deux derniers ouvre les fichiers .ini cités.
Image
Koda
Scite Jump
Menu Outils ou Alt+Q
Cet outil est très utile dans la construction d’un code si celui-ci s’avère important. Il va nous aider à naviguer plus facilement (par exemple vous avez un code de 1000 lignes), vous pouvez ajouter des commentaires pour vous repérer dans votre code et aller facilement (1 clic) au commentaire sélectionné.
Image
Via la petite flèche en haut à gauche vous pouvez créer également vos includes et agir sur les paramètres de Scite Jump.
Image
Open Include
Menu Outils ou Alt+I
Ici il faut sélectionner l’include désirée et appuyer sur les touches Alt+I. Exemple nous voulons savoir ce que contient #include « MsgBoxConstants.au3 » donc on sélectionne par un clique sur la ligne puis on enfonce les touches Alt+I et un nouvel onglet s’ouvre avec le contenu
Exemple :

Code : Tout sélectionner

#include-once

; #INDEX# =======================================================================================================================
; Title .........: MsgBox_Constants
; AutoIt Version : 3.3.14.2
; Language ......: English
; Description ...: Constants to be included in an AutoIt v3 script when using function MsgBox.
; Author(s) .....: guinness, jpm
; ===============================================================================================================================

; #CONSTANTS# ===================================================================================================================
; Message Box Constants
; Indicates the buttons displayed in the message box
Global Const $MB_OK = 0 ; One push button: OK
Global Const $MB_OKCANCEL = 1 ; Two push buttons: OK and Cancel
Global Const $MB_ABORTRETRYIGNORE = 2 ; Three push buttons: Abort, Retry, and Ignore
Global Const $MB_YESNOCANCEL = 3 ; Three push buttons: Yes, No, and Cancel
Global Const $MB_YESNO = 4 ; Two push buttons: Yes and No
Global Const $MB_RETRYCANCEL = 5 ; Two push buttons: Retry and Cancel
Global Const $MB_CANCELTRYCONTINUE = 6 ; Three buttons: Cancel, Try Again and Continue
Global Const $MB_HELP = 0x4000 ; Adds a Help button to the message box. When the user clicks the Help button or presses F1, the system sends a WM_HELP message to the owner.

; Displays an icon in the message box
Global Const $MB_ICONSTOP = 16 ; Stop-sign icon
Global Const $MB_ICONERROR = 16 ; Stop-sign icon
Global Const $MB_ICONHAND = 16 ; Stop-sign icon
Global Const $MB_ICONQUESTION = 32 ; Question-mark icon
Global Const $MB_ICONEXCLAMATION = 48 ; Exclamation-point icon
Global Const $MB_ICONWARNING = 48 ; Exclamation-point icon
Global Const $MB_ICONINFORMATION = 64 ; Icon consisting of an 'i' in a circle
Global Const $MB_ICONASTERISK = 64 ; Icon consisting of an 'i' in a circle
Global Const $MB_USERICON = 0x00000080

; Indicates the default button
Global Const $MB_DEFBUTTON1 = 0 ; The first button is the default button
Global Const $MB_DEFBUTTON2 = 256 ; The second button is the default button
Global Const $MB_DEFBUTTON3 = 512 ; The third button is the default button
Global Const $MB_DEFBUTTON4 = 768 ; The fourth button is the default button.

; Indicates the modality of the dialog box
Global Const $MB_APPLMODAL = 0 ; Application modal
Global Const $MB_SYSTEMMODAL = 4096 ; System modal
Global Const $MB_TASKMODAL = 8192 ; Task modal

; Indicates miscellaneous message box attributes
Global Const $MB_DEFAULT_DESKTOP_ONLY = 0x00020000 ; Same as desktop of the interactive window station
Global Const $MB_RIGHT = 0x00080000 ; The text is right-justified.
Global Const $MB_RTLREADING = 0x00100000 ; Displays message and caption text using right-to-left reading order on Hebrew and Arabic systems.
Global Const $MB_SETFOREGROUND = 0x00010000 ; The message box becomes the foreground window
Global Const $MB_TOPMOST = 0x00040000 ; The message box is created with the WS_EX_TOPMOST window style.
Global Const $MB_SERVICE_NOTIFICATION = 0x00200000 ; The caller is a service notifying the user of an event.

Global Const $MB_RIGHTJUSTIFIED = $MB_RIGHT ; Do not use, see $MB_RIGHT. Included for backwards compatibility.

; Indicates the button selected in the message box
Global Const $IDTIMEOUT = -1 ; The message box timed out
Global Const $IDOK = 1 ; OK button was selected
Global Const $IDCANCEL = 2 ; Cancel button was selected
Global Const $IDABORT = 3 ; Abort button was selected
Global Const $IDRETRY = 4 ; Retry button was selected
Global Const $IDIGNORE = 5 ; Ignore button was selected
Global Const $IDYES = 6 ; Yes button was selected
Global Const $IDNO = 7 ; No button was selected
Global Const $IDCLOSE = 8 ; Close button was selected
Global Const $IDHELP = 9 ; Help button was selected
Global Const $IDTRYAGAIN = 10 ; Try Again button was selected
Global Const $IDCONTINUE = 11 ; Continue button was selected
; ===============================================================================================================================
OrganizeIncludes
Menu Outils ou Ctrl+Shift+Alt+I

Cet outil peut être utile quand on débute avec AutoIt (quoique… ;D)
Vous créez par exemple cette ligne

MsgBox($MB_ICONWARNING, « Mon titre », « Cette boîte de message sera fermée après 10 secondes ou si le bouton OK est préssé avant. », 10)

Si vous faites F5 pour exécuter vous aurez une erreur du à la variable $MB_ICONWARNING qui dans l’include a comme valeur 48.
Vous pouvez remarquer que la ligne à été désactiver du code avec la touche moins du pavet numérique.
Cette erreur indique que la variable n’est pas déclaré, il faut dans ce cas inclure cette include pour valider la variable dans le script en cours.
(vous aurez donc compris que si vous remplacez $MB_ICONWARNING par 48 vous n’aurez pas ce soucis de déclaration (voir ci-dessus l’extraction « Open Include » )

Image

Quand vous faites appel à OrganizeIncludes vous aurez cette fenêtre :

Image

Cliquez sur OrganizeIncludes et dans votre code l’include s’affichera.

Image
Image
Les raccourcis clavier de Scite4AutoIt3
Certains raccourcis peuvent être très utiles dans la manipulation du code, prendre le temps d’apprendre ces raccourcis permettra de gagner du temps plus tard. :D
En couleur les indispensables.
  • F1 : Affiche l’aide, pour l’avoir en français télécharger la version française est déposer ce fichier (AutoIt.chm) dans le dossier C:\Program Files (x86)\AutoIt3
    Renommer avant votre fichier d’origine. Exemple : AutoItO.chm
  • Ctrl+F2 : Permet de marquer ou démarquer une ligne. Le marqueur est un rond de couleur blue qui permet de sélectionner des lignes à travailler.
  • F2 : Marqueur suivant.
  • Shift+F2 : Marqueur précédent.
  • F3 : Recherche suivante
  • Shift+F3 : Recherche précédente
  • F5 : Exécuter le script (CTRL+F5 debug le script)
  • F6 : Bascule d’un onglet à l’autre de gauche à droite.
  • Shift+F6 : Bascule d’un onglet à l’autre de droite à gauche.
  • CTRL+F6 : Autoit Windows Info.
  • F7 : Compilation.
  • CTRL+F7 : Compilation avec Wrapper. :sup:
  • CTRL+1 : Config de Scite (Préférences)
  • CTRL+D : Copie la ligne en cours
  • CTRL+F : Rechercher
  • CTRL+H : Remplacer : Ce raccourci vous permettra de rechercher, remplacer, tout ou dans la sélection et les onglets. (Très pratique)
  • CTRL+Q : Commente la ligne sélectionné (Équivalent au symbole « – » du pavé numérique).
  • CTRL+T : Tidy vous remet au carré le code (en vous créant un dossier de backup)
  • Ctrl+Maj+L Supprime la ligne sélectionnée (utile pour faire un brin de ménage), pas besoin sélectionner la ligne 1 clic et la combinaison.
  • CTRL+SPACE : Affiche le complètement automatique de la saisie au clavier
  • CTRL+Shift+Alt+i : Organisation des includes
  • Alt+I : Ouverture de l’include.
  • Alt+M : Koda FromDesigner pour vos constructions de d’interface.
  • Alt+Q : Ouverture de Scite Jump
  • Alt+W : Ouverture de Code Wizard