SetStructElemLang

PDF sa oznakama i pristupačnost

Opis

Postavlja /Lang unos na elementu strukture koji se trenutno gradi na steku tagova. Oznaka jezika nadjačava jezik na nivou dokumenta za ovaj element i sve njegove potomke, pa dokumenti mešanih jezika mogu da deklarišu ispravan prirodni jezik za svaki deo sadržaja

Sintaksa

Delphi

Function TPDFlib.SetStructElemLang(Const Lang: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemLang(Lang As String) As Long

DLL

int DLSetStructElemLang(int InstanceID, const wchar_t * Lang);

Parametri

Povratna vrednost

Vraća 1 pri uspehu, 0 ako trenutno nije otvoren nijedan strukturni element ili nije izabran dokument

Napomene

Pozovite ovu funkciju odmah nakon BeginTag ili BeginTagEx, dok je ciljni element na vrhu steka tagova. Ekvivalentno je prosleđivanju nepraznog argumenta Lang funkciji BeginTagEx, ali može biti zgodnije kad se jezik određuje odvojeno od tipa elementa

Unos /Lang na nivou elementa definisan je u ISO 32000-1 §14.9.2. Odnosi se na strukturni element i, nasleđivanjem, na sve potomke koji sami ne deklarišu /Lang. Čitači ekrana koriste ovaj unos da izaberu odgovarajući glas ili jezički motor za sintezu govora pri čitanju dokumenta naglas.

PDF/UA-1 (ISO 14289-1 §7.3) zahteva da sav sadržaj prirodnog jezika bude identifikovan. /Lang na nivou dokumenta, koji postavljaju SetDocumentLanguage ili SetPDFUAMode, pokriva primarni jezik; SetStructElemLang pokriva odeljke čiji se jezik razlikuje od primarnog.

Primer

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Vidi takođe

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics