MergeFileListFast
ドキュメント操作
説明
MergeFileList 関数と似ていますが、高度なアルゴリズムを使用して速度を向上します
結合中に新しいファイルリストが作成され、指定リストの各項目に対する結合結果が格納されます。新しいリスト名は元のリスト名に Result を付加したものです。たとえば元が "MyFiles" なら新しいリストは "MyFilesResult" です。このリストはファイル名ではなく、結合処理中の対応ファイル状態を示すテキストを格納します
結合を成功させるには、ファイルリストに 2 つ以上のファイルが必要です
すべての文書のフォームフィールド、注釈およびアウトライン(ブックマーク)が、結合後の文書に含まれます
構文
Delphi
Function TPDFlib.MergeFileListFast(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileListFast(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileListFast(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
パラメータ
| ListName | 使用するファイルリストの名前です。このリスト内のすべてのファイルが結合されます |
|---|---|
| OutputFileName | 作成する出力ファイルのパスとファイル名です。このファイルにはファイル一覧のすべてのファイルが含まれます |
キャンセルとリソース
マージでは入力の走査およびオブジェクト書き込み中に進行状況を報告します。Abort を呼び出すと操作を停止し、アクティブストリームを閉じて不完全な出力を削除します。ファイル一覧のマージでは、各ソースを走査時に開き、書き込み中は最初と現在のソースリーダーだけを最大限保持するため、一覧が増えてもハンドル使用量は制限されます
戻り値
| 0 | 結合処理を完了できませんでした。GetLastError 関数を使用してエラー原因を特定してください |
|---|---|
| Non-zero | 正常に結合されたファイル数 |