AddTagAttribute

PDF balisé, accessibilité

Description

Ajoute un attribut nommé à l’élément de structure en cours sur la pile de balises. Il est écrit comme dictionnaire d’attributs PDF /A, ou tableau de dictionnaires, lors de l’enregistrement. Appelez cette fonction après BeginTag ou BeginTagEx et avant EndTag

Syntaxe

Delphi

Function TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * Value);

Paramètres

Owner	Nom du propriétaire d’attribut tel que défini dans le tableau 348 d’ISO 32000-1 (par exemple `Layout`, `Table`, `List`, `PrintField`). Il devient la clé `/O` du dictionnaire d’attributs
Name	Nom de l'attribut du propriétaire donné, par exemple `BBox` pour Layout ou `Scope` pour Table. Ne doit pas être vide
Value	La valeur de l'attribut sous forme de chaîne. Un nombre seul est écrit comme nombre PDF et les valeurs ne contenant que des nombres séparés par des espaces (par exemple `"0 0 200 100"`) sont écrites comme tableau PDF de nombres réels. Les nombres utilisent le point comme séparateur décimal sur tous les systèmes ; un nombre écrit avec le séparateur décimal du système est aussi accepté. Toute autre valeur est écrite comme objet de nom PDF sans `/` initial. Ne doit pas être vide

Valeur de retour

Renvoie 1 en cas de réussite. Renvoie 0 si aucun document n'est ouvert, si aucune balise n'est actuellement ouverte, ou si Owner ou Name est vide

Remarques

Plusieurs appels à AddTagAttribute pour une même balise ouverte sont cumulés. Si les attributs appartiennent à un seul propriétaire, la bibliothèque écrit un dictionnaire /A unique. Avec plusieurs propriétaires, ils sont regroupés par propriétaire et écrits sous forme de tableau de dictionnaires

Pour les attributs courants, les enveloppes pratiques SetStructElemScope et SetStructElemBBox peuvent remplacer un appel direct à AddTagAttribute

Les attributs sont réinitialisés lorsqu'une nouvelle balise est ouverte ; ils ne sont pas hérités par les éléments enfants

Exemple

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Voir aussi

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox