BeginTagEx2A

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 BeginTagEx2 et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Ouvre un nouvel élément de structure et l’empile dans la pile de balises, en définissant toutes ses propriétés principales en un seul appel. BeginTagEx2 est un wrapper pratique pour BeginTagEx suivi de SetStructElemTitle, SetStructElemID et SetStructElemExpansion. Une chaîne vide pour Title, ElemID ou Expansion omet le setter correspondant ; les autres paramètres se comportent comme dans BeginTagEx

Utilisez BeginTagEx2 lorsque toutes les propriétés descriptives sont connues à l’ouverture, afin d’éviter plusieurs appels de définition. Si une propriété est déterminée plus tard, par exemple AltText de manière asynchrone, utilisez BeginTag ou BeginTagEx, puis les méthodes individuelles

Syntaxe

Delphi

Function DLBeginTagEx2A(InstanceID: Integer; TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: PAnsiChar): Integer;

DLL

int DLBeginTagEx2A(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang, const char * Title, const char * ElemID, const char * Expansion);

Paramètres

TagType	Nom du type d'élément de structure, par exemple `Figure`, `Table`, `Span`, `P`. Mêmes types que BeginTag
AltText	Texte alternatif écrit dans l'entrée /Alt (ISO 32000-1 §14.9.3) Transmettez une chaîne vide pour l'omettre
ActualText	Texte réel écrit dans l'entrée /ActualText (ISO 32000-1 §14.9.4) Transmettez une chaîne vide pour l'omettre
Lang	Balise de langue BCP 47 écrite dans /Lang (ISO 32000-1 §14.9.2), par exemple `en-US`, `fr`, `zh-Hant-TW`. Transmettez une chaîne vide pour hériter de la langue du document
Title	Libellé lisible écrit dans l'entrée /T (ISO 32000-1 §14.7.2). Affiché dans le panneau de navigation Balises. Transmettez une chaîne vide pour l'omettre
ElemID	Identifiant unique d'élément écrit dans l'entrée /ID (ISO 32000-1 §14.7.4). Doit être unique dans le document s'il est défini. Transmettez une chaîne vide pour l'omettre
Expansion	Développement d'une abréviation ou d'un acronyme écrit dans l'entrée /E (ISO 32000-1 §14.9.5). Transmettez une chaîne vide pour l'omettre

Valeur de retour

Renvoie 1 en cas de succès, 0 si aucun document n’est sélectionné

Remarques

Appelez EndTag une fois pour chaque appel réussi à BeginTagEx2 afin de retirer l’élément de la pile de balises. Les éléments de structure peuvent être imbriqués : appeler BeginTagEx2 pendant qu’un autre élément est ouvert crée un enfant

L’implémentation interne est exactement équivalente à :

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

Les méthodes de définition individuelles restent disponibles pour les propriétés déterminées après l’ouverture de l’élément ou non couvertes par BeginTagEx2, telles que AddTagAttribute pour les attributs de cellule de table

Exemple

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;

Voir aussi

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion