SetStructElemLang

Címkézett PDF & akadálymentesség

Leírás

Beállítja a címkeveremben jelenleg létrehozás alatt álló struktúraelem /Lang bejegyzését. A nyelvcímke felülírja a dokumentumszintű nyelvet ennél az elemnél és minden leszármazottjánál, lehetővé téve, hogy a többnyelvű dokumentumok a tartalom minden tartományához a helyes természetes nyelvet deklarálják

Szintaxis

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

Paraméterek

Visszatérési érték

Siker esetén 1-et ad vissza, 0-t, ha jelenleg nincs nyitott struktúraelem vagy nincs kiválasztott dokumentum

Megjegyzések

Ezt a függvényt közvetlenül a BeginTag vagy BeginTagEx után hívja, miközben a célelem a tag stack tetején van. Ez egyenértékű nem üres Lang argumentum átadásával a BeginTagEx számára, de kényelmesebb lehet, ha a nyelv az elemtípustól külön kerül meghatározásra

Az elemszintű /Lang bejegyzést az ISO 32000-1 §14.9.2 határozza meg. A struktúraelemre, valamint öröklés útján minden olyan gyermekelemre vonatkozik, amely maga nem deklarál /Lang bejegyzést. A képernyőolvasók ezt a bejegyzést használják a megfelelő szövegfelolvasó hang vagy nyelvi motor kiválasztásához a dokumentum hangos felolvasásakor

A PDF/UA-1 (ISO 14289-1 §7.3) megköveteli, hogy minden természetes nyelvi tartalom azonosítva legyen. A SetDocumentLanguage vagy SetPDFUAMode által beállított dokumentumszintű /Lang az elsődleges nyelvre vonatkozik; a SetStructElemLang az elsődlegestől eltérő nyelvű szakaszokat fedi le

Példa

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

Lásd még

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics