CopyPageRangesEx
Извлечение, манипуляция страницами
Описание
Копирует одну или несколько страниц из открытого документа в выбранный. Options могут сохранить запрошенный порядок страниц и включить семантическое переиспользование ресурсов между исходными документами: умный режим ресурсов хеширует рекурсивно разрешённые графы ресурсов до выделения, поэтому эквивалентные шрифты, изображения, цветовые пространства, узоры, затенения и графические состояния делят существующие целевые объекты, даже если номера объектов или порядок словарей различаются. Совпадения хеша проходят структурное сравнение, а циклические и чувствительные к идентичности объекты страниц и дополнительного содержимого остаются раздельными
Синтаксис
Delphi
Function TPDFlib.CopyPageRangesEx(DocumentID: Integer; Const RangeList: WideString; Options: Integer): Integer;
ActiveX
Function PDFlib::CopyPageRangesEx(DocumentID As Long, RangeList As String, Options As Long) As Long
DLL
int DLCopyPageRangesEx(int InstanceID, int DocumentID, const wchar_t * RangeList, int Options);
Параметры
| DocumentID | ID документа, из которого копируются страницы |
|---|---|
| RangeList | Извлекаемые страницы, например "10,15,18-20,25-35"; недопустимые символы игнорируются |
| Options | Options — битовая маска. PDF_COPY_PAGE_KEEP_ORDER (1) сохраняет запрошенный порядок и дубликаты. PDF_COPY_PAGE_SMART_RESOURCES (2) переиспользует семантически эквивалентные словари ресурсов и потоки, уже имеющиеся в целевом документе. Флаги комбинируются побитовым ИЛИ; 0 сортирует диапазон и игнорирует дубликаты |
Возвращаемые значения
| 0 | Указанный DocumentID недопустим или совпадает с выбранным документом, RangeList недопустим либо Options содержит неподдерживаемый бит |
|---|---|
| 1 | Страницы успешно скопированы из указанного документа в выбранный документ |