PDFium Delphi Component Docs

IsTagged ویژگی

کامپوننت: TPdf  ·  واحد: PDFium
اینکه آیا سند یک درخت ساختار برای دسترس‌پذیری تعریف می‌کند

Syntax

property IsTagged: Boolean; // read only

Description

IsTagged وقتی True برمی‌گرداند که کاتالوگ سند به /StructTreeRoot ارجاع دهد — ریشهٔ درخت ساختار منطقی PDF (بخش 14.7 مشخصات PDF 1.7). PDFهای نشان‌دار (Tagged) ترتیب خواندن سند، سطوح عنوان، ساختار جدول، فهرست‌ها، متن جایگزین روی تصاویر و سایر نشانه‌گذاری‌های معنایی را کدگذاری می‌کنند که صفحه‌خوان‌ها، موتورهای جریان‌مجدد و استخراج‌گرهای محتوا به آن‌ها تکیه می‌کنند. انطباق PDF/UA-1 و PDF/A-2a/3a هر دو به PDF نشان‌دار نیاز دارند

ویژگی وقتی False است که Active برابر False باشد، وقتی هیچ درخت ساختاری تعریف نشده، یا وقتی درخت ساختار موجود اما خالی است؛ بسیاری از PDFهای موجود نشان‌دار نیستند — به‌ویژه اسناد اسکن‌شده، خروجی درایورهای چاپ و خروجی‌های ابزارها از پیش از 2010. پشتیبانی Tagged PDF در ابزارهای تألیف در حال بهبود است اما همچنان ناهموار

IsTagged یک بررسی ارزان سربرگ است و برای تصمیم‌های مسیریابی مناسب است: استخراج درخت ساختار را روی فایل‌های بدون نشان رد کنید (صرفاً آرایه‌های خالی برمی‌گرداند)، یا یک هشدار دسترس‌پذیری به اپراتور نشان دهید. درخت تفصیلی از طریق StructureElements در دسترس است که درخت را به آرایه‌ای تخت از رکوردهای TPdfStructureElement با سطح، نمایهٔ والد، نام نوع و نقش تجسد می‌کند

Remarks

Example

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

See Also

StructureElements, Language, FormType