SetTableHeaderRowCount

Tableaux

Description

Indique le nombre de premières lignes d’un tableau qui constituent des en-têtes

Syntaxe

Delphi

Function TPDFlib.SetTableHeaderRowCount(TableID, HeaderRowCount: Integer): Integer;

Paramètres

TableID	Tableau tel que renvoyé par CreateTable
HeaderRowCount	Nombre de lignes d’en-tête à partir du haut `0` signifie aucune

Valeurs de retour

1	Le décompte a été effectué
0	Le tableau était inconnu, ou le nombre était négatif ou dépassait la dernière ligne ; rien n'a été modifié

Remarques

Les lignes d'en-tête sont écrites comme cellules d'en-tête à portée de colonne. Un lecteur peut ainsi nommer l'intitulé de la valeur plutôt que lire un nombre nu sans contexte

Seul l’appelant sait quelles lignes sont des en-têtes ; une table qui ne fournit aucune indication est donc écrite entièrement sous forme de cellules de données au lieu de recourir à une supposition, car un en-tête mal désigné serait répété pour chaque valeur placée sous lui

Le nombre est utilisé lorsque le balisage des tables est actif (voir SetAutoTagMode) et par DrawTaggedTableRows. Il désigne seulement les en-têtes ; leur répétition est une décision de mise en page de DrawTaggedTableRows. Chaque cellule peut garder son propre type avec SetTableCellTag, prioritaire

Exemple

PDF.SetAutoTagMode(AUTOTAG_DEFAULT);
Table := PDF.CreateTable(4, 3);
PDF.SetTableHeaderRowCount(Table, 1);   // the first row names the columns
PDF.DrawTableRows(Table, 50, 780, 240, 1, 0);

Voir aussi

GetTableHeaderRowCount, SetTableCellTag, DrawTaggedTableRows, SetAutoTagMode