MergeFileListStrict
文件操作
描述
合併具名檔案清單,並把合併後的 PDF 寫入 OutputFileName。標籤式 PDF、大綱、表單欄位與註解的保留路徑與 MergeFileList 相同。
與 MergeFileList 不同,strict 模式遇到第一個無法讀取、加密、損毀或遺失的輸入就停止。需要先前的「首次失敗即停」行為時就用它。
語法
Delphi
Function TPDFlib.MergeFileListStrict(Const ListName, OutputFileName: WideString): Integer;
參數
| ListName | 要合併的具名檔案清單。用 ClearFileList、AddToFileList 與 FileListCount 建立它。 |
|---|---|
| OutputFileName | 要建立的 PDF 路徑與檔名。 |
取消與資源
合併會在掃描輸入與寫出物件時回報進度。呼叫 Abort 會停止操作、關閉作用中的串流並移除不完整的輸出。檔案清單合併會為掃描開啟每個來源,寫入時最多保持第一個與目前的來源讀取器作用中,清單再長控制代碼用量也有界。
傳回值
| 0 | 合併未產生輸出檔案。 |
|---|---|
| Non-zero | 成功合併的輸入檔案數量。各檔案的狀態訊息請用 FileListItem 檢視 ListName + "Result"。 |