SetMarkInfo

Vlastnosti dokumentu, Prístupnosť

Opis

Nastaví slovník /MarkInfo dokumentu v katalógu. Keď je Marked 1, katalóg získa položku /MarkInfo << /Marked true /Suspects false >>, ktorá deklaruje dokument ako tagovaný PDF. Keď je Marked 0, položka /MarkInfo sa odstráni.

Túto funkciu automaticky volajú SetPDFUAMode a SetPDFAMode na úrovniach zhody a (PDF/A-1a, PDF/A-2a, PDF/A-3a). Priamo ju volajte len vtedy, keď potrebujete stav tagovaného PDF bez úplného nastavenia PDF/UA-1 či PDF/A-A.

Syntax

Delphi

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

ActiveX

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

DLL

int DLSetMarkInfo(int InstanceID, int Marked);

Parametre

Marked	1 na deklarovanie dokumentu ako tagovaného (zapisuje `/Marked true` a `/Suspects false`); 0 na odstránenie položky `/MarkInfo`.

Návratové hodnoty

1	Položka `/MarkInfo` sa úspešne aktualizovala.

Poznámky

ISO 14289-1 (PDF/UA-1) §7.18.6 vyžaduje, aby /Suspects existovalo a bolo nastavené na false, keď /Marked je true. Knižnica vždy zapisuje /Suspects false spolu s /Marked true, takže jediné volanie SetMarkInfo(1) pokrýva oba predpisy.

Nastavenie /Marked true je len deklarácia — samo o sebe neplní strom štruktúry dokumentu. Po zavolaní SetMarkInfo(1) strom štruktúry budujte pármi BeginTag/EndTag a dekoratívny obsah označujte BeginArtifact/EndArtifact. Na odhalenie bežných medzier pred uložením použite GetPDFUADiagnostics.

Predchádzajúci stav /MarkInfo na načítanom dokumente možno zistiť cez IsTaggedPDF.

Príklad

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

Pozri tiež

IsTaggedPDF, SetPDFUAMode, SetPDFAMode, BeginTag, GetPDFUADiagnostics