FileInstall

Fügt eine bestimmte Datei in die kompilierte Version des Skripts ein.

FileInstall, Quelle, Ziel , Überschreiben

Parameter

Quelle

Name der Datei, die in die kompilierte EXE-Datei eingefügt werden soll. Wenn kein absoluter Pfad angegeben ist, wird die Datei im Arbeitsverzeichnis des Skripts vermutet (bzw. ist relativ zu diesem Verzeichnis).

Der Dateiname darf keine Anführungszeichen, Variablenreferenzen (z. B.%A_ProgramFiles%) oder Platzhalter enthalten. Darüber hinaus müssen Sonderzeichen wie direkt geschriebene Prozentzeichen und Kommas mit einem Escapezeichen versehen werden (wie in jedem anderen Befehlsparameter auch). Dieser Parameter muss auf der rechten Seite von FileInstall erfolgen (also nicht auf einer Fortsetzungszeile darunter).

Ziel

Der Name einer Datei, die erstellt werden soll, wenn Quelle aus der EXE-Datei extrahiert wird. Wenn kein absoluter Pfad angegeben ist, wird die Datei im A_WorkingDir-Verzeichnis erstellt. Das Zielverzeichnis muss bereits vorhanden sein. Im Gegensatz zu Quelle können hier Variablenreferenzen eingesetzt werden.

Überschreiben

Dieser Parameter bestimmt, ob bereits vorhandene Dateien überschrieben werden dürfen. Wenn dieser Parameter 1 (true) ist, wird der Befehl vorhandene Dateien überschreiben. Wenn dieser Parameter weggelassen wird oder 0 (false) ist, wird der Befehl vorhandene Dateien nicht überschreiben.

Dieser Parameter kann ein Ausdruck sein. Es können auch Ausdrücke angegeben werden, die True oder False zurückgeben (weil True und False intern in 1 und 0 aufgelöst werden).

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt.

Kann die Datei aus irgendeinem Grund nicht in das Ziel geschrieben werden, wird das als Fehler eingestuft. Zum Beispiel:

Bemerkungen

Wenn dieser Befehl von Ahk2Exe während der Kompilierung des Skripts gelesen wird, wird die angegebene Datei in Quelle zum resultierenden kompilierten Skript hinzugefügt. Später, wenn die kompilierte Skript-EXE läuft und der FileInstall-Aufruf ausgeführt wird, wird die Datei aus der EXE extrahiert und in den angegebenen Speicherort von Ziel geschrieben.

Dateien, die zu einem Skript hinzugefügt werden, werden während der Kompilierung weder komprimiert noch verschlüsselt, aber die kompilierte Skript-EXE kann mithilfe der entsprechenden Option in Ahk2Exe komprimiert werden.

Wenn dieser Befehl in einem normalen (nicht kompilierten) Skript genutzt wird, werden die Dateien stattdessen einfach kopiert - damit können zukünftig kompilierte Skripte getestet werden.

FileCopy, #Include

Beispiele

Fügt eine Textdatei in die kompilierte Version des Skripts ein. Später, wenn das kompilierte Skript ausgeführt wird, wird die eingefügte Datei in ein anderes Verzeichnis mit einem anderen Dateinamen extrahiert. Wenn in diesem Verzeichnis bereits eine Datei mit diesem Namen existiert, wird sie überschrieben.

FileInstall, Meine Datei.txt, %A_Desktop%\Beispieldatei.txt, 1