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

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

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

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

OnPageOperationProgress يبلّغ عن التقدم على مستوى الصفحة في عمليات الإلحاق والإدراج والاستخلاص وعمليات الصفحات من نمط الدمج القادمة

MovePageيعيد 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');