Variablen und Ausdrücke

Wenn eine Variable in einem Ausdruck mit Prozentzeichen umschlossen ist (z.B. %Var%), wird der gesamte Inhalt dieser Variable als Name oder Teil des Namens einer anderen Variable vermutet (wenn diese Variable nicht existiert, wird %Var% in eine leere Zeichenkette aufgelöst). Meistens wird dies verwendet, um Elemente eines Pseudo-Arrays zu referenzieren, zum Beispiel:

Var := MeinArray%A_Index% + 100

Aus Gründen der Abwärtskompatibilität ignorieren Befehlsparameter, die als "kann ein Ausdruck sein" dokumentiert sind, die Prozentzeichen bei einem alleinstehenden Namen in Prozentzeichen (z.B. %Var%, aber nicht Array%i%). Um das zu umgehen, umschließen Sie die Referenz mit runden Klammern, z.B. Sleep (%Var%).

[AHK_L 52+]: Zusätzlich zu den normalen Variablen kann %Var% in eine Umgebungsvariable, die Zwischenablage oder eine reservierte/schreibgeschützte Variable aufgelöst werden. Vor Revision 52 wurde %Var% in solchen Fällen in eine leere Zeichenkette aufgelöst.

Potenz. Anwendungsbeispiel: Basis**Exponent. Sowohl Basis als auch Exponent können einen Dezimalpunkt enthalten. Wenn Exponent negativ ist, wird das Ergebnis in eine Floating-Point-Zahl umgewandelt, auch dann, wenn Basis und Exponent Integer sind. Da dieser Operator eine höhere Priorität als ein unäres Minuszeichen hat, wird -2**2 wie -(2**2) ausgewertet und somit -4 zurückgeben. Um eine direkt geschriebene negative Zahl zu potenzieren, umschließen Sie diese mit runden Klammern, z.B. (-2)**2.

Hinweis: Eine negative Basis mit einem gebrochenen Exponenten wie (-2)**0.5 wird nicht unterstützt und gibt eine leere Zeichenkette zurück. Allerdings werden sowohl (-2)**2 als auch (-2)**2.0 unterstützt.

Hinweis: In AutoHotkey v1 ist ** im Gegensatz zu seinem mathematischen Gegenstück linksassoziativ. Zum Beispiel wird x ** y ** z als (x ** y) ** z ausgewertet.

Unäres Minuszeichen (-): Obwohl dieser Operator und der Subtraktionsoperator dasselbe Symbol verwenden, wird das unäre Minuszeichen nur auf ein einzelnes Element oder einen Teilausdruck angewendet, z.B. -(3 / -x). Unäre Pluszeichen (+) werden in einem Ausdruck ignoriert.

Logisches NICHT (!): Wenn dieser Operator auf einen Operanden angewendet wird, der leer oder 0 ist, ist das Ergebnis 1 (true). Andernfalls ist das Ergebnis 0 (false). Zum Beispiel: !x or !(y and z). Hinweis: Das Wort NOT ist synonym mit !, allerdings hat ! eine höhere Priorität. [v1.0.46+]: Aufeinanderfolgende unäre Operatoren wie !!Var sind erlaubt, da sie von rechts nach links ausgewertet werden.

Bitweises NICHT (~): Dieser Operator invertiert jedes Bit seines Operanden. Wenn der Operand eine Floating-Point-Zahl ist, wird er vor der Berechnung auf Integergröße gekürzt. Wenn der Operand eine Zahl zwischen 0 und 4294967295 (0xffffffff) ist, wird er als vorzeichenloser 32-Bit-Wert behandelt. Andernfalls wird er als vorzeichenfähiger 64-Bit-Wert behandelt. Zum Beispiel wird ~0xf0f zu 0xfffff0f0 (4294963440) ausgewertet.

Adresse (&): &MeineVar ruft die Adresse des Inhalts von MeineVar im Speicher ab, was häufig für DllCall-Strukturen verwendet wird. &MeineVar deaktiviert außerdem das Caching von Binärzahlen in dieser Variable, was sich negativ auf ihre Performanz auswirken kann, wenn sie Teil einer Berechnung oder eines numerischen Vergleichs ist. Sobald sich die Adresse einer Variable ändert, wird das Caching wieder aktiviert (z.B. via VarSetCapacity()).

Dereferenz (*): *Ausdruck geht davon aus, dass Ausdruck eine numerische Speicheradresse ist; es ruft das Byte an dieser Adresse als Zahl zwischen 0 und 255 ab (0 wird immer abgerufen, wenn die Adresse 0 ist; andere ungültige Adressen sollten jedoch vermieden werden, da sie das Skript zum Absturz bringen können). Beachten Sie, dass NumGet() in der Regel viel performanter ist, wenn es darum geht, Binärzahlen abzurufen.

Multiplikation (*): Das Ergebnis ist ein Integer, wenn beide Eingabewerte Integer sind, andernfalls ist es eine Floating-Point-Zahl.

Echte Division (/): Im Gegensatz zu EnvDiv liefert die echte Division immer eine Floating-Point-Zahl, auch dann, wenn beide Eingabewerte Integer sind. Zum Beispiel ergibt 3/2 1.5 statt 1 und 4/2 2.0 statt 2.

Floor-Division (//): Der Doppelschrägstrich-Operator verwendet eine hochperformante Integer-Division, wenn beide Eingabewerte Integer sind. Zum Beispiel ergibt 5//3 1 und 5//-3 -1. Wenn einer der beiden Eingabewerte eine Floating-Point-Zahl ist, wird eine Floating-Point-Division durchgeführt und das Ergebnis auf den am nächsten links befindlichen Integer gekürzt. Zum Beispiel ergibt 5//3.0 1.0 und 5.0//-3 -2.0. Obwohl das Ergebnis dieser Floating-Point-Division ein Integer ist, wird es im Floating-Point-Format gespeichert, so dass es von anderen Operationen als solches gesehen wird. Um stattdessen eine Division mit Rest (Modulo) durchzuführen, siehe Mod().

Die Operatoren *= und /= sind Kurzschreibweisen zum Multiplizieren oder Dividieren eines Variablenwerts mit einem anderen Wert. Zum Beispiel liefert Var *= 2 dasselbe Ergebnis wie Var := Var * 2 (obwohl Ersteres performanter ist).

Eine Division durch 0 liefert ein leeres Ergebnis (leere Zeichenkette).

Addition (+) und Subtraktion (-). Die Operatoren += und -= sind Kurzschreibweisen zum Erhöhen oder Verringern eines Variablenwerts um einen beliebigen Wert. Zum Beispiel liefert Var += 2 dasselbe Ergebnis wie Var := Var + 2 (obwohl Ersteres performanter ist). Ebenso kann eine Variable mit Var++, Var--, ++Var oder --Var schrittweise um 1 erhöht oder verringert werden.

Bitweise Verschiebung nach links (<<). Anwendungsbeispiel: Wert1 << Wert2. Entspricht der Multiplikation von Wert1 mit "2 hoch Wert2".

Arithmetische bitweise Verschiebung nach rechts (>>). Anwendungsbeispiel: Wert1 >> Wert2. Entspricht der Division von Wert1 durch "2 hoch Wert2" und der Rundung des Ergebnisses auf den am nächsten links befindlichen Integer. Zum Beispiel ergibt -3>>1 -2.

Logische bitweise Verschiebung nach rechts (>>>) [v1.1.35+]. Anwendungsbeispiel: Wert1 >>> Wert2. Im Gegensatz zur arithmetischen bitweisen Verschiebung nach rechts wird bei dieser Verschiebung das Vorzeichen der Zahl nicht beibehalten. Zum Beispiel hat -1 die gleiche Bitdarstellung wie der vorzeichenlose 64-Bit-Integer 0xffffffffffffffffff, daher ist -1 >>> 1 0x7fffffffffffffffff.

Bei allen drei Operatoren werden Floating-Point-Eingabewerte vor der Berechnung auf einen Integer gekürzt. Die Ergebnisse sind undefiniert, wenn Wert2 kleiner als 0 oder größer als 63 ist.

Verkettung. Ein Punkt mit mindestens einem Leer- oder Tabulatorzeichen auf beiden Seiten wird verwendet, um zwei Elemente zu einer einzelnen Zeichenkette zu kombinieren. Dasselbe kann auch ohne diesen Punkt erzielt werden (außer bei Mehrdeutigkeiten wie x -y oder wenn dem rechts befindlichen Element ein ++ oder -- vorangestellt ist). Wenn der Punkt weggelassen wird, muss zwischen den Elementen mindestens ein Leer- oder Tabulatorzeichen stehen.

Var := "Die Farbe ist " . GefundeneFarbe  ; Explizite Verkettung
Var := "Die Farbe ist " GefundeneFarbe    ; Auto-Verkettung

Teilausdrücke können auch verkettet werden. Zum Beispiel: Var := "Der Nettopreis ist " . Preis * (1 - Rabatt/100).

Eine Zeile, die mit einem Punkt (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden.

Größer (>), kleiner (<), größer gleich (>=) und kleiner gleich (<=). Wenn beide Eingabewerte Zahlen oder numerische Zeichenketten sind, werden sie numerisch verglichen, andernfalls werden sie alphabetisch verglichen. Der Vergleich ist nur Groß-/Kleinschreibung-sensitiv, wenn StringCaseSense eingeschaltet ist. Siehe auch: Sort

Hinweis: In AutoHotkey v1 wird eine in Anführungszeichen gesetzte Zeichenkette (oder das Ergebnis einer Verkettung mit einer in Anführungszeichen gesetzte Zeichenkette) nie als numerisch angesehen, wenn sie direkt in einem Ausdruck verwendet wird.

Gleich (=), Groß-/Kleinschreibung-sensitiv gleich (==) und ungleich (<> oder !=). Wenn beide Eingabewerte Zahlen oder numerische Zeichenketten sind, werden sie numerisch verglichen, andernfalls werden sie alphabetisch verglichen. Die Operatoren != und <> sind funktionsgleich. Die Operatoren == und = verhalten sich gleich, wenn beide Eingabewerte numerisch sind, es sei denn, einer der Eingabewerte ist nicht numerisch, dann ist == immer Groß-/Kleinschreibung-sensitiv und = immer nicht-Groß-/Kleinschreibung-sensitiv (die Methode der Nichtsensitivität hängt von StringCaseSense ab). Die Operatoren <> und != hingegen berücksichtigen StringCaseSense.

Groß-/Kleinschreibung-sensitiv ungleich (!==) [v1.1.35+]. Verhält sich identisch zu ==, außer dass das Ergebnis invertiert wird.

Hinweis: In AutoHotkey v1 wird eine in Anführungszeichen gesetzte Zeichenkette (oder das Ergebnis einer Verkettung mit einer in Anführungszeichen gesetzte Zeichenkette) nie als numerisch angesehen, wenn sie direkt in einem Ausdruck verwendet wird.

Veraltet: Der Operator <> ist nicht für neue Skripte empfohlen. Verwenden Sie stattdessen den Operator !=.

Zuweisung. Führt eine Operation am Inhalt einer Variable durch und speichert das Ergebnis wieder in dieselbe Variable (aber vor v1.0.46 konnten diese nur als Operator ganz links in einer Zeile verwendet werden, außerdem wurden nur die ersten fünf Operatoren unterstützt). Der einfachste Zuweisungsoperator ist Doppelpunkt-Gleich (:=), der das Ergebnis eines Ausdrucks in eine Variable speichert. Eine Beschreibung der anderen Operatoren finden Sie in den entsprechenden Einträgen dieser Tabelle. Zum Beispiel führt Var //= 2 eine Floor-Division durch, um Var durch 2 zu teilen, und speichert das Ergebnis wieder in Var. Ein weiteres Beispiel ist Var .= "abc", was die Kurzschreibweise für Var := Var . "abc" ist.

Im Gegensatz zu den meisten anderen Operatoren werden Zuweisungen von rechts nach links ausgewertet. Folglich bewirkt eine Zeile wie Var1 := Var2 := 0, dass zuerst 0 in Var2 und dann Var2 in Var1 gespeichert wird.

Wenn eine Zuweisung als Eingabe für einen anderen Operator verwendet wird, ist der Eingabewert die Variable selbst. Zum Beispiel ist der Ausdruck (Var += 2) > 50 wahr, wenn der soeben erhöhte Wert in Var größer als 50 ist. Dies ermöglicht auch die Übergabe einer Zuweisung als ByRef oder die Verwendung ihrer Adresse, z.B. &(x:="abc").

Die Priorität der Zuweisungsoperatoren wird automatisch erhöht, wenn dadurch ein Syntaxfehler vermieden oder ein intuitiveres Verhalten erreicht wird. Zum Beispiel: not x := y ist äquivalent zu not (x := y). Außerdem wird x==y && z:=1 als x==y && (z:=1) ausgewertet, und kurzgeschlossen, wenn x ungleich y ist. Ebenso wird ++Var := X als ++(Var := X) und Z > 0 ? X := 2 : Y := 2 als Z > 0 ? (X := 2) : (Y := 2) ausgewertet.

>>>= benötigt [v1.1.35+].

Bekannte Einschränkungen durch Abwärtskompatibilität (die eventuell in einer zukünftigen Version behoben werden): 1) Wenn /= der Operator ganz links in einem Ausdruck ist und nicht zu einer Mehrfachanweisung gehört, führt dieser Operator eine Floor-Division durch, es sei denn, eine der Eingaben ist eine Floating-Point-Zahl (in allen anderen Fällen führt /= eine echte Division durch); 2) Datum/Zeit-Berechnungen mit += und -= sind nur möglich, wenn dieser Operator der Operator ganz links in der Zeile ist; 3) Die Operatoren +=, -= und *= behandeln leere Variablen als 0, aber nur, wenn sie einzeln in einer Zeile stehen; zum Beispiel erzeugen sowohl y := 1, x += 1 als auch MsgBox % x -= 3 ein leeres Ergebnis, wenn x leer ist.

Komma (Mehrfachanweisung) [v1.0.46+]. Kommas können verwendet werden, um mehrere Teilausdrücke auf eine Zeile zu schreiben. Dies wird üblicherweise verwendet, um mehrere Zuweisungen oder Funktionsaufrufe zu gruppieren. Zum Beispiel: x:=1, y+=2, ++index, MeineFunk(). Solche Anweisungen werden von links nach rechts ausgeführt.

Hinweis: Eine Zeile, die mit einem Komma (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden. Siehe auch: Kommaperformanz.

[v1.0.46.01+]: Wenn direkt nach einem Komma eine Variable und ein Gleichheitszeichen folgt, wird dieses Gleichheitszeichen automatisch als Doppelpunkt-Gleich-Zuweisung (:=) behandelt. Zum Beispiel enthält Folgendes nur Zuweisungen: x:=1, y=2, a=b=c. Neue Skripte sollten sich nicht auf dieses Verhalten verlassen, da es sich noch ändern kann. Diese Regel gilt nur für reine Variablen, nicht für Doppeldereferenzen (double-derefs), z.B. enthält Folgendes nur eine Zuweisung: x:=1, %y%=2

[v1.0.48+]: Kommagetrennte Ausdrücke sind in der Regel performanter als einzeln geschriebene Ausdrücke, insbesondere bei der Zuweisung einer Variable an eine andere (z.B. x:=y, a:=b). Je mehr Ausdrücke zu einem einzigen Ausdruck zusammengefasst werden, desto höher ist die Performanz. Zum Beispiel kann ein Geschwindigkeitszuwachs von 35 % erreicht werden, wenn fünf oder zehn einfache Ausdrücke zu einem einzigen Ausdruck kombiniert werden.

Ein beliebiger Teilausdruck in runden Klammern. Zum Beispiel bewirkt (3 + 2) * 2, dass 3 + 2 zuerst ausgewertet wird.

Bei einer Mehrfachanweisung wird das Ergebnis der ersten Anweisung zurückgegeben. Zum Beispiel bewirkt (a := 1, b := 2, c := 3), dass 1 zurückgegeben wird.

Veraltet: Diese Syntax wird nicht empfohlen. Verwenden Sie stattdessen %func%() (für Funktionsnamen und -objekte) oder func.Call() (für Funktionsobjekte).

[AHK_L 48+]: Versucht, eine namenlose Methode des Objekts func aufzurufen. Konventionsgemäß ist das die "Standardmethode" des Objekts. Wenn func kein Objekt enthält, wird stattdessen indirekt das Standardbasisobjekt aufgerufen.

[v1.0.95+]: Wenn func einen Funktionsnamen enthält, wird die benannte Funktion aufgerufen.

[AHK_L 60+]: Variadischer Funktionsaufruf. Params ist ein Array (Objekt) mit Parameterwerten.

[AHK_L 31+]: Objektelementzugriff. Abrufen (Get), Setzen (Set) oder Aufrufen (Call) einer Methode des Objekts x, wobei y eine Parameterliste (typischerweise ein Array-Index oder Schlüssel) oder ein Ausdruck ist, der einen Methodennamen zurückgibt.

[v1.0.97+]: Direkt geschriebenes Array. Wenn der eckigen Klammer kein Wert (oder kein Teilausdruck, der einen Wert zurückgibt) vorangestellt ist, wird die Klammer als Beginn eines direkt geschriebenen Arrays interpretiert. Zum Beispiel ist [a, b, c] äquivalent zu Array(a, b, c) (a, b und c sind Variablen).

Weitere Informationen finden Sie unter Arraysyntax und Objektsyntax.

[v1.0.97+]: Direkt geschriebenes Objekt. Ein Objekt bzw. assoziatives Array erstellen. Zum Beispiel ist x := {a: b} äquivalent zu x := Object("a", b) oder x := Object(), x.a := b. Weitere Informationen finden Sie unter Assoziative Arrays.

Der Dateiname des aktuellen Skripts ohne Pfadangabe, z.B. MeinSkript.ahk

Wenn das Skript kompiliert oder eingebettet ist, enthält diese Variable den Namen der aktuellen EXE-Datei.

Der vollständige Pfadname des aktuellen Skripts, z.B. C:\Skripte\MeinSkript.ahk

Wenn das Skript kompiliert oder eingebettet ist, enthält diese Variable den vollständigen Pfadnamen der aktuellen EXE-Datei.

Die Nummer der aktuell ausgeführten Zeile innerhalb des Skripts (oder innerhalb einer #Include-Datei, falls vorhanden). Diese Zeilennummer entspricht der via ListLines angezeigten Zeilennummer; dies ist z.B. nützlich, um einen Fehler zu melden: MsgBox, Konnte nicht in die Logdatei schreiben (Zeile Nr. %A_LineNumber%)

Da bei einer Skriptkompilierung alle #Include-Dateien zu einem großen Skript zusammengefasst werden, kann die Zeilennummerierung von der im unkompilierten Modus abweichen.

Der vollständige Pfadname der Datei, zu der A_LineNumber gehört. Wenn das Skript aus einer externen Datei geladen wurde, ist diese Variable äquivalent zu A_ScriptFullPath, es sei denn, die Zeile gehört zu einer der #Include-Dateien des Skripts.

Wenn das Skript mit einer BIN-Datei kompiliert wurde, enthält diese Variable den vollständigen Pfadnamen der aktuellen EXE-Datei, äquivalent zu A_ScriptFullPath.

[v1.1.34+]: Wenn das Skript eingebettet ist, enthält A_LineFile ein Sternchen (*), gefolgt vom Namen der Ressource, z.B. *#1

Für unkompilierte oder eingebettete Skripte: Der vollständige Pfadname der EXE-Datei, mit der das aktuelle Skript gerade ausgeführt wird. Zum Beispiel: C:\Program Files\AutoHotkey\AutoHotkey.exe

Für kompilierte Skripte, die auf einer BIN-Datei basieren, wird der Wert ermittelt, indem das Installationsverzeichnis aus der Registry gelesen und "\AutoHotkey.exe" angefügt wird. Wenn AutoHotkey nicht installiert ist, ist der Wert leer. Das folgende Beispiel ist äquivalent:

RegRead InstallDir, HKLM\SOFTWARE\AutoHotkey, InstallDir
AhkPath := ErrorLevel ? "" : InstallDir "\AutoHotkey.exe"

[v1.1.34+]: Für kompilierte Skripte, die auf einer EXE-Datei basieren, enthält A_AhkPath den vollständigen Pfadnamen des kompilierten Skripts. Dies kann in Kombination mit /script verwendet werden, um externe Skripte auszuführen. Um stattdessen die installierte Kopie von AutoHotkey zu lokalisieren, lesen Sie die Registry wie oben gezeigt.

Enthält 1, wenn Zeichenketten im Unicode-Format (16-Bit) sind, oder eine leere Zeichenkette (was als falsch angesehen wird), wenn Zeichenketten im ANSI-Format (8-Bit) sind. Das Format der Zeichenketten richtet sich nach der Version von AutoHotkey.exe, mit der das Skript ausgeführt wird, oder, falls es kompiliert wurde, nach der BIN-Datei, mit der es kompiliert wurde.

Bei ANSI-EXE-Dateien vor [v1.1.06] blieb A_IsUnicode undefiniert; das heißt, dass das Skript dieser Variable einen Wert zuweisen konnte und dass der Versuch, sie zu lesen, eine UseUnsetGlobal-Warnung auslösen konnte. In späteren Versionen ist diese Variable immer definiert und schreibgeschützt.

Enthält 1, wenn das Skript als kompilierte EXE-Datei ausgeführt wird, andernfalls eine leere Zeichenkette (was als falsch angesehen wird).

Bei unkompilierten Skripten vor [v1.1.06] blieb A_IsCompiled undefiniert; das heißt, dass das Skript dieser Variable einen Wert zuweisen konnte und dass der Versuch, sie zu lesen, eine UseUnsetGlobal-Warnung auslösen konnte. In späteren Versionen ist diese Variable immer definiert und schreibgeschützt.

Das aktuelle 4-stellige Jahr (z.B. 2004). A_Year enthält denselben Wert.

Hinweis: Um die formatierte Version einer Uhrzeit oder eines Datums gemäß Ihrer aktuellen Sprach- und Regionseinstellungen abzurufen, verwenden Sie FormatTime, AusgabeVar (Uhrzeit und langes Datum) oder FormatTime, AusgabeVar,, LongDate (langes Datumformat).

Die aktuelle 2-stellige Minute (00-59).

Die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format.

Hinweis: Datums- und Zeitberechnungen können mit EnvAdd und EnvSub durchgeführt werden. Außerdem können Sie FormatTime verwenden, um das Datum und/oder die Uhrzeit gemäß Ihrer aktuellen Sprach- und Regionseinstellungen zu formatieren.

Die seit dem Systemstart verstrichene Zeit in Millisekunden, bis zu einem Maximum von 49,7 Tagen. Um diese verstrichene Zeit zu messen, speichern Sie A_TickCount in eine Variable und subtrahieren Sie diese später vom aktuellen A_TickCount-Wert. Zum Beispiel:

StartZeit := A_TickCount
Sleep, 1000
VerstricheneZeit := A_TickCount - StartZeit
MsgBox,  %VerstricheneZeit% Millisekunden sind verstrichen.

Wenn Sie eine höhere Genauigkeit als die 10 ms von A_TickCount benötigen, verwenden Sie QueryPerformanceCounter().

Die Zeit in Millisekunden, die seit der letzten Eingabe via Tastatur, Maus usw. verstrichen ist. Dies ist nützlich, um festzustellen, ob der Benutzer abwesend ist. Physische Benutzereingaben sowie künstlich erzeugte Eingaben durch ein beliebiges Programm oder Skript (z.B. via Send- oder MouseMove-Befehl) setzen diesen Wert auf 0 zurück. Da dieser Wert tendenziell in 10er-Schritten ansteigt, sollte nicht geprüft werden, ob er mit einem anderen Wert übereinstimmt. Prüfen Sie stattdessen, ob dieser Wert größer oder kleiner als ein anderer Wert ist. Zum Beispiel:

If A_TimeIdle > 600000
    MsgBox, Die letzte Aktivität war vor 10 Minuten

Die Art des Ereignisses, das den aktuellen Thread gestartet hat. Wenn der Thread nicht durch eine GUI-Aktion gestartet wurde, ist diese Variable leer. Andernfalls enthält sie eine der folgenden Zeichenketten:

Normal: Das Ereignis wurde via Linksklick oder Tastendrücke (z.B. ↑, →, ↓, ←, Tab, Leer oder unterstrichene Tastaturkurzbefehle) ausgelöst. Dieser Wert wird auch für Menüpunkte und spezielle Ereignisse wie GuiClose und GuiEscape verwendet.

DoubleClick: Das Ereignis wurde durch einen Doppelklick ausgelöst. Hinweis: Der erste Klick des Doppelklicks bewirkt immer noch, dass ein Normal-Ereignis ausgelöst wird. Mit anderen Worten, die Subroutine wird zweimal gestartet: Zuerst durch den ersten Klick und dann durch den zweiten Klick.

RightClick: Tritt nur bei GuiContextMenu, ListViews und TreeViews auf.

Kontextabhängige Werte: Siehe GuiContextMenu, GuiDropFiles, Slider, MonthCal, ListView und TreeView.

Enthält zusätzliche Informationen über die folgenden Ereignisse:

• Das OnClipboardChange-Label
• Mausrad-Hotkeys (WheelDown/Up/Left/Right)
• OnMessage()
• RegisterCallback()
• Callouts in Regulären Ausdrücken
• GUI-Ereignisse, namentlich GuiContextMenu, GuiDropFiles, ListBox, ListView, TreeView und StatusBar. Wenn es keine zusätzlichen Informationen über ein Ereignis gibt, enthält A_EventInfo den Wert 0.

Der zuletzt ausgeführte Hotkey oder nicht-automatisch-ersetzende Hotstring (andernfalls leer), z.B. #z. Dieser Wert ändert sich, wenn der aktuelle Thread von einem anderen Hotkey oder Hotstring unterbrochen wird, daher ist es ratsam, diesen Wert sofort in eine andere Variable zu speichern, wenn der originale Wert später für eine andere Subroutine benötigt wird.

Jeder neu erstellte Hotkey - entweder via Hotkey-Befehl oder Zweifach-Doppelpunkt-Label - erhält einen festen Namen, der sich aus dem Tastennamen und der Reihenfolge der Modifikatorsymbolen zusammensetzt und von allen Varianten des Hotkeys verwendet wird.

Jeder neu erstellte Hotstring - entweder via Hotstring-Funktion oder Zweifach-Doppelpunkt-Label - erhält einen festen Namen, der sich aus der auslösenden Zeichenkette und der Sequenz von Optionszeichen zusammensetzt.

Siehe auch: A_ThisLabel

Enthält dieselbe Zeichenkette wie die ComSpec-Umgebungsvariable, was üblicherweise der vollständige Pfad zur ausführbaren Datei der Eingabeaufforderung (cmd.exe) ist. Diese Variable wird oft mit Run/RunWait verwendet. Zum Beispiel:

C:\Windows\system32\cmd.exe

Der vollständige Pfadname des Ordners zum Speichern von temporären Dateien. Folgende Orte werden der Reihenfolge nach durchsucht, um den Pfadnamen zu ermitteln: 1) Umgebungsvariable TMP, TEMP oder USERPROFILE; 2) Windows-Verzeichnis. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Local\Temp

Enthält je nach Windows-Version eine der folgenden Zeichenketten: WIN_7 in [AHK_L 42+], WIN_8 in [v1.1.08+], WIN_8.1 in [v1.1.15+], WIN_VISTA, WIN_2003, WIN_XP, WIN_2000.

Beachten Sie, dass das Betriebssystem eine andere Versionsnummer meldet bzw. A_OSVersion einen anderen Wert enthält, wenn der Kompatibilitätsmodus im Eigenschaftenfenster der AutoHotkey-EXE-Datei oder des kompilierten Skripts eingeschaltet wurde.

[v1.1.20+]: Wenn die Systemversion nicht als eine der oben genannten erkannt wird, enthält die Variable eine Zeichenkette im Format "Haupt.Neben.Build". Zum Beispiel ist 10.0.14393 Windows 10 Build 14393, auch bekannt als Version 1607.

; Das folgende Beispiel ist obsolet, da diese Systeme nicht mehr unterstützt werden.
if A_OSVersion in WIN_NT4,WIN_95,WIN_98,WIN_ME  ; Hinweis: Keine Leerzeichen vor oder nach den Kommas.
{
    MsgBox Dieses Skript benötigt Windows 2000/XP oder höher.
    ExitApp
}

Das Verzeichnis der Programmdateien (z.B. C:\Programme oder C:\Programme (x86)). Die Umgebungsvariable ProgramFiles enthält üblicherweise denselben Wert.

Für 64-Bit-Systeme (nicht 32-Bit-Systeme) gilt folgendes:

• Wenn die EXE-Datei, mit der das Skript ausgeführt wird, 32-Bit ist, enthält A_ProgramFiles den Pfadnamen des Ordners "Programme (x86)".
• Für 32-Bit-Prozesse enthält die Umgebungsvariable ProgramW6432 den Pfadnamen des 64-Bit-Ordners "Programme". In Windows 7 und höher wird sie auch für 64-Bit-Prozesse gesetzt.
• Die Umgebungsvariable ProgramFiles(x86) enthält den Pfadnamen des 32-Bit-Ordners "Programme (x86)".

[v1.0.43.08+]: Das Präfix "A_" kann weggelassen werden, um den Umstieg auf #NoEnv zu unterstützen.

Der vollständige Pfadname des Ordners, der anwendungsspezifische Daten des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming

Der vollständige Pfadname des Ordners, der anwendungsspezifische Daten aller Benutzer enthält. Zum Beispiel:

C:\ProgramData

Der vollständige Pfadname des Ordners, der die Desktop-Dateien des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\Desktop

Der vollständige Pfadname des Ordners, der die Desktop-Dateien aller Benutzer enthält. Zum Beispiel:

C:\Users\Public\Desktop

Der vollständige Pfadname des Ordners, der die Startmenü-Dateien des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu

Der vollständige Pfadname des Ordners, der die Startmenü-Dateien aller Benutzer enthält. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu

Der vollständige Pfadname des Startmenü-Ordners "Programme" des aktuellen Benutzers. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs

Der vollständige Pfadname des Startmenü-Ordners "Programme" aller Benutzer. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs

Der vollständige Pfadname des Startmenü-Ordners "Autostart" des aktuellen Benutzers. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

Der vollständige Pfadname des Startmenü-Ordners "Autostart" aller Benutzer. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

Der vollständige Pfadname des Ordners "Dokumente", der beliebige Dateien (vorzugsweise Dokumente) des aktuellen Benutzers enthält. Im Gegensatz zu den meisten anderen ähnlichen Variablen wird, wenn der Ordner das Stammverzeichnis eines Laufwerks ist, der umgekehrte Schrägstrich am Ende weggelassen (z.B. M: statt M:\). Zum Beispiel:

C:\Users\<Benutzer>\Documents

Enthält 1, wenn der aktuelle Benutzer Adminrechte hat, andernfalls 0.

Wenn das Skript sich selbst mit Adminrechten neu starten soll (oder um diese Rechte vom Benutzer via Dialogfenster einzufordern), verwenden Sie Run *RunAs. Beachten Sie aber, dass die Skriptausführung als Administrator dazu führt, dass alle Programme, die vom Skript gestartet werden, ebenfalls als Administrator ausgeführt werden. Eine mögliche Alternative finden Sie in der FAQ.

A_ScreenWidth
A_ScreenHeight

Die Breite und Höhe des primären Bildschirms in Pixel (z.B. 1024 und 768).

Mit SysGet können die Dimensionen von nicht-primären Bildschirmen abgerufen werden.

Um stattdessen die Breite und Höhe des gesamten Desktops abzurufen (selbst wenn er sich über mehrere Bildschirme erstreckt), verwenden Sie folgendes Beispiel:

SysGet, VirtuelleBreite, 78
SysGet, VirtuelleHöhe, 79

Mit SysGet kann auch der Arbeitsbereich eines Bildschirms abgerufen werden. Dieser Bereich ist in der Regel kleiner als der gesamte Bildschirmbereich, da die Taskleiste und andere registrierte Desktopsymbolleisten ausgeschlossen werden.

Der Typ des aktuell angezeigten Mauszeigers. Die Variable enthält eines der folgenden Wörter: AppStarting, Arrow, Cross, Help, IBeam, Icon, No, Size, SizeAll, SizeNESW, SizeNS, SizeNWSE, SizeWE, UpArrow, Wait, Unknown. Die Großbuchstaben hinter Size sind Himmelsrichtungen, z.B. NESW = NorthEast+SouthWest (Nordost+Südwest). Die handförmigen Mauszeiger (Zeigen und Greifen) sind als Unknown klassifiziert.

Die aktuelle X- und Y-Koordinate des Textcursors (Texteinfügemarke). Standardmäßig sind die Koordinaten relativ zum aktiven Fenster. Mit CoordMode können die Koordinaten relativ zum gesamten Bildschirm gemacht werden. Wenn kein Fenster aktiv ist oder die Position des Textcursors nicht ermittelt werden kann, sind diese Variablen leer.

Das folgende Skript zeigt die aktuellen Positionsdaten eines Textcursors in einem sich selbst aktualisierenden Tooltip an. Beachten Sie, dass einige Fenster (z.B. bestimmte Versionen von MS Word) immer die gleichen Positionsdaten melden, egal wo sich der Textcursor gerade befindet.

#Persistent
SetTimer, TextcursorAbfragen, 100
return
TextcursorAbfragen:
    ToolTip, X%A_CaretX% Y%A_CaretY%, A_CaretX, A_CaretY - 20
return

Enthalten 1 und 0. Diese können verwendet werden, um die Lesbarkeit eines Skripts zu verbessern. Einzelheiten finden Sie unter Boolesche Werte.