AddTagAttributeA
PDF balisé, accessibilité
Description
Le A final indique le point d’entrée ANSI (char) de la DLL ; la surface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à celui de AddTagAttribute et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle
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 DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;DLL
int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * 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 | Valeur de l’attribut sous forme de chaîne. 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. Toute autre valeur devient un 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