MergeFileListA
Document manipulation
Description
The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to MergeFileList and string arguments are interpreted using the current SetAnsiMode code page
Merges all the files in a named file list and saves the resulting merged document to the specified file. Use the ClearFileList, FileListCount and AddToFileList functions to construct the named file list. There must be two or more files in the file list in order for the merging to succeed.
Outlines (bookmarks), form fields and annotations from all the documents will be present in the merged document.
The ordinary merge path alternates temporary output files after the first pair of input files, avoiding an extra full copy of the growing intermediate PDF for each subsequent input. This keeps the existing return-count behaviour while reducing disk I/O on longer file lists.
Syntax
Delphi
Function DLMergeFileListA(InstanceID: Integer; ListName, OutputFileName: PAnsiChar): Integer;DLL
int DLMergeFileListA(int InstanceID, const char * ListName, const char * OutputFileName);Parameters
| ListName | The name of the list of files to merge together The path and file name of the file to create which will contain the merged files. |
|---|---|
| OutputFileName |
Return values
| The number of documents which were successfully merged together. If this is less than the intended number use the FileListItem function to find the file which caused the merge process to end prematurely. |