CollateDocumentsEx
Манипуляция страницами, сборка документов
Описание
Подшивает страницы нескольких открытых документов в выбранный документ со списком диапазонов на каждый источник, включая обращённые
Синтаксис
Delphi
Function TPDFlib.CollateDocumentsEx(Const SourceDocumentIDs: Array Of Integer; Const RangeLists: WideString; GroupSize: Integer): Integer;Параметры
| SourceDocumentIDs | Дескрипторы открытых исходных документов; выбранный документ в списке появляться не должен |
|---|---|
| RangeLists | Один список диапазонов страниц на источник, разделенный ;. Пустая строка выбирает все страницы всех источников, пустой сегмент — все страницы этого источника. Нисходящие диапазоны вроде 3-1 разворачивают источник, дубликаты страниц сохраняются в заданном порядке |
| GroupSize | Число страниц, добавляемых из каждого источника за раунд |
Возвращаемые значения
| 0 | Недопустимые аргументы, диапазон указывает на отсутствующую страницу, число сегментов не совпадает с числом источников либо копирование не удалось; выбранный документ не меняется |
|---|---|
| 1 | Страницы дописаны в конец выбранного документа |
Примечания
Классический сценарий одностороннего сканера сканирует лицы по порядку, а обороты в обратном; передача списков диапазонов в стиле ;3-1 восстанавливает порядок чтения одним вызовом. Все аргументы валидируются до изменения выбранного документа, поэтому неудавшийся вызов оставляет его нетронутым
Пример
// Fronts 1,2,3 and backs scanned in reverse order
PDF.CollateDocumentsEx([Fronts, Backs], ';3-1', 1);