SetStructElemScopeA

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

Définit l’attribut /Scope (propriétaire Table) sur l’élément ouvert. Il indique si une cellule TH s’applique à une colonne, une ligne ou les deux, comme l’exige PDF/UA-1. Équivaut à AddTagAttribute avec Owner=Table, Name=Scope et le nom de portée comme valeur

Syntaxe

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Paramètres

Scope	Portée de la cellule d’en-tête. Elle doit prendre l’une des valeurs suivantes, sensibles à la casse : Column — l’en-tête s’applique à toutes les cellules de la colonne Row — l’en-tête s’applique à toutes les cellules de la ligne Both — l’en-tête s’applique à la colonne et à la ligne

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

Appelez cette fonction après BeginTag (avec le type de balise TH) et avant EndTag. L’attribut /Scope est défini dans ISO 32000-1 §14.8.5.7.2 (propriétaire d’attribut Table)

PDF/UA-1 (ISO 14289-1 §7.10) exige que les cellules d’en-tête d’une table soient clairement associées à leurs cellules de données. L’attribut /Scope constitue le mécanisme recommandé lorsque la disposition de la table le permet

Exemple

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Voir aussi

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode