ReplacePageRanges
Манипуляция документами
Описание
Заменяет видимое содержимое и оформление на уровне страниц существующих страниц выбранного документа страницами, импортированными из другого открытого документа, сохраняя целевые объекты страниц
Синтаксис
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;Параметры
| DocumentID | Идентификатор открытого документа-источника, который должен отличаться от выбранного целевого документа |
|---|---|
| TargetStartPage | Номер страницы с базой 1 в выбранном целевом документе, с которой начинается замена |
| RangeList | Выражение диапазонов страниц источника, например "1-3,5"; недопустимые символы или страницы вне диапазона приводят к сбою всего вызова |
| Options | 0 сортирует страницы и удаляет дубликаты; 1 сохраняет порядок источника и допускает повторяющиеся номера страниц |
Возвращаемые значения
| 0 | Проверка или замена не удались, целевые страницы остались без изменений |
|---|---|
| 1 | Запрошенные целевые страницы заменены |
Замечания
Операция переносит Contents, Resources, пять коробок страниц, Rotate, Group, UserUnit и BoxColorInfo. Номера объектов целевых страниц, аннотации, виджеты форм, назначения закладок и другие существующие ссылки остаются привязанными. Аннотации, поля формы и структуры источника не импортируются. Число страниц остаётся неизменным, а все диапазоны источника и ёмкость цели проверяются до изменения
Пример
var SourceDoc: Integer;
SourceDoc := PDF.LoadFromFile('source.pdf', '');
PDF.SelectDocument(MainDoc);
// Replace page 2 of MainDoc with page 1 of source.pdf
PDF.ReplacePageRanges(SourceDoc, 2, '1', 0);