PDFium Delphi Component Docs

GeneratePagedLayout طريقة

المكوِّن: TPdf  ·  الوحدات: PDFium, FPdfLayout

الصياغة

function GeneratePagedLayout(Layout: TPdfLayoutDocument; PagedPlan: TPdfLayoutPagedPlan; out Plan: TPdfLayoutPlan; AllowSignedDocument: Boolean = False): Boolean;

الوصف

يقيس التخطيط ويفصل صفحاته بينما يسلسل كل أمر في التخزين القابل للبحث الذي يملكه PagedPlan أو يشير إليه

بعد القياس، يجسد مصفوفة أوامر صفحة واحدة في كل مرة، ويُصدر تلك الصفحة عبر واجهات كائنات صفحات PDFium الأصلية نفسها التي تستخدمها GenerateLayout، ثم يفرغها ويحرر المصفوفة المحلية ويكمل بالصفحة التالية

التخزين والذاكرة المؤقتة

استخدم TFileStream أو TMemoryStream أو TPdfRandomAccessStore مخصصًا؛ ويجب أن يدعم التيار البحث والقراءة والكتابة وتغيير الحجم والاستخدام الحصري طوال عمر الخطة المفصلة صفحات

ترفض MaxCommandCount و MaxStorageBytes و MaxPageCommands و MaxSourceCount الخطط المفرطة، بينما يحد MaxCachedPages ذاكرة LRU الداخلية ويجوز أن يكون صفرًا

تكشف CommandCount و StorageByteCount وعدادات الذاكرة وأقصى إشغال عن سلوك قابل للقياس

الناتج

Plan.Commands فارغ عمدًا؛ وتبقى إعدادات الصفحات وعددها والعناصر الدلالية وعدّادات المحتوى والقياسات وإجماليات مراجع الصفحات المستقرة متاحة

يستطيع PagedPlan.MaterializePage استعادة صفحة كاملة لاحقًا، بما يشمل المتن مع قطعي الترويسة والتذييل المكتوبين منفصلين

القيود والسلامة

تولّد هذه الطريقة تخطيطًا بلا وسوم؛ استخدم GenerateTaggedLayout حين تُطلب خطة أوامر كاملة في الذاكرة ومعالجة لاحقة لشجرة الهيكل

يحتفظ PDFium بالمستند المؤلَّف وصفحاته الأصلية حتى الحفظ أو الإغلاق، لذا تحد هذه الواجهة من تجسيد الأوامر عالية المستوى بدلًا من ذاكرة مستند PDFium

يجب أن يبقى أي PDF مصدر مُشار إليه أو TPdfLayoutCachedNode موجودًا بعد التوليد وعبر التجسيد اللاحق، وتتطلب الوجهات الموقعة تفويضًا صريحًا

يعيد فشل القياس أو الإصدار ضبط تخزين الأوامر غير المكتمل وتراجع عن كل صفحة ألحقها الاستدعاء

انظر أيضًا

GenerateLayout, GenerateTaggedLayout, FPdfLayout, تخزين عمل ذو وصول عشوائي