BeginTag

Tagged PDF, Pristupačnost

Opis

Otvara element strukture tagged PDF-a na trenutnoj stranici. U content stream upisuje operator BDC (Begin Marked Content with Dictionary) i registruje element u stablu logičke strukture dokumenta. Stablo strukture automatski se zaokružuje pri čuvanju dokumenta

Tagovi moraju biti upareni: svaki poziv BeginTag mora pratiti odgovarajući poziv EndTag. Tagovi mogu da se ugneždavaju

Sintaksa

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

Parametri

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Alternativni tekst za slike i drugi netekstualni sadržaj (mapira se na PDF `/Alt` atribut). Prosledite prazan string ako nije potreban
ActualText	Zamenski tekst za sadržaj čija se vizuelna reprezentacija razlikuje od logičkog značenja (mapira se na PDF `/ActualText` atribut). Prosledite prazan string ako nije potreban

Povratne vrednosti

0	Neuspeh (nijedan dokument nije otvoren)
1	Tag uspešno otvoren

Primer

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Napomene

Koristite BeginArtifact/EndArtifact za dekorativni sadržaj (zaglavlja i podnožja stranica, elemente pozadine) koji čitači ekrana ne treba da čitaju

Dokument mora biti u režimu upisa (napravljen ili otvoren za izmenu). Pozovite SetPDFUAMode pre tagovanja da ispunite zahteve PDF/UA-1

Označavanje dokumenta označava ga kao tagged pri čuvanju, čemu čitač treba pre nego što uopšte tretira strukturu kao prisutnu. Podešavanje SetMarkInfo koje je učinio pozivalac ostaje kakvo jeste