MergeFileListFast
Управление документом
Описание
Похоже на MergeFileList, но использует усовершенствованный алгоритм для ускорения
Во время слияния будет создан новый список файлов с результатом обработки каждого элемента указанного списка. Имя нового списка — имя исходного с добавленным словом Result: для исходного списка "MyFiles" новый назовётся "MyFilesResult". Имён файлов в нём не будет — только текстовое описание статуса каждого файла в процессе слияния
Для успешного слияния в списке должно быть не меньше двух файлов
Поля форм, аннотации и разделы оглавления (закладки) из всех документов попадут в объединённый документ
Синтаксис
Delphi
Function TPDFlib.MergeFileListFast(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileListFast(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileListFast(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
Параметры
| ListName | Имя используемого списка файлов; все файлы списка будут объединены |
|---|---|
| OutputFileName | Путь и имя создаваемого выходного файла; он будет содержать все файлы из списка |
Отмена и ресурсы
Слияние сообщает прогресс при сканировании входов и записи объектов. Вызов Abort останавливает операцию, закрывает активные потоки и удаляет неполный вывод. При слиянии списков файлов каждый источник открывается на время сканирования, а при записи активными остаются не более чем первый и текущий reader, так что расход дескрипторов остаётся ограниченным при любом размере списка
Возвращаемые значения
| 0 | Слияние не удалось завершить; причину покажет функция GetLastError |
|---|---|
| Non-zero | Число успешно объединённых файлов |