THotPDF Page Operation Methods

THotPDF

이 method들은 page insertion, extraction, copy, save, reorder를 위한 loaded-document workflow를 제공합니다

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;

설명

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는 다른 loaded THotPDF instance의 page를 current document로 복사합니다. 기존 zero-based array call은 계속 지원되며 string overload는 one-based page range를 받습니다. InsertAfterPage는 zero-based입니다. 시작 부분에 삽입하려면 -1을 전달하십시오

AppendPagesFromDocument는 같은 one-based page-range syntax를 사용해 선택한 source page를 current document 끝에 append합니다

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

ExtractPagesToFile은 current document에서 선택한 page를 새 PDF file에 씁니다. 기존 zero-based array call은 계속 지원되며 string overload는 one-based page range를 받습니다

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

MovePage는 zero-based page 하나를 다른 zero-based position으로 이동해 current document를 reorder합니다. 이 method는 loaded page array와 root page tree를 update하여 이후 save 및 extraction call이 새 order를 사용하도록 합니다

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