THotPDF Page Operation Methods

THotPDF

توفر هذه الطرق مسار عمل للمستندات المحملة لإدراج الصفحات واستخراجها وإعادة ترتيبها

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 محمل آخر إلى المستند الحالي. تبقى استدعاءات المصفوفات ذات الأساس الصفري مدعومة، ويقبل string overload نطاقات صفحات ذات أساس واحد. InsertAfterPage ذو أساس صفري؛ مرر -1 للإدراج في البداية

يلحق AppendPagesFromDocument الصفحات المصدر المحددة في نهاية المستند الحالي باستخدام صيغة نطاق الصفحات ذات الأساس الواحد نفسها

CopyPageByPhysicalIndex ينسخ صفحة مصدر واحدة حسب فهرسها الفيزيائي الصفري إلى موضع وجهة صفري

يكتب ExtractPagesToFile الصفحات المحددة من المستند الحالي في ملف PDF جديد. تبقى استدعاءات المصفوفات ذات الأساس الصفري مدعومة، ويقبل string overload نطاقات صفحات ذات أساس واحد

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

يعيد MovePage ترتيب المستند الحالي بنقل صفحة ذات أساس صفري إلى موضع آخر ذي أساس صفري. يحدّث الأسلوب مصفوفة الصفحات المحملة وشجرة الصفحات الجذرية حتى تستخدم عمليات الحفظ والاستخراج اللاحقة الترتيب الجديد

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