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 (oder relativ zum) Arbeitsverzeichnis des Skripts vermutet.

Der Dateiname darf keine doppelten Anführungszeichen, Variablenreferenzen (z.B. %A_ProgramFiles%) oder Platzhalter enthalten. Außerdem 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 stehen (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 existieren. Im Gegensatz zu Quelle können Variablenreferenzen verwendet werden.

Überschreiben

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Zahlen an, um festzulegen, ob bereits vorhandene Dateien überschrieben werden dürfen:

0: Vorhandene Dateien werden nicht überschrieben. Die Operation wird fehlschlagen und keinen Effekt haben, wenn Ziel bereits existiert.

1: Vorhandene Dateien werden überschrieben.

Dieser Parameter kann ein Ausdruck sein, auch einer, der nach der Auswertung 1, 0 oder eine leere Zeichenkette ergibt.

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.

Misserfolg ist, wenn die Datei nicht in das Ziel geschrieben werden kann. Zum Beispiel:

Bemerkungen

Wenn dieser Befehl von Ahk2Exe während der Kompilierung des Skripts gelesen wird, wird Quelle zum resultierenden kompilierten Skript hinzugefügt. Wenn die kompilierte Skript-EXE später ausgeführt wird und die Ausführung die Zeile mit FileInstall erreicht, wird die Datei aus der EXE extrahiert und in Ziel geschrieben.

Dateien, die zu einem Skript hinzugefügt werden, werden während der Kompilierung nicht komprimiert oder verschlüsselt. Allerdings kann die kompilierte Skript-EXE via Ahk2Exe-Option komprimiert werden.

Wenn dieser Befehl in einem normalen (unkompilierten) Skript verwendet wird, wird stattdessen eine einfache Dateikopie durchgeführt - dies hilft beim Testen von Skripten, die später kompiliert werden.

FileCopy, #Include

Beispiele

Fügt eine Textdatei in die kompilierte Version des Skripts ein. Wenn das kompilierte Skript später 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 diese überschrieben.

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