Funktionreferenz


AutoItSetOption

Beschreibung anzeigen in

Ändert den Ablauf verschiedener AutoIt-Funktionen/Parameter.

AutoItSetOption ( "option" [, param] )

Parameter

option Die zu ändernde Option. Siehe Bemerkungen.
param [optional] Wert, der der Option zugeordnet wird. Typ und Bedeutung wechseln mit der Option. Siehe Bemerkungen unten. Wird kein Parameter übergeben, gibt die Funktion nur den der Option zur Zeit zugeordneten Wert zurück. Das Schlüsselwort Default kann für den Parameter verwendet werden um die Option auf den Standardwert zurückzusetzen.

Rückgabewert

Erfolg: der Wert der vorherigen Einstellung dieser Option.
Fehler: Setzt das @error Flag auf ungleich null. Fehler treten auf, wenn die Parameter ungültig sind (z. B. dass eine Option nicht existiert).

Bemerkungen

Als Alternative zu AutoItSetOption() kann auch Opt() verwendet werden.

Folgende Optionen sind vorhanden:

Option Param
CaretCoordMode Legt fest, auf welche Weise Koordinaten verwendet werden, entweder absolut oder relativ zum momentan aktiven Fenster:
0 = relative Koordinaten zum aktiven Fenster.
1 = absolute Bildschirm Koordinaten (Standard).
2 = relative Koordinaten zur Client Fläche des aktiven Fensters.
ExpandEnvStrings Ändert die Interpretation von Strings und %-Symbolen. Als Standard werden Strings buchstabengetreu behandelt, diese Option erlaubt die Benutzung von %environment% Variablen innerhalb von Strings, z.B.: "Das temp Verzeichnis ist: %temp%".
0 = Umgebungsvariablen werden nicht erweitert (Standard).
1 = erweitert Umgebungsvariablen.
Ohne diese Option wäre der übliche Weg: "Das temp Verzeichnis ist:" & EnvGet("temp")
ExpandVarStrings Ändert die Interpretation von String, Variablen- und Makrosymbolen ($ und @). Als Standard werden Strings buchstabengetreu behandelt, diese Option erlaubt die Benutzung von Variablen und Makros innerhalb von String, z.B.: "Der Wert von var1 ist $var1$".
0 = erweitert Variablen nicht (Standard).
1 = erweitert Variablen (sollen innerhalb dieses Modus die Zeichen $ oder @ benutzt werden, so müssen sie doppelt angegeben werden:"Das ist ein einzelnes Dollar $$ Zeichen.".
GUICloseOnESC Mit Drücken der ESC-Taste in einer GUI, wird die $GUI_EVENT_CLOSE Nachricht gesendet. Diese Option schaltet das Verhalten an und aus.
0 = Sendet nicht die $GUI_EVENT_CLOSE Nachricht wenn ESC gedrückt wird.
1 = Sendet die $GUI_EVENT_CLOSE Nachricht wenn ESC gedrückt wird (Standard).
GUICoordMode Bestimmt, wie die Position eines Controls durch GUICtrlSetPos definiert wird.
0 = relative Position zum Anfang des letzten Controls (obere linke Ecke).
1 = absolute Koordinaten (Standard) relativ zur Dialog Box.
2 = Positionierung relativ zur unteren rechten Ecke des letzten Controls.
Ausnahme: mit "-1" übernimmt man den top/left-Wert des letzten Controls.
Um ein Control genau 1px höher/links als das letzte zu positionieren (-1 ist ja reserviert für "gleicher Abstand von oben/links"), muß man es mit negativen Werten um ("Höhe/Breite des letzten Controls" + 1) nach oben/links verschieben/positionieren.
GUIDataSeparatorChar Legt das Trennzeichen für Teildaten fest, die mit GUICtrlSetData gesetzt werden.
Das Standardzeichen ist '|'.
GUIOnEventMode Aktiviert/Deaktiviert die OnEvent Funktionsanmeldung.
0 = (Standard) deaktiviert.
1 = aktiviert.
GUIResizeMode Ändert das Standardverhalten bei Größenveränderung für ein Control.
0 = (Standard) behält das Standardverhalten bei.
<1024 = jede Art der Größenveränderung, siehe GUICtrlSetResizing.
GUIEventOptions Ändert das Verhalten bei Sonderereignissen oder Rückgabewerten der GUI Funktionen.
0 = (Standard) Windows Verhalten bei Klick auf Minimize, Restore, Maximize, Resize.
1 = unterdrückt das Windows Verhalten bei Klick auf Minimize, Restore, Maximize, Resize oder Fenster Größenveränderung. Sendet nur die Mitteilung.
MouseClickDelay Bestimmt die Länge der Anweisungspause zwischen Mausklicks.
Zeit in Millisekunden für die Pause (Standard=10).
MouseClickDownDelay Bestimmt, wie lange die Maustaste gedrückt sein muss, damit der Klick registriert wird.
Zeit in Millisekunden für die Pause (Standard=10).
MouseClickDragDelay Bestimmt die Länge der Anweisungspause zwischen Beginn und Ende einer Maus-Ziehen Operation.
Zeit in Millisekunden für die Pause (Standard=250).
MouseCoordMode Legt fest, auf welche Art die Mausfunktionen Koordinaten nutzen, entweder absolut oder relativ zum momentan aktiven Fenster:
0 = relative Koordinaten zum aktiven Fenster.
1 = absolute Bildschirm Koordinaten (Standard).
2 = relative Koordinaten zum Anwendungsbereich des aktiven Fensters.
MustDeclareVars Wenn diese Option genutzt wird müssen alle Variablen deklariert werden mit Dim, Local oder Global bevor sie verwendet werden können - beseitigt die Möglichkeit von Bugs durch Schreibfehler in Variablen.
0 = Variable muss nicht deklariert werden (Standard).
1 = Variable muss deklariert werden. Siehe Dim / Global / Local / Const für weitere Details.
PixelCoordMode Legt fest, auf welche Art die Pixelfunktionen Koordinaten nutzen, entweder absolut oder relativ zum Fenster welches durch hwnd definiert wurde (Standard = aktives Fenster):
0 = relative Koordinaten zum definierten Fenster.
1 = absolute Bildschirm Koordinaten (Standard).
2 = relative Koordinaten zum Anwendungsbereich des definierten Fensters.
SendAttachMode Legt fest, wie AutoIt eingehende Signale verknüpft wenn die Send() Funktion verwendet wird. Bei Nichtverknüpfung (Standard Mode=0) kann die Ermittlung des Status von Capslock/Scrolllock und Numlock unzuverlässig sein unter NT4. Jedoch wird der attach Mode=1 gesetzt und der Send("{... down/up}") Syntax wird nicht funktionieren und es kann Probleme geben mit dem Senden von Tasten an "hängende" Fenster. ControlSend() ist IMMER verknüpft und wird nicht beeinträchtigt durch diesen Modus.
0 = nicht verknüpfen (Standard).
1 = verknüpfen.
SendCapslockMode Legt fest ob AutoIt den Status von Capslock speichern soll bevor eine Send Funktion ausgeführt wird und danach wiederherstellt.
0 = nicht speichern/wiederherstellen.
1 = speichern/wiederherstellen (Standard).
SendKeyDelay Bestimmt die Länge der Anweisungspause zwischen dem Senden von Tastaturanschlägen. Ein Wert von 0 entfernt die Verzögerung komplett.
Zeit in Millisekunden für die Pause (Standard=5).
SendKeyDownDelay Bestimmt die Zeitdauer, die eine Taste gedrückt sein muss, bis ein Tastaturanschlag registriert wird. Für Anwendungen die einige Zeit benötigen bis Tastaturanschläge erkannt werden kann es notwendig sein den Standardwert zu erhöhen. Ein Wert von 0 entfernt die Verzögerung komplett.
Zeit in Millisekunden zur Pause (Standard=5).
SetExitCode Gibt einen Autoit Exitcode zurück, wenn ein schwerwiegender Fehler auftritt.
0 = (Standard) nicht setzen
1 = Setzt @exitCode bei schwerwiegenden Fehlern, siehe AutoIt3 schwerwiegende Fehler Exitcodes
TCPTimeout Bestimmt die Zeit bevor TCP Funktionen wegen fehlender Kommunikation beendet werden.
Zeit in Millisekunden bevor ein Timeout eintritt (Standard=100).
TrayAutoPause Das Skript pausiert bei einem Klick auf das Tray Icon.
0 = keine Pause.
1 = Pause (Standard). Wenn kein Standardmenü vorhanden ist, tritt keine Pause auf.
TrayIconDebug Wenn es aktiviert ist, wird die aktuelle Skriptzeile im Trayicon Tipp angezeigt um das Debugging zu unterstützen.
0 = keine Debug Information (Standard).
1 = zeige Debug.
TrayIconHide Versteckt das AutoIt Tray Icon. Anmerkung: Das Icon wird jedoch, auch bei Option = 1, für ~750 Millisekunden angezeigt.
0 = zeige Icon (Standard).
1 = verstecke Icon.
TrayMenuMode Erweitert das Verhalten des TrayMenüs eines Skripts. Dies kann durch Kombination (Addition) folgender Werte geschehen.
0 = Standard Menüeinträge (Skript Pausieren/Exit) werden angehängt an das benutzererzeugte Menü; bei einem Klick wird die Markierung automatisch gesetzt bzw. entfernt; bei einem Doppelklick auf das Trayicon wird die Control-ID zurückgegeben welche $TRAY_DEFAULT besitzt.
1 = kein Standard Menü.
2 = Die Markierung wird beim Anklicken nicht automatisch entfernt.
4 = gibt nicht das $TRAY_DEFAULT Item zurück wenn ein Doppelklick auf das Trayicon erfolgt.
8 = schaltet die automatische Überprüfung von Radioelementgruppen ab.
TrayOnEventMode Aktiviert/deaktiviert die OnEvent Funktionsanmeldung für das Tray.
0 = (Standard) deaktiviert.
1 = aktiviert.
WinDetectHiddenText Legt fest ob versteckter Fenstertext für die Funktionen zur Fensterüberprüfung "sichtbar" ist.
0 = Versteckter Text wird nicht erkannt (Standard).
1 = Erkennt versteckten Text.
WinSearchChildren Erlaubt den Fenster Suchroutinen Child Fenster genauso zu durchsuchen, wie top-level Fenster.
0 = Suche nur in top-level Fenstern (Standard).
1 = Suche in top-level und Child Fenstern.
WinTextMatchMode Bestimmt die Methode der Textüberprüfung für Fenster während Suchoperationen.
1 = Komplett / Langsamer Modus (Standard).
2 = Schneller Modus.
Im Schnellmodus kann AutoIt üblicherweise nur Dialog Text, Button Text und die Bezeichnung einiger Controls "sehen". Im Standardmodus ist viel mehr Text sichtbar (beispielsweise der Inhalt eines Notepad-Fensters).
Sollten Performanceprobleme bei der Suche nach vielen Fenstern auftreten kann der "quick"-Modus hilfreich sein.
WinTitleMatchMode Bestimmt welche Methode zur Fenstertitelerkennung in Suchaktionen verwendet wird.
1 = Erkennt den Titel vom Anfang (Standard).
2 = Erkennt Teile des Titels.
3 = Erkennt nur den exakten Titel.
4 = Erweiterter Modus (wurde nur für die Rückwärtskompatibilität beibehalten, siehe Erweiterte Fenstertiteldefinition)
-1 bis -4 = erzwingt Kleinbuchstabenerkennung in Übereinstimmung mit anderen Erkennungstypen.
WinWaitDelay Bestimmt die Länge der Anweisungspause für ein Skript nach einer erfolgreichen Fenster-bezogenen Operation.
Zeit in Millisekunden für die Pause (Standard=250).

Beispiel

; Jede Zeile zum Ändern kopieren   ; Der Standardwert ist als erstes angegeben

Opt("CaretCoordMode", 1)        ; 1=absolut, 0=relativ, 2=rel. zur Fensterfläche(client)
Opt("ExpandEnvStrings", 0)      ; 0=nicht auswerten, 1=auswerten
Opt("ExpandVarStrings", 0)      ; 0=nicht auswerten, 1=auswerten
Opt("GUICloseOnESC", 1)         ; 1=ESC beendet, 0=ESC schließt nicht
Opt("GUICoordMode", 1)          ; 1=absolut, 0=relativ, 2=rel. zur Fensterfläche(client)
Opt("GUIDataSeparatorChar","|") ; "|" ist der Standard
Opt("GUIOnEventMode", 0)        ; 0=ausgeschaltet, 1=OnEvent Modus aktiviert
Opt("GUIResizeMode", 0)         ; 0=keine Größenänderung, konfigurierte Größenänderung (<1024)
Opt("GUIEventOptions", 0)       ; 0=Windowsstandard, 1=nur benachrichtigen, 2=GUICtrlRead tab index
Opt("MouseClickDelay", 10)      ; 10 msec
Opt("MouseClickDownDelay", 10)  ; 10 msec
Opt("MouseClickDragDelay", 250) ; 250 msec
Opt("MouseCoordMode", 1)        ; 1=absolut, 0=relativ, 2=rel. zur Fensterfläche(client)
Opt("MustDeclareVars", 0)       ; 0=nein, 1=erfordert Deklaration
Opt("PixelCoordMode", 1)        ; 1=absolut, 0=relativ, 2=rel. zur Fensterfläche(client)
Opt("SendAttachMode", 0)        ; 0=nicht anheften, 1=anheften
Opt("SendCapslockMode", 1)      ; 1=speichern und wiederherstellen, 0=ignorieren
Opt("SendKeyDelay", 5)          ; 5 msec
Opt("SendKeyDownDelay", 1)      ; 1 msec
Opt("TCPTimeout", 100)          ; 100 msec
Opt("TrayAutoPause", 1)         ; 0=keine Pause, 1=Pause
Opt("TrayIconDebug", 0)         ; 0=keine Info, 1=Debug Zeileninfo
Opt("TrayIconHide", 0)          ; 0=zeigen, 1=Icon verstecken
Opt("TrayMenuMode", 0)          ; 0=anfügen, 1=kein Standardmenü, 2=kein autom. An-/Abhaken, 4=menuitemID nicht zurückgeben
Opt("TrayOnEventMode", 0)       ; 0=ausschalten, 1=einschalten
Opt("WinDetectHiddenText", 0)   ; 0=nicht erkennen, 1=erkennen
Opt("WinSearchChildren", 1)     ; 0=nein, 1=Auch Unter(child)-fenster suchen
Opt("WinTextMatchMode", 1)      ; 1=vollständig, 2=schnell
Opt("WinTitleMatchMode", 1)     ; 1=vom Anfang, 2=enthält, 3=genau, 4=fortgeschritten, -1 bis -4=Groß-/Klein ignorieren
Opt("WinWaitDelay", 250)        ; 250 msec