BeginTagEx

Označeni PDF, Pristupačnost

Opis

Na trenutačnoj stranici otvara strukturni element označenog PDF-a s izričitim atributom prirodnog jezika. Identično BeginTag, ali dodaje parametar Lang koji se zapisuje u atribut /Lang strukturnog elementa

Ovu funkciju upotrijebite za sadržaj čiji se jezik razlikuje od zadanog jezika dokumenta (kojeg postavljaju SetPDFUAMode ili SetDocumentLanguage). ISO 14289-1 §7.2 zahtijeva da atribut /Lang bude postavljen na svakom segmentu teksta koji nije na glavnom jeziku dokumenta.

Oznake moraju biti uravnotežene: svakom pozivu BeginTagEx mora slijediti odgovarajući poziv EndTag. Oznake se mogu ugnježđivati

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 (atribut `/Alt`). Ako nije potreban, proslijedite prazan znakovni niz.
ActualText	Zamjenski tekst za sadržaj čiji se vizualni oblik razlikuje od logičkog značenja (atribut `/ActualText`). Ako nije potreban, proslijedite prazan znakovni niz.
Lang	BCP 47 jezična oznaka za sadržaj ovog elementa, npr. `en-US`, `fr-FR`, `zh-Hans`. Za nasljeđivanje jezika dokumenta proslijedite prazan niz znakova. Kada nije prazan, nadjačava jezik na razini dokumenta za ovaj element i sve njegove potomke

Povratne vrijednosti

0	Neuspjeh (nije otvoren nijedan dokument)
1	Tag opened successfully

Primjer

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