BeginTag

PDF balisé, accessibilité

Description

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

ActiveX

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

DLL

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

Le balisage d’un document le marque comme balisé lors de son enregistrement, condition nécessaire pour qu’un lecteur considère la structure comme présente. Un réglage SetMarkInfo effectué par l’appelant est conservé tel quel