ReplacePageRanges
Manipulare documente
Descriere
Înlocuiește conținutul vizual și prezentarea la nivel de pagină ale paginilor existente din documentul selectat cu pagini importate dintr-un alt document deschis, păstrând în același timp obiectele de pagină țintă
Sintaxă
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;Parametri
| DocumentID | Identificatorul documentului sursă deschis, care trebuie să difere de documentul țintă selectat |
|---|---|
| TargetStartPage | Numărul paginii, cu bază 1, din documentul țintă selectat, unde începe înlocuirea |
| RangeList | Expresia intervalului de pagini sursă, de exemplu "1-3,5"; caracterele nevalide sau paginile din afara intervalului fac ca întregul apel să eșueze |
| Options | 0 sortează paginile și elimină duplicatele; 1 păstrează ordinea sursei și permite numere de pagină repetate |
Valori returnate
| 0 | Validarea sau înlocuirea a eșuat, iar paginile țintă au rămas neschimbate |
|---|---|
| 1 | Paginile țintă solicitate au fost înlocuite |
Observații
Operațiunea transferă Contents, Resources, cele cinci casete de pagină, Rotate, Group, UserUnit și BoxColorInfo. Numerele de obiect ale paginilor țintă, adnotările, widgeturile de formular, destinațiile de semne de carte și celelalte referințe existente rămân atașate. Adnotările sursă, câmpurile de formular și structurile outline nu sunt importate. Numărul de pagini rămâne neschimbat, iar toate intervalele sursă, împreună cu capacitatea țintă, sunt validate înainte de modificare
Exemplu
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);