Mot-cl�s AutoIt

#include

Inclus un fichier UDF dans un script.

#include "[path\]filename"
#include <filename>

Param�tre

filename

Le nom du fichier � inclure. Le chemin est optionnel. Doit �tre une cha�ne de caract�res -- Ne peut �tre une variable.
Si "..." est utilis�, le nom du fichier est cherch� de mani�re relative � partir du r�pertoire courant du script en cours.
Si <...> est utilis�, le nom du fichier est cherch� dans le r�pertoire des biblioth�ques des fichiers 'include' (habituellement C:\Program Files\AutoIt3\Include). Cette biblioth�que contient beaucoup de fonctions utilisateur pr�-�crites et pr�tes � vous servir !

Remarques

Dans un script AutoIt, d'autres scripts peuvent �tre inclus en utilisant la commande "#include".

Si vous incluez le m�me fichier contenant une fonction utilisateur plus d'une fois, vous aurez une erreur "Duplicate function". Lors de l'�criture d'un fichier include qui sera utilis� de cette mani�re, n'oubliez pas de rajouter dans les premi�res lignes #include-once pour �viter que ce fichier ne soit inclut plus d'une fois.

Il existe une valeur sp�ciale dans le registre qui peut �tre cr��e dans "HKEY_CURRENT_USER\Software\AutoIt v3\AutoIt" appel�e "Include". Elle doit �tre une valeur REG_SZ (cha�ne). Le contenu de cette valeur est une liste de r�pertoires s�par�s par une virgule, dans laquelle les fichiers seront recherch�s lors d'un #include, en plus des localisations standard.

L'ordre de recherche utilis� par AutoIt d�pend du format utilis� pour #include. Le tableau ci-dessous montre l'ordre de recherche des r�pertoires pour les deux formats.

Utilisation de #include <>

Biblioth�que standard	Le chemin de l'interpr�teur en cours d'ex�cution compl�t� par "\Include" … est recherch�.
Biblioth�ques d�finies par l'utilisateur	La valeur du registre mentionn� ci-dessus est lue et chaque r�pertoire est recherch� suivant l'ordre d'apparition dans cette valeur.
Script directory	Le r�pertoire du script en cours d'ex�cution.

Utilisation de #include "" (En opposition � #include <>).

R�pertoire du script	Le r�pertoire du script en cours d'ex�cution.
Librairies d�finies par l'utilisateur	La valeur du registre mentionn� ci-dessus est lue et chaque r�pertoire est recherch� suivant l'ordre d'apparition dans cette valeur.
Librairie standard	Le chemin de l'interpr�teur en cours d'ex�cution compl�t� par "\Include", est recherch�.

Note � propos de l'utilisation de l'option /AutoIt3ExecuteScript.
Depuis qu'une biblioth�que standard est recherch�e dans le r�pertoire courant de l'interpr�teur, les fonctions d'une biblioth�que standard ne seront plus trouv�es; cette biblioth�que ne sera trouv�e qu'avec l'utilisation de AutoIt3.exe. Il est donc recommand� de compiler le script au format .a3x avant de le lancer avec /AutoIt3ExecuteScript.

Aut2Exe utilise le m�me algorithme qu'AutoIt3.exe avec pour seule diff�rence qu'il cherche le sous-r�pertoire Include dans un r�pertoire fr�re � lui m�me (..\Include).

Si Opt("TrayIconDebug",1) est utilis�, seulement 64 noms de fichiers include peuvent �tre affich�s dans la bulle d'info de la barre des t�che. Pour les autres, aucun nom de fichier ne sera affich�.

En relation

#include-once

Exemple

#include "include-TIME.au3"

MsgBox($MB_SYSTEMMODAL, "", "Example")
#include <MsgBoxConstants.au3>
Exit

; L'ex�cution de script.au3 affichera deux messages:
; un avec "Example", l'autre avec l'heure.