SetStructElemHeadersA

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 SetStructElemHeaders et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Définit l’attribut /Headers (propriétaire Table) sur l’élément ouvert. Il associe la cellule actuelle à une ou plusieurs cellules d’en-tête identifiées par leur ID, pour les structures complexes non déductibles de la position. Appelez cette fonction après BeginTag ou BeginTagEx et avant EndTag

Syntaxe

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Paramètres

Headers	Liste séparée par des virgules des ID d’éléments des cellules TH qui servent d’en-têtes de colonne ou de ligne pour la cellule TD ou TH actuelle. Chaque ID doit correspondre à un ElemID affecté auparavant à un TH avec SetStructElemID. Les espaces autour des virgules sont ignorés. Exemple : `TH-ProductName,TH-Price`

Valeur de retour

Renvoie 1 en cas de réussite Renvoie 0 si aucun document n'est ouvert ou si aucune balise n'est actuellement ouverte sur la pile de balises

Remarques

Équivaut à appeler AddTagAttribute avec Owner=Table, Name=Headers et la même liste d’ID comme Value. L’attribut est écrit comme tableau /Headers de chaînes PDF dans le dictionnaire /A de l’élément de structure

L’attribut /Headers est défini dans ISO 32000-1 §14.8.5.7.2 (propriétaire Table). Pour les tables simples dont les en-têtes se trouvent directement au-dessus des données, /Scope défini par SetStructElemScope suffit généralement. Utilisez /Headers pour les tables irrégulières avec cellules étendues ou en-têtes multiniveaux

PDF/UA-1 (ISO 14289-1 §7.10) exige que chaque cellule TD soit explicitement associée à ses en-têtes si cette association ne peut être déduite du seul ordre de lecture

Exemple

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Voir aussi

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode