Functions > Misc >


AutoItSetOption

Change le mode de fonctionnement de divers fonctions/param�tres d'AutoIt.

AutoItSetOption ( "option" [, param] )

Param�tres

option L'option � changer (voir Remarques).
param [optionnel] La valeur � assigner � l'option. Le type et la signification varient selon l'option. Voir Remarques ci-dessous. Si le param�tre n'est pas indiqu�, alors la fonction retourne la valeur qui lui est assign�e. Le mot cl� Default peut �tre utilis� en param�tre pour r�initialiser la valeur par d�faut de l'option.

Valeur de retour

Succ�s: Retourne la valeur du param�tre pr�c�dent pour l'option.
�chec: D�finit @error <> 0. L'�chec peut se produire si les param�tres sont invalides (tel qu'un param�tre qui n'existe pas).

Remarque

Vous pouvez utiliser Opt() comme alternative � AutoItSetOption().

Les param�tres sont les suivants:
Option Param
CaretCoordMode D�termine la mani�re dont les coordonn�es sont utilis�es dans les fonctions 'caret'. Soit coordonn�es absolues, soit coordonn�es relatives � la fen�tre active courante:
0 = Coordonn�es relatives � la fen�tre active
1 = (par d�faut) Coordonn�es absolues dans l'�cran
2 = Coordonn�es relatives � la zone client de la fen�tre active
ExpandEnvStrings Change la fa�on dont les cha�nes litt�rales et les symboles % sont interpr�t�s. Par d�faut les cha�nes sont trait�es litt�ralement. Ce param�tre vous permet d'utiliser les variables %environnement% � l'int�rieur des cha�nes. Exemple : "Le r�pertoire temporaire est : %temp%".
0 = (d�faut) N'�tend pas les variables d'environnement
1 = �tend les variables d'environnement (similaire � AutoIt v2)
Sans cette option, la m�thode classique est : "Le r�pertoire temporaire est : " & EnvGet("temp") ;
ExpandVarStrings Change la m�thode d'interpr�tation des cha�nes litt�rales et des symboles variable/macro ($ et @). Par d�faut les cha�nes sont trait�es litt�ralement. Ce param�tre vous permet d'utiliser les variables et les macros � l'int�rieur des cha�nes. Exemple : "La valeur de var1 est $var1$".
0 = (par d�faut) N'�tend pas l'utilisation des variables dans des cha�nes 1 = �tend les variables (Lorsque vous �tes dans ce mode et que vous voulez utiliser les symboles $ ou @ alors doublez les : "Ceci est le symbole dollar $$".
GUICloseOnESC Lorsque la touche ESC est press�e dans une GUI le message $GUI_EVENT_CLOSE est envoy�. Cette option active/d�sactive ce comportement.
0 = N'envoie pas le message $GUI_EVENT_CLOSE lorsque la touche ESC est press�e.
1 = (d�faut) Envoie le message $GUI_EVENT_CLOSE lorsque la touche ESC est press�e.
GUICoordMode Modifie la position d'un contr�le d�fini par GUICtrlSetPos().
0 = Position relative par rapport au coin sup�rieur gauche du dernier contr�le.
1 = (d�faut) Coordonn�es absolues toujours relatives � la boite de dialogue.
2 = Positionnement de cellule relative � la cellule actuelle. Un -1 en param�tre gauche ou haut n'incr�mente pas le d�but.
Donc la ligne est -1,offset; la cellule suivante est offset,-1; la cellule actuelle est -1,-1.
�videmment le 'offset' ne peut pas �tre �gal � -1 qui est r�serv� pour indiquer la non-incr�mentation. Mais si vous pouvez utiliser un multiple de la largeur vous choisissez de sauter ou revenir.
GUIDataSeparatorChar D�finit le caract�re de d�limitation des sous-�l�ments dans GUICtrlSetData().
Le caract�re par d�faut est '|'.
GUIOnEventMode Active/D�sactive les notifications des fonctions OnEvent.
0 = (d�faut) D�sactive.
1 = Active.
GUIResizeMode Change le mode de redimensionnement par d�faut d'un contr�le.
0 = (d�faut) Garde le mode de redimensionnement par d�faut.
<1024 = n'importe quel type de redimensionnement. Consultez GUICtrlSetResizing().
GUIEventOptions Change le comportement d'�v�nement sp�cial ou les valeurs de retour de fonction GUI.
0 = (d�faut) Comportement normal d'une fen�tre lors d'un clic sur Minimize, Restore, Maximize, Resize.
1 = Supprime le comportement normal d'une fen�tre lors d'un au clic sur Minimize, Restore, Maximize, Resize. Envoie la notification seulement.
MouseClickDelay Modifie la dur�e de la pause entre les clics de souris.
Temps de pause en millisecondes (d�faut = 10).
MouseClickDownDelay Modifie la dur�e de maintien du clic avant rel�chement.
Temps de pause en millisecondes (d�faut = 10).
MouseClickDragDelay Modifie la dur�e de la pause entre le d�but et � la fin d'une op�ration Drag.
Temps de pause en millisecondes (d�faut = 250).
MouseCoordMode D�termine la mani�re d'utiliser les coordonn�es dans les fonctions de souris, soit coordonn�es absolues, soit coordonn�es relatives � la fen�tre active courante:
0 = Coordonn�es relatives � la fen�tre active
1 = (d�faut) Coordonn�es absolues d'�cran
2 = Coordonn�es relatives � la zone client de la fen�tre active
MustDeclareVars Si ce param�tre est utilis�e, alors toutes les variables doivent �tre pr�-d�clar�es avec Local, Global ou Dim dans quelques cas, avant d'�tre utilis�es - diminue le risque d'une erreur d'orthographe dans le nom d'une variable qui cause des bugs.
0 = (d�faut) Les variables n'ont pas besoin d'�tre pr�-d�clar�e
1 = Les variables doivent �tre pr�-d�clar�es. Consultez Dim / Global / Local / Const pour plus de d�tails sur la d�claration des variables.
PixelCoordMode D�termine la mani�re d'utiliser les coordonn�es dans les fonctions pixel, soit coordonn�es absolues, soit coordonn�es relatives � la fen�tre d�finie par hwnd (fen�tre active par d�faut) :
0 = Coordonn�es relatives � la fen�tre d�finie
1 = (d�faut) Coordonn�es absolues d'�cran
2 = Coordonn�es relatives � la zone client de la fen�tre d�finie
SendAttachMode Sp�cifie si AutoIt attache les threads d'entr�e lors de l'utilisation de la fonction Send(). Sans l'attachement (mode par d�faut = 0) la d�tection de l'�tat de capslock/scrolllock et numlock peut �tre incertaine sous NT4. Toutefois, lorsque vous sp�cifiez le mode d'attachement mode=1, la syntaxe Send("{... down/up}") ne fonctionnera pas et il peut y avoir des probl�mes avec l'envoi de touches aux fen�tres "bloqu�es". ControlSend() attache TOUJOURS et n'est pas affect� par ce mode.
0 = (d�faut) N'attache pas
1 = Attache
SendCapslockMode Sp�cifie si AutoIt doit stocker l'�tat de Capslock avant une fonction Send() et la restaurer apr�s.
0 = Ne stocke/restaure pas
1 = (d�faut) Stocke et restaure
SendKeyDelay Modifie la dur�e de la pause entre les envois des codes de touche clavier. Une valeur de 0 supprime compl�tement la pause.
Temps de pause en millisecondes (d�faut=5).
SendKeyDownDelay Modifie le d�lai de maintien d'une touche avant qu'elle ne soit rel�ch�e lors d'une frappe clavier. Pour les applications qui prennent un certain temps pour enregistrer l'appui de touches, vous aurez besoin d'augmenter cette valeur. Une valeur de 0 supprime compl�tement ce d�lai.
Temps de pause en millisecondes (d�faut=5).
TCPTimeout D�finit la dur�e avant que les fonctions TCP ne s'arr�tent si il n'y a pas de communication.
D�lai d'attente en millisecondes (d�faut=100).
TrayAutoPause Met en pause le script lors d'un clic sur l'ic�ne de la zone de notification.
0 = Pas de pause
1 = (d�faut) Pause. S'il n'y a pas de menu par d�faut, aucune pause n'aura lieu.
TrayIconDebug Si activ�, montre la ligne en cours du script, dans une bulle d'information de la zone de notification pour aider au d�bogage.
0 = (d�faut) Aucune informations de d�bogage
1 = Montre les informations de d�bogage
TrayIconHide Cache l'ic�ne d'AutoIt situ�e dans la zone de notification. Note: L'ic�ne apparaitra ~750 millisecondes lors de l'initialisation.
0 = (d�faut) Montre l'ic�ne
1 = Cache l'ic�ne
TrayMenuMode �tend le comportement de l'ic�ne/menu de la zone de notification. Ceci peut �tre fait avec une combinaison (addition) des valeurs suivantes:
0 = Les �l�ments du menu par d�faut (Script Paused/Exit) sont ajout�s au menu cr�� par l'utilisateur; les �l�ments seront automatiquement coch�s/d�coch�s sur un clic; un double-clic sur l'ic�ne de la zone de notification retourne le controlID de l'�l�ment $TRAY_DEFAULT.
1 = Pas de menu par d�faut
2 = Les �l�ments ne seront pas automatiquement coch�s/d�coch�s si vous cliquez dessus.
4 = Ne retourne pas le controlID de l'�l�ment $TRAY_DEFAULT si vous double-cliquez sur l'ic�ne de la zone de notification.
8 = D�sactive le comportement automatique des groupes de boutons radio
TrayOnEventMode Active/D�sactive la notification des fonctions OnEvent dans la zone de notification.
0 = (d�faut) D�sactiv�
1 = Activ�
WinDetectHiddenText Sp�cifie si le texte des fen�tres cach�es peut �tre "vu" par les fonctions de comparaison de fen�tre.
0 = (d�faut) Ne d�tecte pas le texte cach�
1 = D�tecte le texte cach�
WinSearchChildren Permet aux routines de recherche de fen�tres de rechercher les fen�tres enfants aussi bien que les fen�tres de haut niveau.
0 = (d�faut) Recherche les fen�tres de haut niveau seulement
1 = Recherche les fen�tres de haut niveau et les fen�tres enfants
WinTextMatchMode Change la m�thode utilis�e pour comparer le texte des fen�tres pendant les op�rations de recherche.
1 = (d�faut) Compl�te / Mode lent
2 = Mode rapide
Dans le mode rapide, AutoIt ne "voit" que le texte des bo�tes de dialogue, le texte des boutons et le titre de quelques contr�les.
Dans le mode par d�faut, beaucoup plus de texte peut �tre vu (par exemple le contenu de la fen�tre Notepad).
Si vous avez des probl�mes de performance lors de multiples recherches de fen�tres, alors le passage en mode "rapide" pourra aider.
WinTitleMatchMode Change la m�thode utilis�e pour comparer le titre des fen�tres pendant les op�rations de recherche.
1 = (d�faut) Compare le titre � partir du d�but
2 = Compare n'importe quelle sous-cha�ne dans le titre
3 = Compare l'exactitude du titre
4 = Mode avanc� (conserv� seulement pour compatibilit� ant�rieure), consultez Titre et texte d'une fen�tre (Avanc�)
-1 � -4 = Correspondance insensible � la casse en accord avec l'autre type de comparaison.
WinWaitDelay Change la dur�e de la pause apr�s une op�ration de fen�tre r�ussie.
Temps de pause en millisecondes (d�faut=250).

Exemple

; Copiez tout ce que vous voulez changer, la valeur par d�faut est indiqu� en premier

Opt("CaretCoordMode", 1) ;1=absolue, 0=relative, 2=client
Opt("ExpandVarStrings", 0) ;0=ne s'�tend pas, 1=s'�tend
Opt("GUICloseOnESC", 1) ;1=ESC ferme, 0=ESC ne ferme pas
Opt("GUICoordMode", 1) ;1=absolue, 0=relative, 2=cellule
Opt("GUIDataSeparatorChar", "|") ;"|" est la valeur par d�faut
Opt("GUIOnEventMode", 0) ;0=d�sactiv�, 1 mode=OnEvent activ�
Opt("GUIResizeMode", 0) ;0=pas de redimensionnement, < 1024 redimensionnement sp�cial
Opt("GUIEventOptions", 0) ;0=d�faut, 1=juste notification, 2=GUICtrlRead index de tabulation
Opt("MouseClickDelay", 10) ;10 millisecondes
Opt("MouseClickDownDelay", 10) ;10 millisecondes
Opt("MouseClickDragDelay", 250) ;250 millisecondes
Opt("MouseCoordMode", 1) ;1=absolue, 0=relative, 2=client
Opt("MustDeclareVars", 0) ;0=non, 1=requiert pr�-d�claration
Opt("PixelCoordMode", 1) ;1=absolue, 0=relative, 2=client
Opt("SendAttachMode", 0) ;0=n'attache pas, 1=attache
Opt("SendCapslockMode", 1) ;1=sauvegarde et restaure, 0=ne le fait pas
Opt("SendKeyDelay", 5) ;5 millisecondes
Opt("SendKeyDownDelay", 1) ;1 milliseconde
Opt("TCPTimeout", 100) ;100 millisecondes
Opt("TrayAutoPause", 1) ;0=pas de pause, 1=pause
Opt("TrayIconDebug", 0) ;0=pas d'info, 1=info de d�bogage de ligne
Opt("TrayIconHide", 0) ;0=montre, 1=masque l'ic�ne de plateau
Opt("TrayMenuMode", 0) ;0=ajoute, 1=pas de menu par d�faut, 2=pas de s�lection automatique, 4=pas de retour menuitemID
Opt("TrayOnEventMode", 0) ;0=d�sactiv�, 1=activ�
Opt("WinDetectHiddenText", 0) ;0=ne d�tecte pas, 1=d�tecte
Opt("WinSearchChildren", 1) ;0=non, 1=recherche les enfants aussi
Opt("WinTextMatchMode", 1) ;1=complet, 2=rapide
Opt("WinTitleMatchMode", 1) ;1=d�but, 2=sous-cha�ne, 3=exact, 4=avanc�, -1 � -4=NOCASE
Opt("WinWaitDelay", 250) ;250 millisecondes