Ä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: | Gibt den Wert der vorherigen Einstellung dieser Option zurück. |
| Fehler: | Setzt @error auf non-zero. 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.| 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%". 1 = erweitert Umgebungsvariablen (ähnlich zu AutoIt v2) 0 = Umgebungsvariablen werden nicht erweitert (Standard) 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$". 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.". 0 = erweitert Variablen nicht (Standard) |
| 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. 1 = Sendet die $GUI_EVENT_CLOSE Nachricht wenn ESC gedrückt wird (Standard). 0 = Sendet nicht die $GUI_EVENT_CLOSE Nachricht wenn ESC gedrückt wird. |
| GUICoordMode | Bestimmt, wie die Position eines Controls durch GUICtrlSetPos definiert wird. 1 = absolute Koordinaten (Standard) relativ zur Dialog Box. 0 = relative Position zum Anfang des letzten Controls (obere linke Ecke). 2 = Zellenorientierte Positionierung relativ zur aktuellen Zelle. A -1 für linken oder oberen Parameter erhöht nicht den Start. Ist die nächste Zeile -1,offset; nächste Zelle ist offset,-1; aktuelle Zelle ist -1,-1. Offensichtlich kann "offset" nicht den Wert -1 annehmen, da dieser reserviert ist, um das Nichtvergrößern zu indizieren. Aber wenn ein Vielfaches der Breite verwendet werden kann, empfiehlt es sich zu überspringen oder zurückzugehen. |
| 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. 1 = Variable muss deklariert werden 0 = Variable muss nicht deklariert werden (Standard) |
| 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 (und viele Spiele) 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). |
| 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 erstmals auftreten nach ~750 Millisekunden. 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ü; Die Markierung der vom Benutzer erzeugten Menüelemente wird automatisch entfernt; bei einem Doppelklick auf das Trayicon wird die Control-ID zurückgegeben welche den "Default"-Stil (Standard) besitzt. 1 = kein Standard Menü 2 = Die Markierung der vom Benutzer erzeugten Menüelemente wird beim Anklicken nicht automatisch entfernt 4 = gibt nicht die MenuitemID zurück welche den "default"-Stil im Hauptkontextmenü hat bei Doppelklick auf das Trayicon 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, 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). |
Verwandte Funktionen
Viele!
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