EndTag

PDF balisé, accessibilité

Description

Ferme l’élément de structure ouvert le plus récemment, écrit EMC dans le flux de contenu de la page et le retire de la pile. Chaque appel à BeginTag, BeginTagEx ou BeginTagEx2 doit correspondre à exactement un EndTag avant l’enregistrement ou l’ajout d’une page

Syntaxe

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Valeurs de retour

0	Échec — aucun document n’est ouvert ou la pile de balises est vide (`EndTag` a été appelé plus de fois que les fonctions `Begin*` correspondantes)
1	L’élément de structure a été fermé

Remarques

Les balises doivent être correctement imbriquées. Chaque EndTag ferme l’élément de structure ouvert le plus interne ; l’ordre de fermeture est strictement l’inverse de l’ordre d’ouverture, comme pour l’imbrication des éléments de bloc ordinaires en HTML ou XML

Si un document est enregistré avec des éléments de structure encore ouverts, GetPDFUADiagnostics indique leur nombre sous STRUCT-UNCLOSED. Ils manquent dans l’arbre enregistré ; les sections de contenu marqué correspondantes n’ont donc aucun parent logique et sont ignorées par les technologies d’assistance

N’utilisez pas EndTag pour fermer une région d’artefact ouverte avec BeginArtifact ; appelez EndArtifact. Les artefacts et éléments de structure résident dans des piles de contenu marqué indépendantes

Exemple

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

Voir aussi

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics