Change le mode de fonctionnement de divers fonctions/paramètres d'AutoIt.
AutoItSetOption ( "option" [, param] )
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. |
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). |
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). |
; 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