ReplacePageRanges
Dokumentmanipulation
Beschreibung
Ersetzt den visuellen Inhalt und die Darstellung auf Seitenebene vorhandener Seiten des ausgewählten Dokuments durch aus einem anderen geöffneten Dokument importierte Seiten und behält dabei die Zielseitenobjekte bei
Syntax
Delphi
Function TPDFlib.ReplacePageRanges(DocumentID, TargetStartPage: Integer; Const RangeList: WideString; Options: Integer= 0): Integer;Parameter
| DocumentID | Die Kennung des geöffneten Quelldokuments, die sich vom ausgewählten Zieldokument unterscheiden muss |
|---|---|
| TargetStartPage | Die 1-basierte Seitennummer im ausgewählten Zieldokument, bei der die Ersetzung beginnt |
| RangeList | Der Ausdruck für Quellseitenbereiche, zum Beispiel "1-3,5"; ungültige Zeichen oder außerhalb des Bereichs liegende Seiten lassen den gesamten Aufruf fehlschlagen |
| Options | 0 sortiert Seiten und entfernt Duplikate; 1 behält die Quellreihenfolge bei und erlaubt wiederholte Seitennummern |
Rückgabewerte
| 0 | Validierung oder Ersetzung schlugen fehl, und die Zielseiten blieben unverändert |
|---|---|
| 1 | Die angeforderten Zielseiten wurden ersetzt |
Hinweise
Die Operation überträgt Contents, Resources, die fünf Seitenboxen, Rotate, Group, UserUnit und BoxColorInfo. Objektnummern der Zielseiten, Anmerkungen, Formular-Widgets, Lesezeichenziele und andere vorhandene Referenzen bleiben erhalten. Quell-Anmerkungen, Formularfelder und Gliederungen werden nicht importiert. Die Seitenzahl bleibt unverändert, und alle Quellbereiche samt Zielkapazität werden vor der Änderung validiert
Beispiel
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);