FileInstall

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

FileInstall, Quelle, Ziel [, Flag]

Parameter

Quelle

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

Der Dateiname darf keine Anführungszeichen, Variablenverweise (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). Schließlich muss dieser Parameter rechts von FileInstall erfolgen (d. h. nicht auf eine Fortsetzungszeile darunter).

Ziel

Der neue Name der Datei, wenn Quelle aus der EXE-Datei extrahiert wird. Die Datei befindet sich im A_WorkingDir-Verzeichnis, solange kein absoluter Pfad angegeben ist. Das Zielverzeichnis muss bereits vorhanden sein. Im Gegensatz zu Quelle können hier Variablenverweise eingesetzt werden.

Flag

(Optional) Dieser Parameter bestimmt, ob bereits vorhandene Dateien überschrieben werden dürfen:

0 = (Standard) vorhandene Dateien nicht überschreiben
1 = vorhandene Dateien überschreiben

Dieser Parameter kann ein Ausdruck sein, auch einer, der als wahr oder falsch gewertet wird (weil True und False intern als 1 und 0 gespeichert sind).

ErrorLevel

[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.

Bemerkungen

Dieser Befehl ist eine Direktive für den Ahk2Exe-Compiler, mit der zusätzliche Dateien in das kompilierte Skript eingefügt werden können. Später, wenn das kompilierte Skript läuft, werden die Dateien wieder zurück auf das Laufwerk extrahiert.

Die Datei wird während der Skript-Kompilierung eingefügt. Erreicht die Ausführung des kompilierten Skripts den FileInstall-Befehl, wird die Datei auf das Ziel extrahiert.

Eingefügte Dateien sind komprimiert als auch verschlüsselt.

Verwendet man diesen Befehl in einem normalen (nicht kompilierten) Skript, wird die Datei stattdessen einfach kopiert - um Skripte zu testen, die später vielleicht kompiliert werden).

Siehe auch

FileCopy, #Include

Beispiel

FileInstall, C:\Meine Dokumente\Meine Datei.txt, %A_ProgramFiles%\Meine Anwendung\Readme.txt, 1