BeginTagEx

Tagged PDF, Pristupačnost

Opis

Otvara element strukture tagged PDF-a na trenutnoj stranici, sa eksplicitnim atributom prirodnog jezika. Istovetan funkciji BeginTag, ali dodaje parametar Lang koji se upisuje u /Lang atribut elementa strukture

Koristite ovu funkciju za sadržaj čiji se jezik razlikuje od podrazumevanog jezika dokumenta (postavljenog pomoću SetPDFUAMode ili SetDocumentLanguage). ISO 14289-1 §7.2 zahteva da atribut /Lang bude postavljen na svaki segment teksta koji nije na primarnom jeziku dokumenta.

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

Sintaksa

Delphi

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

ActiveX

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

DLL

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

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 (/Alt atribut). Prosledite prazan string ako nije potreban
ActualText	Zamenski tekst za sadržaj čija se vizuelna forma razlikuje od logičkog značenja (/ActualText atribut). Prosledite prazan string ako nije potreban
Lang	BCP 47 jezički tag za sadržaj ovog elementa, npr. `en-US`, `fr-FR`, `zh-Hans`. Prosledite prazan string da se jezik dokumenta nasledi. Kad nije prazan, pregazuje jezik na nivou dokumenta za ovaj element i sve njegove potomke

Povratne vrednosti

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

Primer

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;