SetMarkInfo

خصائص المستند، إمكانية الوصول

الوصف

يضبط قاموس /MarkInfo للمستند في الكتالوج. وعندما تكون Marked تساوي 1 يكتسب الكتالوج مدخل /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);

المعاملات

Marked1 عند النجاح، و0 عندما لم يُحمَّل المستند من ملف أو لم توجد المراجعة

قيم الإرجاع

1حُدثت مدخلة /MarkInfo بنجاح

ملاحظات

يتطلب ISO 14289-1‏ (PDF/UA-1) §7.18.6 وجود /Suspects مضبوطًا على false عندما تكون /Marked تساوي true. وتكتب المكتبة دائمًا /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