MergeFileList
ドキュメント操作
説明
名前付きファイルリスト内のすべてのファイルを結合し、結果の結合済みドキュメントを指定したファイルに保存します。名前付きファイルリストの構築には ClearFileList、FileListCount、および AddToFileList 関数を使用します。結合を成功させるには、ファイルリストに 2 つ以上のファイルが必要です
すべての文書のアウトライン (ブックマーク)、フォームフィールド、注釈が結合文書に含まれます
通常の結合パスは、最初の入力ファイル対の後で一時出力ファイルを交互に使用し、後続入力ごとに増大する中間 PDF 全体を余分にコピーする処理を回避します。これにより既存の戻り件数動作を維持しながら、長いファイルリストでのディスク I/O を削減します
構文
Delphi
Function TPDFlib.MergeFileList(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileList(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileList(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
パラメータ
| ListName | 結合するファイル一覧の名前 結合したファイルを格納する作成先ファイルのパスとファイル名 |
|---|---|
| OutputFileName |
キャンセルとリソース
マージでは入力の走査およびオブジェクト書き込み中に進行状況を報告します。Abort を呼び出すと操作を停止し、アクティブストリームを閉じて不完全な出力を削除します。ファイル一覧のマージでは、各ソースを走査時に開き、書き込み中は最初と現在のソースリーダーだけを最大限保持するため、一覧が増えてもハンドル使用量は制限されます
戻り値
| 正常に結合された文書数。予定数より少ない場合は FileListItem 関数を使用し、結合処理が途中で終了する原因となったファイルを特定します |