IsTaggedPDF

Document properties, Accessibility

Popis

Tests whether the selected document declares itself as a tagged PDF by checking the Catalog's /MarkInfo /Marked entry. A return value of 1 means the entry is present and set to true; any other state — entry absent, /Marked false, or no /MarkInfo dictionary — returns 0.

Syntaxe

Delphi

Function TPDFlib.IsTaggedPDF: Integer;

ActiveX

Function PDFlib::IsTaggedPDF() As Long

DLL

int DLIsTaggedPDF(int InstanceID);

Return values

0	Dokument se nedeklaruje jako tagované PDF (nebo není otevřený žádný dokument)
1	Dokument se deklaruje jako tagované PDF (`/MarkInfo /Marked true`)

Poznámky

Jde pouze o kontrolu metadat — kontroluje deklaraci katalogu, nikoli skutečný strom struktury. Dokument může obsahovat /Marked true, aniž by měl použitelný strom struktury (například po částečné úpravě), a strom struktury může technicky existovat i bez /Marked true. Tuto funkci použijte jako rychlý signál metadat; pro hlubší posouzení shody dokumentu v paměti volejte GetPDFUADiagnostics, která kontroluje strom struktury, značky stránek a požadované atributy

Příznak se automaticky nastaví funkcí SetPDFUAMode, funkcí SetPDFAMode s režimem úrovně a (1, 4, 6) a explicitním voláním SetMarkInfo(1)

Příklad

// Branch on whether the loaded document already declares tagged PDF
PDF.LoadFromFile('input.pdf', '');
if PDF.IsTaggedPDF = 1 then
  WriteLn('input.pdf is a tagged PDF — content can be re-flowed')
else
begin
  WriteLn('input.pdf is not tagged — adding tag declarations');
  PDF.SetMarkInfo(1);  // mark, then construct a structure tree
end;

Viz také

SetMarkInfo, SetPDFUAMode, SetPDFAMode, GetPDFUADiagnostics, BeginTag