SetStructElemRowSpan

PDF balisé, accessibilité

Description

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

Syntaxe

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Paramètres

RowSpan	Nombre de lignes occupées par la cellule actuelle. Il doit s’agir d’un entier positif. La valeur 1 signifie que la cellule occupe exactement une ligne, comportement par défaut si RowSpan n’est pas défini. Une valeur supérieure à 1 indique une cellule sur plusieurs lignes

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 /RowSpan est défini dans ISO 32000-1 §14.8.5.7.2 (propriétaire d’attribut Table, tableau 337)

Les cellules étendues sur plusieurs lignes apparaissent lorsqu’un en-tête ou une cellule de données doit s’étendre verticalement, par exemple un en-tête commun à plusieurs lignes. L’attribut /RowSpan permet aux technologies d’assistance de construire correctement le modèle logique de grille de la table

Lorsqu'une cellule couvre également plusieurs colonnes, utilisez SetStructElemColSpan avec cette fonction

Exemple

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

Voir aussi

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag