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