Ersetzt die aktuell laufende Instanz des Skripts mit einer neuen Instanz.
Reload
Dieser Befehl ist für Skripte nützlich, die häufig geändert werden. Sie können diesen Befehl einem Hotkey zuweisen, um das Skript schnell neu zu starten, nachdem Sie Ihre Änderungen in einem Texteditor abgespeichert haben.
Standardmäßig kann das Skript auch über das Tray-Symbol oder das Hauptfenster neu geladen werden.
[v1.1.34+]: Wenn die Befehlszeilenoption /include an die aktuelle Instanz des Skripts übergeben wurde, wird sie automatisch an die neue Instanz übergeben.
Alle anderen Befehlszeilenparameter, die an die aktuelle Instanz des Skripts übergeben wurden, werden nicht an die neue Instanz übergeben. Um solche Parameter zu übergeben, verzichten Sie auf Reload. Verwenden Sie stattdessen Run in Verbindung mit A_AhkPath und A_ScriptFullPath (und A_IsCompiled, wenn das Skript kompiliert ist). Ein Reload kann auch durchgeführt werden, indem die Zeichenkette /restart im ersten Parameter (also direkt nach dem Namen der EXE-Datei) eingefügt wird. Siehe auch: Befehlszeilenoptionen und Syntax.
Der Neustart des Skripts erfolgt in seinem ursprünglichen Arbeitsverzeichnis (also dem Verzeichnis zum Zeitpunkt des ersten Starts). Mit anderen Worten, SetWorkingDir kann nicht verwendet werden, um das Arbeitsverzeichnis für die neue Instanz zu ändern.
Wenn das Skript nicht neu geladen werden kann - z.B. wegen eines Syntaxfehlers - wird die Originalinstanz des Skripts weiter ausgeführt. Daher sollten nach dem Reload-Befehl Maßnahmen für den Fall eines Misserfolgs ergriffen werden (wie z.B. ein Return, um die aktuelle Subroutine zu beenden). Damit die Originalinstanz den Misserfolg erkennt, gehen Sie wie folgt vor:
Reload Sleep 1000 ; Bei Erfolg wird Reload diese Instanz während des Sleeps schließen, wodurch die folgende Zeile nie erreicht wird. MsgBox, 4,, Das Skript konnte nicht neu geladen werden. Möchten Sie es editieren? IfMsgBox, Yes, Edit return
Ältere Instanzen des Skripts werden mit einem Mechanismus identifiziert, der auch bei #SingleInstance zum Einsatz kommt, einschließlich derselben Einschränkungen.
Wenn das Skript mehrere Instanzen von sich selbst zulässt, kann es vorkommen, dass Reload die richtige Instanz nicht erkennt. Die einfachste Alternative ist es, eine neue Instanz via Run zu starten und dann zu beenden. Zum Beispiel:
if A_IsCompiled
Run "%A_ScriptFullPath%" /force
else
Run "%A_AhkPath%" /force "%A_ScriptFullPath%"
ExitApp