SetStructElemLang

Označeni PDF & pristupačnost

Opis

Postavlja unos /Lang na strukturnom elementu koji se trenutačno gradi na stogu oznaka. Jezična oznaka nadjačava jezik na razini dokumenta za ovaj element i sve njegove potomke, što dokumentima s više jezika omogućuje da za svaki odsječak sadržaja deklariraju ispravan prirodni jezik

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 vrijednost

Povratne vrijednosti 1 on success, 0 if no structure element is currently open or no document is selected.

Napomene

Ovu funkciju pozovite odmah nakon BeginTag ili BeginTagEx, dok je ciljni element na vrhu stoga oznaka. Ekvivalentno je prosljeđivanju nepraznog argumenta Lang funkciji BeginTagEx, ali može biti zgodnije kada se jezik određuje odvojeno od vrste elementa

Unos /Lang na razini elementa definiran je u ISO 32000-1 §14.9.2. Odnosi se na strukturni element i, nasljeđivanjem, na sve dječje elemente koji sami ne deklariraju vlastiti /Lang. Čitači zaslona taj unos upotrebljavaju za odabir odgovarajućeg glasa pretvorbe teksta u govor ili jezičnog motora prilikom čitanja dokumenta naglas.

PDF/UA-1 (ISO 14289-1 §7.3) zahtijeva identificiranje cjelokupnog sadržaja na prirodnom jeziku. /Lang na razini dokumenta koji postavljaju SetDocumentLanguage ili SetPDFUAMode pokriva glavni jezik; SetStructElemLang pokriva sekcije čiji se jezik razlikuje od glavnog.

Primjer

// 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đer

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics