Variablen und Ausdrücke

Umschließt man innerhalb eines Ausdrucks eine Variable mit Prozentzeichen (z. B. %Var%), wird alles, was in dieser Variable enthalten ist, als Name oder Teil eines Namens einer anderen Variable angesehen (wenn es diese Variable nicht gibt, wird %Var% in eine leere Zeichenkette aufgelöst). Meistens wird das verwendet, um auf Elemente eines Pseudo-Arrays zu verweisen, wie z. B.:

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, der von Prozentzeichen umschlossen ist (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/nur lesbare Variable aufgelöst werden. Vor Revision 52 wurde %Var% in solchen Fällen in eine leere Zeichenkette aufgelöst.

Potenz. Sowohl die Basis als auch der Exponent können einen Dezimalpunkt enthalten. Ist der Exponent negativ, 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 hat als ein unäres Minuszeichen, wird -2**2 wie -(2**2) ausgewertet und daher -4 zurückgeben. Um also eine direkt geschriebene negative Zahl zu potenzieren, muss sie in runden Klammern gesetzt werden, z. B. (-2)**2.

Hinweis: Eine negative Basis in Verbindung mit einem gebrochenen Exponenten wie (-2)**0.5 wird nicht unterstützt; das Ergebnis wird eine leere Zeichenkette sein. Schreibweisen wie (-2)**2 und (-2)**2.0 werden aber unterstützt.

Hinweis: In AutoHotkey v1 ist ** im Gegensatz zu seinem mathematischen Gegenstück linksassoziativ. x ** y ** z beispielsweise wird 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; zum Beispiel: -(3 / -x). Unäre Pluszeichen (+) werden hingegen in einem Ausdruck ignoriert.

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

Bitweises NICHT (~): Dieser Operator invertiert jedes Bit seines Operanden. Handelt es sich bei den Operanden um eine Floating-Point-Zahl, wird er vor der Berechnung auf Integer-Größe gekürzt. Ist der Operand eine Zahl zwischen 0 und 4294967295 (0xffffffff), wird er als vorzeichenloser 32-Bit-Wert behandelt. Ansonsten wird er als vorzeichenfähiger 64-Bit-Wert behandelt. Zum Beispiel wäre ~0xf0f dann 0xfffff0f0 (4294963440).

Adresse (&): &MeineVar ruft die Adresse des Inhalts von MeineVar im Speicher ab, was häufig in Verbindung mit DllCall-Strukturen genutzt wird. &MeineVar deaktiviert außerdem das Caching von Binärzahlen in dieser Variable, was sich negativ auf ihre Leistung 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()).

Dereferenzierung (*): *Ausdruck geht davon aus, dass sich Ausdruck in eine numerische Speicheradresse auflöst; es wird versucht, das Byte auf dieser Adresse als Zahl im Bereich von 0 und 255 abzurufen (wenn die Adresse 0 ist, wird immer 0 abgerufen; jede andere ungültige Adresse sollte man vermeiden, da sie das Skript zum Absturz bringen könnte). Beachten Sie, dass NumGet() in der Regel eine deutlich bessere Leistung erzielt, wenn es darum geht, binäre Zahlen abzurufen.

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

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

Floor-Dividieren (//): Der Doppelschrägstrich-Operator verwendet eine sehr leistungsfähige Integer-Division, wenn beide Eingabewerte Integer sind. Zum Beispiel wäre 5//3 gleich 1 und 5//-3 gleich -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 wäre 5//3.0 gleich 1.0 und 5.0//-3 gleich -2.0. Obwohl das Ergebnis dieser Floating-Point-Division ein Integer ist, wird es in nachfolgenden Operationen als Floating-Point-Zahl behandelt. Um stattdessen eine Division mit Rest (Modulo) durchzuführen, siehe Mod().

Die Operatoren *= und /= sind Kurzschreibweisen zum Multiplizieren oder Dividieren eines Variablenwertes mit einem anderen Wert. Var *= 2 liefert zum Beispiel das gleiche Ergebnis wie Var := Var * 2 (allerdings ist die erste Schreibweise performanter).

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

Addieren (+) und Subtrahieren (-). Die Operatoren += und -= sind Kurzschreibweisen zum Erhöhen oder Verringern eines Variablenwertes um einen beliebigen Wert. Var += 2 liefert zum Beispiel das gleiche Ergebnis wie Var := Var + 2 (allerdings ist die erste Schreibweise performanter). Des Weiteren gibt es die Möglichkeit, eine Variable mit Var++, Var--, ++Var oder --Var schrittweise um 1 zu erhöhen oder zu verringern.

Bitweise Verschiebung nach links (<<). Anwendungsbeispiel: Wert1 << Wert2. Das ist das gleiche wie, als würde man Wert1 mit "2, potenziert um Wert2" multiplizieren.

Arithmetische bitweise Verschiebung nach rechts (>>). Anwendungsbeispiel: Wert1 >> Wert2. Das ist das gleiche wie, als würde man Wert1 mit "2, potenziert um Wert2" dividieren und dann das Ergebnis auf den am nächsten links befindlichen Integer runden; zum Beispiel wäre -3>>1 gleich -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. Mit dem Punkt-Operator können zwei Elemente kombiniert werden, um eine einzelne Zeichenkette zu erhalten (auf beiden Seiten des Punktes muss mindestens ein Leerzeichen vorhanden sein). Dasselbe Ergebnis kann auch ohne diesen Punkt erzielt werden (außer bei Zweideutigkeiten wie x -y, oder wenn das rechts befindliche Element ein ++ oder -- davor hat). Lässt man den Punkt weg, müssen die Elemente, die zusammengeführt werden sollen, mit mindestens einem Leerzeichen getrennt werden.
Beispiel (Ausdrucksmethode): Var := "Die Farbe ist " . GefundeneFarbe
Beispiel (traditionelle Methode): Var = Die Farbe ist %GefundeneFarbe%

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überliegenden Zeile verbunden.

Größer (>), kleiner (<), größer gleich (>=) und kleiner gleich (<=). Wenn beide Eingabewerte Zahlen oder numerische Zeichenketten sind, werden sie numerisch verglichen; ansonsten 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 vom Verketten mit einer in Anführungszeichen gesetzte Zeichenkette) nie als numerisch gewertet, 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; ansonsten werden sie alphabetisch verglichen. Die Operatoren != und <> sind funktional identisch. 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 ist abhängig von StringCaseSense). Die Operatoren <> und != berücksichtigen hingegen 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 vom Verketten mit einer in Anführungszeichen gesetzte Zeichenkette) nie als numerisch gewertet, 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 auf den Inhalt einer Variable aus und speichert das Ergebnis wieder in die gleiche Variable (früher vor v1.0.46 konnten sie nur als Operator ganz links auf einer Zeile verwendet werden, außerdem wurden nur die ersten fünf Operatoren unterstützt). Der einfachste Zuweisungsoperator ist der Doppelpunkt-Gleich-Operator (:=), der das Ergebnis eines Ausdrucks in eine Variable speichert. Eine Beschreibung dessen, was die anderen Operatoren tun, finden Sie in den entsprechenden Einträgen dieser Tabelle. Var //= 2 beispielsweise führt eine Floor-Division durch, um Var durch 2 zu teilen, und speichert dann das Ergebnis wieder in Var. Ein weiteres Beispiel ist Var .= "abc", was die Kurzschreibweise für Var := Var . "abc" wäre.

Im Gegensatz zu den meisten anderen Operatoren werden Zuweisungen von rechts nach links ausgewertet. Eine Zeile wie Var1 := Var2 := 0 würde also erst eine 0 in Var2 speichern und dann Var2 in Var1 speichern.

Verwendet man eine Zuweisung im Eingabewert eines anderen Operators, wird die Variable selbst als Eingabewert genommen. Der Ausdruck (Var += 2) > 50 wäre beispielsweise wahr, wenn der gerade eben erhöhte Wert in Var größer als 50 ist. Eine auf diese Weise verwendete Zuweisung kann auch via Referenz (ByRef) übergeben werden, oder ihre Adresse zurückgeben; zum Beispiel: &(x:="abc").

Die Priorität der Zuweisungsoperatoren erhöht sich automatisch, wenn dadurch ein Syntaxfehler verhindert oder ein besseres Verhalten bereitgestellt werden kann. Zum Beispiel: not x := y würde als not (x := y) ausgewertet werden. ++Var := X würde als ++(Var := X) ausgewertet werden; und Z > 0 ? X := 2 : Y := 2 würde als Z > 0 ? (X := 2) : (Y := 2) ausgewertet werden.

>>>= 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, einer der Eingabewerte ist eine Floating-Point-Zahl (in allen anderen Fällen führt /= eine echte Division durch); 2) Datum/Zeit-Berechnung mit += und -= ist nur möglich, wenn dieser Operator der Operator ganz links auf der Zeile ist; 3) Die Operatoren +=, -= und *= behandeln leere Variablen als 0, aber nur, wenn sie einzeln auf einer Zeile stehen; y := 1, x += 1 und MsgBox % x -= 3 würden beispielsweise ein leeres Ergebnis erzeugen, falls x leer ist.

Komma (Mehrfachanweisung) [v1.0.46+]. Kommas können genutzt werden, um mehrere Teilausdrücke auf einer Zeile zu schreiben. Diese Vorgehensweise wird häufig angewendet, 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überliegenden Zeile verbunden. Siehe auch: Leistung in Bezug auf Kommas.

[v1.0.46.01+]: Wenn direkt nach einem Komma eine Variable und ein Gleichheitszeichen erfolgt, wird das Gleichheitszeichen automatisch als Zuweisung (:=) behandelt. Alle Teilausdrücke in der folgenden Mehrfachanweisung sind beispielsweise Zuweisungen: x:=1, y=2, a=b=c. Neue Skripte sollten sich nicht auf dieses Verhalten verlassen, weil es eventuell noch geändert wird. Diese Regel gilt nur für reine Variablen und nicht für Doppeldereferenzierungen; die folgende Mehrfachanweisung enthält beispielsweise nur eine Zuweisung: x:=1, %y%=2

Ein beliebiger in Klammern gesetzter Teilausdruck. (3 + 2) * 2 beispielsweise würde zuerst 3 + 2 auswerten.

Bei einer Mehrfachanweisung wird das Ergebnis der ersten Anweisung zurückgegeben. (a := 1, b := 2, c := 3) beispielsweise gibt 1 zurück.

Veraltet: Diese Syntax wird nicht empfohlen. Benutzen 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. Gemäß der Konvention ist das die "Standardmethode" des Objekts. Wenn func kein Objekt enthält, wird stattdessen das Standardbasisobjekt aufgerufen.

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

[AHK_L 60+]: Variadischer Funktionsaufruf. Params ist ein Array (Objekt), das Parameterwerte enthält.

[AHK_L 31+]: Zugriff auf Objektelemente. Ruft einen Wert ab, setzt einen Wert oder ruft eine Methode des Objekts x auf. Hierbei ist y eine Parameterliste oder ein Ausdruck, der einen Methodennamen zurückgibt.

[v1.0.97+]: Direkte Array-Schreibweise. Wenn die eckige Startklammer keinen Wert (oder Teilausdruck, der einen Wert zurückgibt) davor hat, wird die Klammer als Beginn eines direkt geschriebenen Arrays interpretiert. [a, b, c] beispielsweise ist das gleiche wie Array(a, b, c) (a, b und c sind Variablen).

Weitere Informationen finden Sie unter Array-Syntax und Objektsyntax.

[v1.0.97+]: Direkte Objekt-Schreibweise. Erstellt ein Objekt oder assoziatives Array. x := {a: b} beispielsweise ist das gleiche wie x := Object("a", b) oder x := Object(), x.a := b. Weitere Informationen finden Sie unter Assoziative Arrays.

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

Wenn das Skript kompiliert oder eingebettet ist, dann ist das hier der Name der aktuellen ausführbaren Datei.

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

Wenn das Skript kompiliert oder eingebettet ist, dann ist das hier der vollständige Pfadname der aktuellen ausführbaren Datei.

Die Nummer der aktuell ausgeführten Zeile innerhalb des Skripts (oder innerhalb einer #Include-Datei, sofern angegeben). Diese Zeilennummer stimmt mit der angezeigten Zeilennummer in ListLines überein; diese Variable ist zum Beispiel nützlich, um einen Fehler zu melden: MsgBox, Eine Zeile konnte nicht in die Log-Datei geschrieben werden (Zeilennummer %A_LineNumber%)

Da beim Kompilieren eines Skripts alle #Include-Dateien zusammengefügt werden, sind die Zeilen eventuell anders nummeriert als im unkompilierten Modus.

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

Wenn das Skript basierend auf einer BIN-Datei kompiliert wurde, ist das hier der vollständige Pfadname der aktuellen ausführbaren Datei, analog zu A_ScriptFullPath.

[v1.1.34+]: Wenn das Skript eingebettet ist, enthält A_LineFile ein Sternchen (*), gefolgt von dem Ressourcennamen; z. B. *#1

Bei unkompilierten oder eingebetteten Skripten: Der vollständige Pfadname der EXE-Datei, mit der das aktuelle Skript gerade ausgeführt wird. Zum Beispiel: C:\Program Files\AutoHotkey\AutoHotkey.exe

Bei kompilierten Skripten, die auf einer BIN-Datei basieren, wird der Wert durch Lesen des Installationsverzeichnisses aus der Registry und Anfügen von "\AutoHotkey.exe" ermittelt. 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+]: Bei kompilierten Skripten, 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 (das als falsch angesehen wird), wenn Zeichenketten im ANSI-Format (8-Bit) sind. Das Format der Zeichenketten ist abhängig davon, mit welcher AutoHotkey-Version das Skript ausgeführt wird oder mit welcher BIN-Datei es kompiliert wurde.

Bei ANSI-basierten Ausführungsdateien 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 sie immer definiert und schreibgeschützt.

Enthält 1, wenn das Skript als kompilierte EXE-Datei ausgeführt wird, oder eine leere Zeichenkette (das als falsch angesehen wird), wenn das nicht der Fall ist.

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 sie 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, können Sie FormatTime, AusgabeVar (Uhrzeit und langes Datum) oder FormatTime, AusgabeVar,, LongDate (langes Datumformat) nutzen.

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 nutzen, um das Datum und/oder die Uhrzeit gemäß Ihrer aktuellen Sprach- und Regionseinstellungen zu formatieren.

Die Zeit in Millisekunden, die seit dem Start des Systems verstrichen ist, bis zu einem Maximum von 49,7 Tagen. Um diese verstrichene Zeit zu messen, speichern Sie A_TickCount in eine Variable und ziehen Sie sie später vom aktuellen A_TickCount-Wert ab. Zum Beispiel:

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

Schauen Sie sich QueryPerformanceCounter() an, wenn Sie eine höhere Genauigkeit als die 10 ms von A_TickCount benötigen.

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

Normal: Das Ereignis wurde via Linksklick oder Tastendrücke (↑, →, ↓, ←, Tab, Leer, unterstrichene Tastaturkurzbefehle und so weiter) 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 wird die Subroutine 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: Um mehr zu erfahren, 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, genauer gesagt GuiContextMenu, GuiDropFiles, ListBox, ListView, TreeView und StatusBar. Wenn es keine zusätzlichen Informationen zu einem Ereignis gibt, enthält A_EventInfo eine 0.

Der zuletzt ausgeführte Hotkey oder nicht-automatisch-ersetzende Hotstring (ansonsten leer), z. B. #z. Dieser Wert ändert sich, wenn der aktuelle Thread von einem anderen Hotkey unterbrochen wird, deshalb 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 fest zugewiesenen Namen, der eine Zeichenkette bestehend aus seinem Tastennamen und der Reihenfolge seiner Modifikatorsymbolen ist. Dieser Name wird von allen Varianten des Hotkeys verwendet.

Jeder neu erstellte Hotstring erhält einen fest zugewiesenen Namen, der identisch zum verwendeten Text ist.

Siehe auch: A_ThisLabel

Enthält wie die ComSpec-Umgebungsvariable den Pfadnamen des Befehlszeileninterpreters. Diese Variable wird oft in Verbindung mit Run/RunWait genutzt. Zum Beispiel:

C:\Windows\system32\cmd.exe

Der vollständige Pfadname des Ordners zum Speichern von temporären Dateien. Folgende Standorte 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 [benötigt AHK_L 42+], WIN_8 [benötigt v1.1.08+], WIN_8.1 [benötigt 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 Eigenschaftsfenster der AutoHotkey-Datei oder des kompilierten Skripts eingeschaltet ist.

[v1.1.20+]: Wenn die Version des Betriebssystems nicht als eine der oben aufgelisteten Versionen erkannt wird, enthält die Variable eine Zeichenkette im Format "Haupt.Neben.Build". 10.0.14393 wäre beispielsweise Windows 10 Build 14393, auch bekannt als Version 1607.

; Das folgende Beispiel ist obsolet, da diese Betriebssysteme nicht mehr unterstützt werden.
if A_OSVersion in WIN_NT4,WIN_95,WIN_98,WIN_ME  ; Hinweis: Keine Leerzeichen hinter 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 in der Regel denselben Wert.

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

• Wenn zum Ausführen des Skripts die 32-Bit-Version von AutoHotkey verwendet wird, enthält A_ProgramFiles den Pfadnamen des Ordners "Programme (x86)".
• 32-Bit-Prozesse können auf die Umgebungsvariable ProgramW6432 zurückgreifen, um den Pfadnamen des 64-Bit-Ordners "Programme" abzurufen. In Windows 7 und höher steht diese Variable auch für 64-Bit-Prozesse zur Verfügung.
• 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 erleichtern.

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 Programme-Ordners im Startmenü des aktuellen Benutzers. Zum Beispiel:

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

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

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

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

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

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

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

Der vollständige Pfadname des Ordners "Eigene Dokumente", der beliebige Dateien (vorzugsweise Dokumente) des aktuellen Benutzers enthält. Wenn der Ordner die oberste Ebene eines Laufwerks ist, wird im Gegensatz zu anderen ähnlichen Variablen der umgekehrte Schrägstrich am Ende weggelassen (zum Beispiel wäre M: anstelle von M:\ enthalten). Zum Beispiel:

C:\Users\<Benutzer>\Documents

Wenn der aktuelle Benutzer über administrative Rechte verfügt, ist eine 1 enthalten. Ansonsten ist eine 0 enthalten.

Um das Skript sich selbst mit administrativen Rechten neu starten zu lassen (oder um diese Rechte vom Benutzer einzufordern), verwenden Sie Run *RunAs. Beachten Sie aber, dass die Ausführung des Skripts als Administrator dazu führt, dass alle vom Skript gestarteten Programme auch 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 Abmessungen von nicht-primären Bildschirmen abgerufen werden.

Das folgende Beispiel zeigt, wie die Breite und Höhe des gesamten Desktops ermittelt werden kann (selbst wenn er sich über mehrere Bildschirme erstrecken sollte):

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

Mit SysGet kann zudem der Arbeitsbereich eines Bildschirms ermittelt werden. Dieser Bereich ist in der Regel kleiner als der Gesamtbereich des Bildschirms, weil die Taskleiste und andere registrierte Desktopsymbolleisten nicht berücksichtigt werden.

Der Typ des aktuell angezeigten Mauszeigers. Die Variable kann eines der folgenden Wörter enthalten: AppStarting, Arrow, Cross, Help, IBeam, Icon, No, Size, SizeAll, SizeNESW, SizeNS, SizeNWSE, SizeWE, UpArrow, Wait, Unknown. Die Großbuchstaben nach Size sind Himmelsrichtungen, z. B. NESW = NorthEast+SouthWest (Nordosten+Südwesten). 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 mithilfe eines selbstaktualisierenden Tooltips an. Beachten Sie, dass einige Fenster (z. B. bestimmte Versionen von MS Word) immer die gleichen Positionsdaten melden, wenn Sie den Textcursor verschieben.

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

Enthalten 1 und 0. Sie können verwendet werden, um ein Skript besser lesbar zu machen. Einzelheiten finden Sie unter Boolesche Werte.