THotPDF-Seitenoperationsmethoden

Diese Methoden bieten einen Workflow für geladene Dokumente zum Einfügen, Extrahieren, Kopieren, Speichern und Neuanordnen von Seiten

function HPDFParsePageRange(const PageRange: string; PageCount: Integer): THPDFPageIndexArray;

procedure InsertPagesFromDocument(SourceDoc: THotPDF; const PageRange: string; InsertAfterPage: Integer);

procedure InsertPagesFromDocument(SourceDoc: THotPDF; const LogicalPageIndices: array of Integer; InsertAfterPage: Integer);

procedure CopyPageByPhysicalIndex(SourceDoc: THotPDF; SourceIndex: Integer; DestIndex: Integer);

procedure ExtractPagesToFile(const OutputFile: TFileName; const PageRange: string);

procedure ExtractPagesToFile(const OutputFile: TFileName; const LogicalPageIndices: array of Integer);

HPDFParsePageRange converts one-based range strings such as 1,3-4,6- into zero-based page indices. Empty input selects every page. Invalid page numbers, descending ranges, and malformed tokens raise an exception

InsertPagesFromDocument kopiert Seiten aus einer anderen geladenen THotPDF-Instanz in das aktuelle Dokument. Die bestehenden zero-based Array-Aufrufe bleiben unterstützt, und die String-Überladung akzeptiert one-based Seitenbereiche. InsertAfterPage ist zero-based; übergeben Sie -1, um am Anfang einzufügen

AppendPagesFromDocument hängt die ausgewählten Quellseiten unter Verwendung derselben einsbasierten Seitenbereichssyntax an das Ende des aktuellen Dokuments an

CopyPageByPhysicalIndex kopiert eine Quellseite anhand ihres nullbasierten physischen Seitenindex in eine nullbasierte Zielposition

ExtractPagesToFile schreibt ausgewählte Seiten aus dem aktuellen Dokument in eine neue PDF-Datei; vorhandene nullbasierte Array-Aufrufe werden weiterhin unterstützt, und die String-Überladung akzeptiert einsbasierte Seitenbereiche

OnPageOperationProgress meldet den Fortschritt auf Seitenebene für das Anhängen, Einfügen, Extrahieren und zukünftige Zusammenführungsvorgänge von Seiten

MovePage ordnet das aktuelle Dokument neu an, indem eine nullbasierte Seite an eine andere nullbasierte Position verschoben wird; die Methode aktualisiert das geladene Seitenarray und den Stammseitenbaum, sodass nachfolgende Speicher- und Extraktionsaufrufe die neue Reihenfolge verwenden

SaveLoadedDocument schreibt den geladenen Objektgraphen nach Seitenbearbeitungen, Formularbearbeitungen oder Kopiervorgängen in eine neue Datei

Code Example

BasePDF.LoadFromFile('base.pdf');
InsertPDF.LoadFromFile('insert.pdf');

BasePDF.InsertPagesFromDocument(InsertPDF, '1-2', 0);
BasePDF.AppendPagesFromDocument(InsertPDF, '2');
BasePDF.MovePage(BasePDF.PagesCount - 1, 1);
BasePDF.ExtractPagesToFile('selected-pages.pdf', '2,4');
BasePDF.SaveLoadedDocument('reordered.pdf');