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 boites de dialogue, le texte des boutons et la 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