SetStructElemColSpan

PDF balisé, accessibilité

Description

Définit l’attribut /ColSpan (propriétaire Table) sur l’élément ouvert. La valeur indique le nombre de colonnes couvertes par la cellule. Équivaut à appeler AddTagAttribute avec Owner=Table, Name=ColSpan et la valeur entière comme chaîne

Syntaxe

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Paramètres

ColSpan	Nombre de colonnes occupées par la cellule actuelle. Il doit s’agir d’un entier positif. La valeur 1 signifie que la cellule occupe exactement une colonne, comportement par défaut si ColSpan n’est pas défini. Une valeur supérieure à 1 indique une cellule d’en-tête ou de données couvrant plusieurs colonnes

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 TH ou TD) et avant EndTag. L’attribut /ColSpan est défini dans ISO 32000-1 §14.8.5.7.2 (propriétaire d’attribut Table, tableau 337)

Les cellules étendues sont courantes dans les tables complexes, par exemple un en-tête couvrant deux colonnes de données. L’attribut /ColSpan permet aux technologies d’assistance de calculer correctement la position des cellules et d’associer les en-têtes aux données dans toute la grille

Lorsqu'une cellule couvre également plusieurs lignes, utilisez SetStructElemRowSpan avec cette fonction

Exemple

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Voir aussi

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag