SetStructElemLangA

Getagde PDF en toegankelijkheid

Beschrijving

Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan SetStructElemLang en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

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

DLL

int DLSetStructElemLangA(int InstanceID, const char * Lang);

Parameters

Retourwaarde

Geeft bij succes 1 terug, of 0 als er momenteel geen structure-element open is of geen document is geselecteerd

Opmerkingen

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