MergeFileList
Управление документом
Описание
Объединяет все файлы именованного списка и сохраняет результат в указанный файл. Список собирается функциями ClearFileList, FileListCount и AddToFileList; для успешного слияния в списке должно быть не меньше двух файлов
Разделы оглавления (закладки), поля форм и аннотации всех документов попадут в объединённый документ
Обычный путь слияния чередует временные выходные файлы после первой пары входных, не создавая лишнюю полную копию растущего промежуточного PDF на каждый следующий вход. Поведение возвращаемого счётчика сохраняется, а дисковый ввод-вывод на длинных списках файлов снижается
Синтаксис
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 останавливает операцию, закрывает активные потоки и удаляет неполный вывод. При слиянии списков файлов каждый источник открывается на время сканирования, а при записи активными остаются не более чем первый и текущий reader, так что расход дескрипторов остаётся ограниченным при любом размере списка
Возвращаемые значения
| Число успешно объединённых документов. Если оно меньше ожидаемого, файл, оборвавший слияние, найдёт функция FileListItem |