SetMarkInfo

ویژگی‌های سند، دسترس‌پذیری

توضیحات

واژه‌نامهٔ /MarkInfo سند را در Catalog تنظیم می‌کند. وقتی Marked برابر 1 باشد، Catalog ورودی /MarkInfo << /Marked true /Suspects false >> را می‌گیرد و سند را PDF برچسب‌گذاری‌شده اعلام می‌کند. وقتی Marked برابر 0 باشد، ورودی /MarkInfo حذف می‌شود

این تابع به‌طور خودکار توسط SetPDFUAMode و توسط SetPDFAMode در سطوح انطباق a (PDF/A-1a، PDF/A-2a، PDF/A-3a) فراخوانی می‌شود. فقط وقتی مستقیماً صدا بزنید که وضعیت برچسب‌دار PDF را بدون راه‌اندازی کامل PDF/UA-1 یا PDF/A-A لازم دارید

نحو

Delphi

Function TPDFlib.SetMarkInfo(Marked: Integer): Integer;

ActiveX

Function PDFlib::SetMarkInfo(Marked As Long) As Long

DLL

int DLSetMarkInfo(int InstanceID, int Marked);

پارامترها

Marked	1 برای اعلام برچسب‌دار بودن سند (نوشتن `/Marked true` و `/Suspects false`)؛ 0 برای حذف مدخل `/MarkInfo`

مقادیر بازگشتی

1	مدخل `/MarkInfo` با موفقیت به‌روزرسانی شد

ملاحظات

ISO 14289-1 (PDF/UA-1) §7.18.6 می‌خواهد /Suspects حاضر باشد و وقتی /Marked مقدار true دارد روی false تنظیم شود. کتابخانه همیشه /Suspects false را کنار /Marked true می‌نویسد، پس یک فراخوان SetMarkInfo(1) هر دو نیاز را برآورده می‌کند

تنظیم /Marked true فقط یک اعلامیه است — به‌تنهایی درخت ساختار سند را پر نمی‌کند. بعد از فراخوانی SetMarkInfo(1)، درخت ساختار را با زوج‌های BeginTag/EndTag بسازید و محتوای تزئینی را با BeginArtifact/EndArtifact نشان‌گذاری کنید. برای آشکار شدن شکاف‌های رایج پیش از ذخیره از GetPDFUADiagnostics استفاده کنید

وضعیت قبلی /MarkInfo روی سند بارگذاری‌شده را می‌توان با IsTaggedPDF پرس‌وجو کرد

مثال

// Convert a non-tagged loaded document into a tagged one, then add structure
PDF.LoadFromFile('source.pdf', '');
if PDF.IsTaggedPDF = 0 then
begin
  PDF.SetMarkInfo(1);

  // Re-open page 1 for editing
  PDF.SelectPage(1);
  PDF.BeginPageUpdate;
  PDF.BeginTag('H1', '', '');
  PDF.PrintText(50, 750, 'Document Title');
  PDF.EndTag;
  PDF.EndPageUpdate;
end;
PDF.SaveToFile('tagged.pdf');

همچنین ببینید

IsTaggedPDF, SetPDFUAMode, SetPDFAMode, BeginTag, GetPDFUADiagnostics