BeginTagExA

PDF balisé, accessibilité

Description

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

Ouvre sur la page actuelle un élément de structure PDF balisé avec un attribut explicite de langue naturelle. Identique à BeginTag, mais ajoute un paramètre Lang écrit dans l’attribut /Lang de l’élément de structure

Utilisez cette fonction pour un contenu dont la langue diffère de la langue par défaut du document, définie par SetPDFUAMode ou SetDocumentLanguage. ISO 14289-1 §7.2 exige l’attribut /Lang sur tout segment de texte qui n’est pas dans la langue principale du document

Les balises doivent être équilibrées : chaque appel BeginTagEx doit être suivi d'un appel correspondant à EndTag. Elles peuvent être imbriquées

Syntaxe

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

Paramètres

TagType	Type de structure PDF standard : `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (voir ISO 32000-1 §14.8.4)
AltText	Texte de remplacement pour les images et autres contenus non textuels, attribut `/Alt`. Transmettez une chaîne vide s'il n'est pas requis
ActualText	Texte de remplacement pour un contenu dont la forme visuelle diffère du sens logique, attribut `/ActualText`. Transmettez une chaîne vide s'il n'est pas requis
Lang	Étiquette de langue BCP 47 du contenu de cet élément, par exemple `en-US`, `fr-FR`, `zh-Hans`. Transmettez une chaîne vide pour hériter de la langue du document. Une valeur non vide remplace la langue du document pour cet élément et tous ses descendants

Valeurs de retour

0	Échec (aucun document n’est ouvert)
1	Balise ouverte correctement

Exemple

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;