BeginTagA
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 à BeginTag 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é. Écrit un opérateur BDC (Begin Marked Content with Dictionary) dans le flux de contenu et enregistre l’élément dans l’arbre logique du document. L’arbre est finalisé automatiquement lors de l’enregistrement
Les balises doivent être équilibrées : chaque appel BeginTag doit être suivi d'un appel correspondant à EndTag. Elles peuvent être imbriquées
Syntaxe
Delphi
Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;DLL
int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);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, associé à l'attribut PDF /Alt. Transmettez une chaîne vide s'il n'est pas requis |
| ActualText | Texte de remplacement d'un contenu dont la représentation visuelle diffère du sens logique, associé à l'attribut PDF /ActualText. Transmettez une chaîne vide s'il n'est pas requis |
Valeurs de retour
| 0 | Échec (aucun document n’est ouvert) |
|---|---|
| 1 | Balise ouverte correctement |
Exemple
// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;
// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;Remarques
Utilisez BeginArtifact/EndArtifact pour le contenu décoratif (en-têtes et pieds de page, éléments d’arrière-plan) qui ne doit pas être lu par les lecteurs d’écran
Le document doit être en mode écriture, créé ou ouvert pour modification. Appelez SetPDFUAMode avant le balisage pour satisfaire PDF/UA-1