MergeFileList

文件操作

描述

合併具名檔案清單中的所有檔案，並將合併後的文件存到指定檔案。先用 ClearFileList、FileListCount 與 AddToFileList 函式建好清單；檔案清單必須有兩個以上的檔案，合併才會成功

所有文件的大綱（書籤）、表單欄位與註解都會出現在合併後的文件中

一般合併路徑在第一對輸入檔之後輪流使用暫存輸出檔，避免每多一個輸入就對不斷長大的中間 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);

參數

取消與資源

合併會在掃描輸入與寫出物件時回報進度。呼叫 Abort 會停止操作、關閉作用中的串流並移除不完整的輸出。檔案清單合併會為掃描開啟每個來源，寫入時最多保持第一個與目前的來源讀取器作用中，清單再長控制代碼用量也有界。

傳回值