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 函数查找导致合并过程提前结束的文件