وثائق PDFiumPas

IsTagged الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdf  ·  الوحدة: PDFium
ما إذا كان المستند يصرّح بشجرة بنية لإمكانية الوصول

الصياغة

property IsTagged: Boolean; // read only

الوصف

يعيد IsTagged القيمة True عندما يشير كتالوج المستند إلى /StructTreeRoot — جذر شجرة البنية المنطقية في PDF (PDF 1.7 spec section 14.7). تُشفِّر ملفات PDF المعلّمة ترتيب القراءة في المستند، ومستويات العناوين، وبنية الجداول، والقوائم، والنص البديل على الصور، وترميزًا دلاليًا آخر تعتمد عليه قارئات الشاشة ومحركات إعادة التدفق واستخراج المحتوى. يتطلب توافق PDF/UA-1 و PDF/A-2a/3a كلاهما PDFًا معلّمًا

تكون الخاصية False عندما تكون Active False، أو عندما لا تُصرَّح أي شجرة بنية، أو عندما تكون الشجرة موجودة لكنها فارغة كثير من ملفات PDF في الواقع غير معلّمة — خاصة المستندات الممسوحة، ومخرجات برامج الطباعة، وعمليات التصدير من الأدوات قبل 2010. دعم PDF المعلّم في أدوات التأليف يتحسن لكنه لا يزال غير متسق

IsTagged فحص رأس منخفض التكلفة، ومناسب لقرارات التوجيه: يمكنك تجاوز استخراج شجرة البنية من الملفات غير المعلّمة (فستعيد ببساطة مصفوفات فارغة)، أو إظهار تحذير بإمكانية الوصول للمشغّل. تتوفر الشجرة التفصيلية عبر StructureElements، التي تحوّل الشجرة إلى مصفوفة مسطحة من سجلات TPdfStructureElement مع المستوى وفهرس الأصل واسم النوع والدور

ملاحظات

مثال

if not Pdf1.IsTagged then
  Log.Add('Warning: PDF is not tagged. Screen-reader output will be unreliable.');
if Pdf1.IsTagged and (Pdf1.Language = '') then
  Log.Add('Tagged PDF without /Lang - fails PDF/UA.');

انظر أيضا

StructureElements, Language, FormType