Votre premier script

Création d'un fichier .au3

Ce tutoriel explique les bases de la création d'un script AutoIt et comment le lancer. Ce tutoriel considère que vous avez déjà installé complètement AutoIt v3 à l'aide de la sous-partie "Téléchargement et installation".

Toutes les images des fenêtres et boites de dialogue sont en anglais (traduction oblige) donc les différentes informations affichées le seront aussi. Certains termes utilisés seront francisés, pour correspondre à ce que vous verrez sur votre machine, mais d'autres non !

Quelle que soit la manière dont vous avez installé Autoit, la création d'un script ne varie pas.
Pour commencer, créez un dossier sur le bureau dans lequel vous placerez tous les scripts de ce tutoriel. Ouvrez ce dossier avec l'explorateur Windows.
En faisant un clic droit dans le dossier puis en sélectionnant "Nouveau", vous constaterez qu'une nouvelle possibilité vous est offerte : "AutoIt v3 Script". Cliquez donc !

Un nouveau fichier est créé, et vous êtes invité à le renommer en quelque chose de plus approprié.
Remplacez 'Nouveau AutoIt v3 Script.au3' par 'helloworld', tout en laissant l'extension '.au3' si elle est visible.

Maintenant que nous avons créé le fichier, nous allons l'éditer afin d'en faire quelque chose d'utile. Faites un clic droit sur helloworld.au3 et sélectionnez "Edit Script" (ou "Éditer le Script" si vous avez installé le Pack AutoIt-Fr).

L'éditeur Scite4Autoit, ou votre éditeur préféré pour les plus expérimentés, devrait s'ouvrir.
Vous allez maintenant pouvoir écrire votre premier script.

Les commentaires

L'éditeur SciTE vient de s'ouvrir et vous verrez quelque chose comme ceci :

C'est quoi ces écritures vertes qui se sont infiltrées dans mon beau fichier ?

Le code que vous voyez est simplement une suite de commentaires que vous pouvez utiliser pour organiser vos scripts. Toutes les lignes qui commencent par un point virgule ; sont considérées comme des commentaires et seront donc ignorées.
Les commentaires sont très importants car ils vous permettent de ne pas vous perdre quand le fichier devient important, de pouvoir partager votre script avec le voisin sans qu'il en comprenne un mot en lui facilitant la compréhension, et quelques fois d'aérer votre code. Ne lésinez pas sur les commentaires, ils vous seront utiles un jour.

; est similaire à la déclaration REM dans un traitement par lots DOS, ou encore à // en PHP.

Vous pourrez parfois rencontrer ;~ qui introduit également un code commenté généralement par Scite4AutoIt. En effet, cet éditeur vous permet de "commenter par blocs" votre script. Vous n'avez qu'à sélectionner les lignes de code, appuyer sur le - du pavé numérique pour commenter/décommenter vos lignes à votre guise.

Plus rarement, vous croiserez également #comments-start qui peut être réduit à #cs et #comments-end qui peut être réduit à #ce qui permet la saisie de textes beaucoup plus longs, sans être obligé d'utiliser le ";" des lignes de commentaires.
Cette commande est par exemple utilisée au début de votre script pour indiquer le nom du script, l'auteur, la fonction du script, l'aide associée, etc...

En bref, vous pouvez supprimer ces lignes, elles ne servent à rien.

Afficher une boîte de dialogue

Maintenant, nous allons dire à AutoIt d'afficher une boîte de dialogue, pour cela nous allons utiliser la fonction MsgBox.

En dessous des lignes de commentaires, tapez ceci :
Code : Autre

1	MsgBox(0, "Tutorial", "Hello World!")

Toutes les fonctions ont des paramètres, MsgBox en a trois :

un flag : paramètre généralement numérique ou booléen ;
un titre : paramètre attendant une chaîne de caractères ;
un message : paramètre attendant une chaîne de caractères.

Le flag est un nombre qui change la manière d'afficher la MsgBox − nous utiliserons 0 pour l'instant, et nous en reparlerons ci-dessous.
Le titre et le message sont tous les deux une String (chaîne de caractères) : quand on utilise des Strings dans AutoIt il faut encadrer le texte avec de simples guillemets (apostrophes) ou doubles guillemets. "Ceci est du texte" ou 'Ceci est du texte' − les deux fonctionneront parfaitement.

Pour inclure une apostrophe dans une chaîne encadrée par des guillemets simples, il faut la doubler.

Exemples

Code : Autre

1	MsgBox(0, "Tutorial", 'Ceci est une partie d''un texte')

Code : Autre

1	MsgBox(0,"Tutorial", "Avec AutoIt c'est ""simple""")

Le code ci-dessus n'étant pas très digeste, on préférera utiliser le code ci-dessous :
Code : Autre

1	MsgBox(0,'Tutorial', 'Avec AutoIt c''est "simple"')

Ou encore

Code : Autre

1	MsgBox(0,'Tutorial', "Avec AutoIt c'est"&'"simple"')

Très bien, maintenant enregistrez le script et quittez l'éditeur. Vous venez d'écrire votre tout premier script AutoIt !
Pour le lancer, double-cliquez simplement sur le fichier 'helloworld.au3'.
Vous pouvez aussi faire un clic droit et sélectionner "Run Script" (ou "Lancer le Script" si vous avez installé le Pack AutoIt-Fr).

Vous devriez voir ceci : Image utilisateur

Maintenant, vous savez dire 'Bonjour' grâce à Autoit, c'est déjà un début.

Les 'flags'

Nous allons maintenant nous intéresser de plus près au 'flag' de la fonction MsgBox.

Pour cela, nous allons utiliser l'aide fournie. Cette aide est précieuse et il faut savoir l'utiliser. Il vous suffit d'appuyer sur F1 quand Scite est lancé. Et je dirai même plus, il vous suffit de cliquer avec la souris sur MsgBox puis d'appuyer sur F1 pour obtenir directement l'aide liée à la fonction.

Dans la page d'aide de Autoit concernant cette commande, nous pouvons voir différentes valeurs listées qui changent la manière d'afficher la MsgBox.
La valeur 0 affiche une simple boîte de dialogue avec un bouton OK. Une valeur de 64 affiche la boîte de dialogue avec une icône d'information.

Éditez le script en faisant un clic droit sur le fichier helloworld.au3, puis Edit Script (ou "Éditer le Script" si vous avez installé le Pack AutoIt-Fr), et remplacez le 0 par 64. Vous avez donc :

Code : Autre

1	MsgBox(64, "Tutorial", "Hello World!")

Enregistrez le script puis lancez-le (vous pouvez aussi appuyer sur la touche F5 dans la fenêtre d'édition pour lancer le script à partir de l'éditeur).

N'hésitez pas à expérimenter avec différentes valeurs pour le paramètre flag afin de voir quel genre de résultat vous obtiendrez.

Si vous voulez combiner plusieurs valeurs de flag, vous n'avez qu'à tout simplement additionner les valeurs souhaitées.

Par exemple:

Code : Autre

1	MsgBox(4 + 32, "Tutorial", "Vous allez bien ?")

La commande MsgBox possède plusieurs groupes de valeurs pour le flag.
Chaque groupe permet d'influencer les boutons (nombre et fonction), le bouton par défaut, l'icône affichée, le comportement de la fenêtre, etc.
Il existe aussi un groupe spécial qui permet même de savoir quel bouton a été appuyé afin de gérer une action en fonction d'un choix.

Si vous avez installé Scite4AutoIt ou le Pack AutoIt-Fr, vous trouverez dans le dossier C:\Program Files\AutoIt3\SciTE\CodeWizard l'application CodeWizard.exe qui vous permettra de tester les différentes combinaisons de boîte de dialogue ainsi que d'autres types de contrôles pris en charge par Autoit.

Retour en haut

9 commentaires pour "Votre premier script"

Note moyenne : 3.56 / 4 (100 votes)

Pseudo	Commentaire
timmalos	# Posté le 30/08/2010 à 16:32:37
Avis : Très bon Études : INSA Lyon	Ces tutoriels etant officiels en anglais, je pense que tu ne vois pas d'inconvénients a ce que nous les ayons traduits et adaptés pour le sdz. Pourquoi refaire la roue? Le tutoriel sur cette partie existait, et je comptais bien m'en servir car certains sont anglophobes. Tu aurais même pu donner leur version déjà traduite disponible ici : http://www.autoitscript.fr/autoit3/doc [...] ip/winzip.htm et http://www.autoitscript.fr/autoit3/doc [...] d/notepad.htm Ces liens n'ont pas été donné car ils sont utilisés dans des chapitres qui n'ont pas encore été terminés et mis en ligne, mais quand le tuto sera terminé ne t'inquiète pas ils y figureront. Merci pour les commentaires, TIm
neiwak	# Posté le 17/06/2011 à 20:51:38
	Moi j'ai un message d'erreur quand je lance le script : Une fenêtre s'ouvre et me dit : line14 (..): MsgBox(1,"Tutorial","Helle World") MsgBox(1,"Tutorial", ^ERROR Error : Unable to parse line.
timmalos	# Posté le 18/06/2011 à 09:28:12
Avis : Très bon Études : INSA Lyon	Peut tu m'en dire plus neiwak?Quelle version d'autoit? Je te conseille de créer un post sur le forum du SDZ ou autoitscript.fr pour que je puisse t'aider, je n'ai pas pour vocation à résoudre les problèmes dans les commentaires du tutoriel Difficile de t'aider avec si peu, car ta ligne simple marche très bien.
plasmachauvire	# Posté le 24/11/2011 à 20:18:21
Image perso, by me XD	MsgBox (0,"Tutorial","Hello World!") à la place de MsgBox (0, "Tutorial", "Hello World!") et ça devrai marcher ( ça l'a fait pour moi ) En fait, la petite différence c'est l'espace que j'ai enlevé entre 0, et "Tutorial" et entre "Tutorial", et "Hello Mon blog Sujets / Articles présents sur mon blog. Amusez-vous bien ! Divers trucs drôles Le blog Liens One Piece Statistiques Grépolis Quelques musiques BD "Trolls de Troy" Quelques citations humouristiques Vidéos de gags [PSP] Jeux gratuits sans cracker sa PSP !
Kaptain_Kinder	# Posté le 24/05/2012 à 18:59:33
Lorsque l'on s'arroge le droit	Je n'ai pas de privilège admin sur mon ordi, je n'ai donc pas Autoit. Est-ce que c'est quand même possible de coder avec notepad++? Parce que quand j'ouvre avec firefox ou internet explorer, ça m'affiche mon code, et non la boite de dialogue, pour le début du tuto. 90% of teens today would die if Facebook was completely destroyed. If you are one of the 10% that would be laughing, copy and paste this to your signature.