THotPDF Page Operation – metody

THotPDF

Tyto metody poskytují workflow načteného dokumentu pro vkládání, extrakci, kopírování, ukládání a přeřazování stránek

Syntaxe Delphi:

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

procedure AppendPagesFromDocument(SourceDoc: THotPDF; const PageRange: string);

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);

procedure MovePage(PageIndex: Integer; NewPageIndex: Integer);

procedure SaveLoadedDocument(const TargetFile: TFileName);

property OnPageOperationProgress: THPDFPageOperationProgressEvent;

Popis

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 kopíruje stránky z jiné načtené instance THotPDF do aktuálního dokumentu. Existující volání s poli počítanými od nuly zůstávají podporovaná a řetězcové přetížení přijímá rozsahy stránek počítané od jedné. InsertAfterPage se počítá od nuly; předáním -1 vložíte na začátek

AppendPagesFromDocument připojí vybrané zdrojové stránky na konec aktuálního dokumentu s použitím stejné syntaxe rozsahů stránek počítaných od jedné

CopyPageByPhysicalIndex copies one source page by its zero-based physical page index into a zero-based destination position

ExtractPagesToFile zapíše vybrané stránky z aktuálního dokumentu do nového souboru PDF. Existující volání s poli počítanými od nuly zůstávají podporovaná a řetězcové přetížení přijímá rozsahy stránek počítané od jedné

OnPageOperationProgress reports page-level progress for append, insert, extract, and future merge-style page operations

MovePage změní pořadí aktuálního dokumentu přesunutím jedné stránky počítané od nuly na jinou pozici počítanou od nuly. Metoda aktualizuje pole načtených stránek a kořenový strom stránek, takže následná uložení a volání extrakce použijí nové pořadí

SaveLoadedDocument writes the loaded object graph to a new file after page edits, form edits, or copy operations

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');