MergeFileListFast
文件操作
描述
類似 MergeFileList 函式,但使用更先進的演算法提升速度
合併過程中會建立新的檔案清單,內含指定檔案清單中每個項目的合併結果。新清單名稱為原清單名稱加上 Result,例如原清單叫 "MyFiles",新清單就叫 "MyFilesResult"。新清單不含檔名,而是以文字描述各檔案在合併過程中的狀態
檔案清單必須有兩個以上的檔案,合併才會成功
所有文件的表單欄位、註解與大綱(書籤)都會出現在合併後的文件中
語法
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 | 成功合併的檔案數量 |