SetStructElemLang

Tagged PDF & Accessibility

Beschrijving

Zet de /Lang-entry op het structuurelement dat momenteel op de tagstack wordt opgebouwd. De taaltag overschrijft de taal op documentniveau voor dit element en alle afstammelingen, zodat documenten in gemengde talen per inhoudsdeel de juiste natuurlijke taal kunnen aangeven

Syntaxis

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

Parameters

Lang	Een BCP 47-taaltagstring, zoals `en-US`, `fr`, `de-CH` of `zh-Hant-TW`. Geef een lege string door om een eerder gezette waarde te wissen en de taal op documentniveau te erven

Retourwaarde

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

Remarks

Roep deze functie direct na BeginTag of BeginTagEx aan, terwijl het doelelement bovenaan de tagstack staat. Het is gelijk aan het doorgeven van een niet-lege Lang-argument aan BeginTagEx, maar kan handiger zijn wanneer de taal los van het elementtype wordt bepaald

De /Lang-vermelding op elementniveau is gedefinieerd in ISO 32000-1 §14.9.2. Deze geldt voor het structuurelement en, via overerving, voor alle kindelementen die zelf geen /Lang declareren. Schermlezers gebruiken deze vermelding om bij het voorlezen de juiste tekst-naar-spraakstem of taalengine te selecteren

PDF/UA-1 (ISO 14289-1 §7.3) eist dat alle inhoud in natuurlijke taal wordt geïdentificeerd. De /Lang op documentniveau, gezet via SetDocumentLanguage of SetPDFUAMode, dekt de primaire taal; SetStructElemLang dekt secties waarvan de taal daarvan afwijkt

Voorbeeld

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

Zie ook

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics