BeginTagEx

PDF balisé, accessibilité

Description

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 TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * 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;