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

Параметри

Marked	1 — заявити документ розміченим (записує `/Marked true` і `/Suspects false`); 0 — вилучити запис `/MarkInfo`

Повернуті значення

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