PDFium Delphi Component Docs

الطريقة GenerateTaggedLayout

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

الصياغة

function GenerateTaggedLayout(Layout: TPdfLayoutDocument; out Plan: TPdfLayoutPlan; const Language: string = 'en-US'): Boolean;

الوصف

تقيس وتصدر مستند تخطيط جديدًا، وتعيِّن MCIDs مستمرة لكائنات الصفحة الدلالية، وتعلِّم المحتوى الزخرفي كـ Artifact، وتبني التسلسل الهرمي للبنية، وتعيد تحميل Tagged PDF المكتمل في TPdf نفسه

يجب أن تكون الوجهة غير نشطة أو تحتوي صفر صفحات بحيث يغطي الخطة الدلالية المولدة كل كائن غير زخرفي

تحمل الطريقة PDFium قبل فحص قدرات marked-content؛ يمكن أن تكون أول عملية أصلية في TPdf جديدة دون CreateDocument مسبق

النموذج الدلالي

يكون AddText افتراضيًا plsrParagraph بينما تكون الترويسات والتذييلات والأسطر الفاصلة والصور و XObjects الصفحات والعقد المخزنة مؤقتًا افتراضيًا plsrArtifact

استدعِ SetLastItemSemantics لتعيين العناوين، والأقسام، والأجزاء، والأشكال، والتسميات، وأدوار القوائم، وأدوار الجداول، والنص البديل، والنص الفعلي، واللغة، والمعرفات، ونطاق الجدول، والمقاطع، أو معرفات الترويسات

استخدم AddSemanticNode لحاويات القوائم والجداول غير المرئية، ثم اربط النسل عبر ElementID و ParentID

الروابط الموسومة

يضيف AddLink نص URI مقيسًا وتعليق Link

يُحوَّل التعليق المولَّد إلى كائن غير مباشر عند الضرورة، ويتلقى مفتاح StructParent، ويُرتبط بعنصر بنية Link الخاص به عبر مدخلات OBJR و ParentTree

التحقق

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

يرفض التوليد الإخراج المُعمَّى، وشجرة بنية موجودة، وعدم تطابق عددي الصفحات أو الكائنات، و MCIDs المكررة، وتعيينات التعليقات غير المكتملة، وتجاوزات ميزانيات الكائنات المهيأة

النتيجة

يحتوي Plan عناصر دلالية، وفهارس أبوين، و MCIDs، وفهارس تعليقات الروابط، وعددي المحتوى الموسوم والزخرفي، إضافة إلى مقاييس التخطيط العادية

يحمل المستند المكتمل عنصر بنية Document، و ParentTree، و IDTree عند وجود المعرفات، و MarkInfo، ولغة المستند، و StructParents للصفحات، وترتيب تبويب قائم على البنية للصفحات ذات التعليقات

جداول متقدمة

تحفظ TPdfLayoutTableCell.AddTextRun الأنماط المختلطة كنص أصلي قابل للاستخراج؛ تنتج SetImage ‏Figure ببديل نصي تحت الخلية الأصلية

مع AllowRowSpanContinuation=True يغطي TH أو TD جميع أجزاء صفحاته بإدخالات MCR لكل صفحة مع حفظ RowSpan و ColumnSpan وعلاقات الرؤوس

تبقى المجاميع صفوف جسم وتُعلّم التسميات Artifact؛ راجع FPdfLayout للقيود والميزانيات

انظر أيضًا

GenerateLayout, ValidatePdfUa, ReadableContent