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);
参数
| ListName | 要合并的文件列表的名称 要创建的文件的路径与文件名,其中将包含合并后的文件 |
|---|---|
| OutputFileName |
取消和资源
合并在扫描输入和写入对象期间报告进度。调用 Abort 会停止操作、关闭活动流并移除不完整的输出。文件列表合并为扫描打开每个源,写入时最多保持第一个和当前源读取器活动,因此列表增长时句柄使用保持有界
返回值
| 成功合并的文档数量,若小于预期数量,请使用 FileListItem 函数查找导致合并过程提前结束的文件 |