SetStructElemLang

Tagged PDF & Accessibility

Popis

Nastaví položku /Lang na strukturálním prvku, který se právě sestavuje na vrcholu zásobníku tagů. Jazykový tag přebíjí jazyk na úrovni dokumentu pro tento prvek i všechny jeho potomky, takže vícejazyčné dokumenty mohou deklarovat správný přirozený jazyk pro každý úsek obsahu

Syntaxe

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

Parametry

Návratová hodnota

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

Poznámky

Tuto funkci zavolejte ihned po BeginTag nebo BeginTagEx, dokud je cílový prvek na vrcholu zásobníku tagů. Odpovídá to předání neprázdného argumentu Lang funkci BeginTagEx, ale může být pohodlnější, když se jazyk určuje odděleně od typu prvku

Položka /Lang na úrovni prvku je definována v ISO 32000-1 §14.9.2. Vztahuje se na prvek struktury a děděním na všechny podřízené prvky, které samy položku /Lang nedefinují. Čtečky obrazovky tuto položku používají k výběru vhodného hlasu text-to-speech nebo jazykového modulu při hlasitém čtení dokumentu

PDF/UA-1 (ISO 14289-1 §7.3) requires that all natural language content be identified. The document-level /Lang set by SetDocumentLanguage or SetPDFUAMode covers the primary language; SetStructElemLang covers sections whose language differs from the primary.

Příklad

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

Viz také

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics