指定されたファイルを、コンパイルされたバージョンのスクリプトの中に含めます。
FileInstall Source, Dest , Overwrite
型:文字列
コンパイルされたEXEに追加される単一のファイル名。絶対パスが指定されていない場合、ファイルはスクリプト自身のディレクトリにある(または相対的な)ものとみなされます。
このパラメータは、引用符で囲まれたリテラル文字列(変数やその他の式ではない)でなければならず、関数名FileInstallの右側に記載する必要があります(つまり、その下の継続行に記載してはいけません)。
型:文字列
EXEからSourceを展開する際に、作成されるファイル名です。絶対パスが指定されていない場合は、A_WorkingDirにあるとみなされます。保存先ディレクトリはすでに存在している必要があります。
型:整数
省略したときの初期値は0です。Otherwise, specify one of the following numbers to indicate whether to overwrite files if they already exist:
0:既存ファイルを上書きしません。The operation will fail and have no effect if Dest already exists.
1:既存ファイルを上書きします。
その他の値は、将来の使用のために予約されています。
失敗した場合は例外がスローされます。
宛先にファイルを書き込めない場合は、すべて失敗とみなします。事例:
この関数の呼び出しがスクリプトのコンパイル中にAhk2Exeによって読み込まれると、Sourceで指定されたファイルがコンパイル後のスクリプトに追加されます。その後、コンパイルされたスクリプトEXEが実行され、FileInstallの呼び出しが実行されると、EXEからファイルが抽出され、Destで指定された場所に書き込まれます。
スクリプトに追加されたファイルは、コンパイル時に圧縮も暗号化もされませんが、コンパイルされたスクリプトEXEは、Ahk2Exeの適切なオプションを使用することで圧縮することができます。
この関数を通常の(コンパイルされていない)スクリプトで使用した場合、代わりに単純なファイルコピーが実行されます -- これは、最終的にコンパイルされるスクリプトのテストに役立ちます。完全なソースパスとデスティネーションパスが等しい場合、現在の場所にファイルをコピーしようとするとエラーになるため、何もしない。パスはGetFullPathNameで展開した後、lstrcmpiで比較されます。