THotPDF Page Operation Methods

THotPDF

Estes métodos fornecem um fluxo de documento carregado para inserir, extrair e reordenar páginas

Delphi syntax:

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;

Descrição

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 copia páginas de outra instância THotPDF carregada para o documento atual. Chamadas antigas com matriz de base zero continuam com suporte, e a sobrecarga de string aceita intervalos de páginas de base um. InsertAfterPage é de base zero; passe -1 para inserir no início

AppendPagesFromDocument anexa as páginas de origem selecionadas ao fim do documento atual usando a mesma sintaxe de intervalo de páginas de base um

CopyPageByPhysicalIndex copia uma página de origem pelo índice físico baseado em zero para uma posição de destino baseada em zero

ExtractPagesToFile grava páginas selecionadas do documento atual em um novo arquivo PDF. Chamadas antigas com matriz de base zero continuam com suporte, e a sobrecarga de string aceita intervalos de páginas de base um

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

MovePage reordena o documento atual movendo uma página de base zero para outra posição de base zero. O método atualiza a matriz de páginas carregada e a árvore raiz de páginas para que salvamentos e chamadas de extração posteriores usem a nova ordem

SaveLoadedDocument grava o grafo de objetos carregado em um novo arquivo após edições de página, edições de formulário ou operações de cópia

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