SetMarkInfo

Proprietăți document, Accesibilitate

Descriere

Setează dicționarul /MarkInfo al documentului în Catalog. Când Marked este 1, Catalogul primește o intrare /MarkInfo << /Marked true /Suspects false >>, care declară documentul ca PDF etichetat. Când Marked este 0, intrarea /MarkInfo este eliminată

Această funcție este apelată automat de SetPDFUAMode și de SetPDFAMode la nivelele de conformitate a (PDF/A-1a, PDF/A-2a, PDF/A-3a). Apelați-o direct doar când aveți nevoie de starea de PDF etichetat fără configurarea completă PDF/UA-1 sau PDF/A-A

Sintaxă

Delphi

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

ActiveX

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

DLL

int DLSetMarkInfo(int InstanceID, int Marked);

Parametri

Marked	1 pentru a declara documentul etichetat (scrie `/Marked true` și `/Suspects false`); 0 pentru a elimina intrarea `/MarkInfo`

Valori returnate

1	Intrarea `/MarkInfo` a fost actualizată cu succes

Observații

ISO 14289-1 (PDF/UA-1) §7.18.6 cere ca /Suspects să fie prezent și setat pe false când /Marked este true. Biblioteca scrie mereu /Suspects false lângă /Marked true, deci un singur apel SetMarkInfo(1) îndeplinește ambele cerințe

Setarea /Marked true este doar o declarație — nu populează prin ea însăși arborele de structură al documentului. După apelarea SetMarkInfo(1), construiți arborele de structură cu perechi BeginTag/EndTag și marcați conținutul decorativ cu BeginArtifact/EndArtifact. Folosiți GetPDFUADiagnostics pentru a scoate la suprafață golurile comune înainte de salvare

Starea anterioară a /MarkInfo-ului pe un document încărcat poate fi interogată cu IsTaggedPDF

Exemplu

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

Consultați și

IsTaggedPDF, SetPDFUAMode, SetPDFAMode, BeginTag, GetPDFUADiagnostics