SetStructElemExpansionA

PDF balisé & accessibilité

Description

Le A final indique le point d’entrée ANSI (char) de la DLL ; la surface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à celui de SetStructElemExpansion et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Définit l’entrée /E (texte développé) de l’élément de structure en cours. Il s’agit de la forme complète d’une abréviation ou d’un acronyme, par exemple World Wide Web pour un Span contenant WWW, ou International Organization for Standardization pour un Span contenant ISO

Les lecteurs d’écran et autres technologies d’assistance prononcent le texte développé au lieu de tenter de prononcer les caractères abrégés, ce qui est essentiel pour les abréviations impossibles à énoncer comme des mots

Syntaxe

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Paramètres

Expansion	Texte entièrement développé de l'abréviation ou de l'acronyme dans l'élément de structure actuel. Transmettez une chaîne vide pour effacer une valeur précédemment définie

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, pendant que l’élément cible se trouve au sommet de la pile de balises, ou à tout moment avant l’appel EndTag correspondant

L'entrée /E est définie dans ISO 32000-1 §14.9.5. Elle est écrite comme chaîne de texte PDF dans le dictionnaire de structure et se distingue des autres propriétés textuelles :

/E (Expansion) — Forme développée d'une abréviation ou d'un acronyme, utilisée par les lecteurs d'écran pour prononcer le contenu incorporé abrégé
/Alt (voir SetStructElemAltText) — Description de remplacement complète des éléments impossibles à rendre visuellement, images, figures et formules
/ActualText (voir SetStructElemActualText) — Remplacement Unicode exact des séquences de glyphes dont le texte extrait serait autrement incorrect (ligatures, variantes de glyphes)

PDF/UA-1 (ISO 14289-1 §7.2) exige que la langue naturelle de chaque fragment de texte puisse être déterminée sans ambiguïté. Pour les abréviations et acronymes dont la forme abrégée ne peut pas être prononcée comme un mot, /E est le mécanisme standard permettant de fournir cette information

Appliquez /E à l'élément le plus interne enveloppant l'abréviation, généralement Span. Le développement ne concerne que son contenu et n'est pas hérité par les enfants

Exemple

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Voir aussi

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics