SetStructElemLang

PDF balisé & accessibilité

Description

Définit l’entrée /Lang de l’élément de structure en cours de construction sur la pile de balises. L’étiquette de langue remplace celle du document pour cet élément et tous ses descendants, permettant aux documents multilingues de déclarer la langue naturelle correcte de chaque portion de contenu

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

Paramètres

Lang	Chaîne d’étiquette de langue BCP 47, telle que `en-US`, `fr`, `de-CH` ou `zh-Hant-TW`. Transmettez une chaîne vide pour effacer une valeur précédemment définie et hériter de la langue du document

Valeur de retour

Renvoie 1 en cas de réussite, 0 si aucun élément de structure n'est actuellement ouvert ou si aucun document n'est sélectionné

Remarques

Appelez cette fonction immédiatement après BeginTag ou BeginTagEx, pendant que l’élément cible est au sommet de la pile. Elle équivaut à un argument Lang non vide pour BeginTagEx, mais convient mieux lorsque la langue est déterminée séparément du type

L’entrée /Lang au niveau de l’élément est définie dans ISO 32000-1 §14.9.2. Elle s’applique à l’élément de structure et, par héritage, à tous les enfants qui ne déclarent pas leur propre /Lang. Les lecteurs d’écran l’utilisent pour choisir la voix de synthèse ou le moteur de langue approprié

PDF/UA-1 (ISO 14289-1 §7.3) exige l’identification de tout contenu en langue naturelle. Le /Lang du document défini par SetDocumentLanguage ou SetPDFUAMode couvre la langue principale ; SetStructElemLang couvre les sections dans une autre langue

Exemple

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

Voir aussi

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics