SetStructElemLangA

Tagged PDF & Accessibility

Popis

Koncové A označuje vstupní bod ANSI (char) knihovny DLL; rozhraní ActiveX/COM zpřístupňuje pouze formu Unicode. Chování je shodné s SetStructElemLang a řetězcové argumenty jsou interpretovány pomocí aktuální znakové stránky nastavené funkcí SetAnsiMode

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 DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * 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