SetAutoTagMode

PDF balisé

Description

Active le balisage de structure que les appels de tracé ordinaires transportent eux-mêmes

Syntaxe

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Paramètres

Mode	Masque de bits : `1` balise le texte, `2` marque le mobilier de page comme artefact, `4` balise les images comme figures, `8` balise les tables tracées, `15` effectue les quatre opérations et `0` les désactive

Valeurs de retour

Mode	Mode qui était actif avant cet appel
0	Également renvoyé lorsqu'un mode négatif est fourni ; il est refusé et le mode reste inchangé

Remarques

Avec le balisage de texte, le texte devient un paragraphe et celui tracé juste après RegisterHeading devient un titre du niveau indiqué. Avec le marquage du mobilier, les en-têtes et pieds courants sont des artefacts, afin que le lecteur les ignore au lieu d’annoncer la même ligne à chaque page

Lorsque le balisage des figures est activé, une image tracée devient une figure portant la description laissée par RegisterFigure, ou est tracée dans un artefact de mise en page si RegisterDecoration a indiqué qu’elle était dépourvue de sens

Lorsque le balisage des tables est activé, DrawTableRows place la table, ses lignes et ses cellules dans l’arbre de structure. Les lignes désignées par SetTableHeaderRowCount deviennent des cellules d’en-tête

L'activation du mode marque aussi le document comme balisé. Un lecteur considère la structure absente tant que cette marque manque ; un document balisé sans elle semble donc sans structure

Le balisage automatique s’efface dans une balise ouverte avec BeginTag : pendant que l’appelant décrit la structure, rien n’est imbriqué dans son élément. Il ne balise jamais non plus dans un artefact ni n’ouvre d’élément pour un texte vide, que le lecteur annoncerait comme blanc

Le mode appartient à l’instance de bibliothèque, pas à un document

Exemple

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Voir aussi

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount