Zeigt einen Fehler an und beendet das Programm, wenn die Versionsanforderung nicht erfüllt ist.
#Requires Anforderung
Typ: Zeichenkette
Wenn dieser Parameter nicht mit dem Wort "AutoHotkey" beginnt, wird eine Fehlermeldung angezeigt und das Programm beendet. Dies dient der Übersichtlichkeit und reserviert die Direktive für zukünftige Zwecke. Andere Entwicklungszweige von AutoHotkey können andere Namen unterstützen.
Andernfalls muss nach dem Wort "AutoHotkey" eine beliebige Kombination der folgenden Zeichen angegeben werden, getrennt durch Leer- oder Tabulatorzeichen:
<, <=, >, >= oder =, unmittelbar gefolgt von einem optionalen "v" und einer Versionsnummer. >=2-rc <2 erlaubt zum Beispiel v2 Release Candidates, aber nicht die finale Version.Die angezeigte Meldung ist abhängig von der Version von AutoHotkey, die die Direktive interpretiert.
Die Fehlermeldung zeigt immer den Pfad, die Version und den Build von AutoHotkey an.
Wenn das Skript mit einer Version von AutoHotkey gestartet wird, die diese Direktive nicht unterstützt, sieht die Fehlermeldung in etwa so aus:
Line Text: #Requires %Anforderung% Error: This line does not contain a recognized action.
Wenn das Skript Syntaxelemente oder Funktionen verwendet, die in früheren Versionen nicht verfügbar sind, können Sie mit dieser Direktive sicherstellen, dass die Fehlermeldung die unerfüllte Anforderung und nicht einen willkürlichen Syntaxfehler anzeigt. Das ist mit so etwas wie if (A_AhkVersion <= "1.1.33") nicht möglich, weil ein Syntaxfehler an anderer Stelle im Skript dessen Ausführung verhindern würde.
Wenn Sie ein Skript mit anderen teilen oder den Code ins Internet stellen, können Sie mit dieser Direktive sicherstellen, dass jeder, der den Code findet, schnell erkennen kann, für welche AutoHotkey-Version dieser Code gedacht ist.
Andere Programme oder Skripte können diese Direktive für verschiedene Zwecke überprüfen. Der Launcher von AutoHotkey v2 verwendet diese Information zum Beispiel, um festzustellen, welche EXE-Datei von AutoHotkey gestartet werden soll, während ein Skripteditor oder ähnliche Tools diese Information beispielsweise verwenden können, um festzustellen, wie die Skriptdatei interpretiert oder farblich hervorgehoben werden soll.
Versionszeichenketten werden als eine Reihe von via Punkt getrennten Komponenten verglichen, optional gefolgt von einem Bindestrich und Vorabversionsidentifikator(en).
#Requires AutoHotkey v2 unter v2.0-a112 nicht ausgeführt. Um Vorabversionen zu erlauben, fügen Sie einen Bindestrich hinzu. Zum Beispiel: v2.0-.Ein "+" am Ende genügt, um den Leser darauf hinzuweisen, dass spätere Versionen akzeptabel, aber nicht erforderlich sind.
#Requires kann wie alle anderen Direktiven nicht bedingt ausgeführt werden.
Bewirkt, dass das Skript nur in v2.0 inklusive Alpha-Versionen läuft.
#Requires AutoHotkey v2.0-a MsgBox "Dieses Skript läuft nur in v2.0 inklusive Alpha-Versionen."