THotPDF Page Operation Methods

THotPDF

Эти методы предоставляют loaded-document workflow для вставки, извлечения и переупорядочивания страниц

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;

Описание

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 копирует страницы из другого загруженного экземпляра THotPDF в текущий документ. Существующие zero-based array calls остаются поддерживаемыми, а string overload принимает one-based page ranges. InsertAfterPage является zero-based; передайте -1 для вставки в начало

AppendPagesFromDocument добавляет выбранные исходные страницы в конец текущего документа с использованием того же one-based page-range syntax

CopyPageByPhysicalIndex копирует одну исходную страницу по ее нулевому физическому индексу в нулевую целевую позицию

ExtractPagesToFile записывает выбранные страницы текущего документа в новый PDF file. Существующие zero-based array calls остаются поддерживаемыми, а string overload принимает one-based page ranges

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

MovePage переупорядочивает текущий документ, перемещая одну zero-based page на другую zero-based position. Метод обновляет loaded page array и root page tree, чтобы последующие save и extraction calls использовали новый порядок

SaveLoadedDocument записывает загруженный граф объектов в новый файл после правок страниц, форм или операций копирования

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