Mise en page et rendu de tableaux THPDFTable

THPDFTable est le moteur léger de mise en page et de rendu de tableaux introduit en v2.429.0 et exposé par l'unité HPDFTable

Avant la v2.429.0, les producteurs devaient dessiner les cellules à la main avec Rectangle et TextOut et des coordonnées X de colonnes codées en dur, en gérant manuellement les hauteurs de lignes, le zébrage et les sauts de page ; THPDFTable pilote les primitives de dessin THPDFPage existantes si bien que les tableaux se rendent avec des hauteurs de lignes mesurées, des cellules fusionnées et une continuation automatique sur les sauts de page

Unité

HPDFTable

Exemple d'utilisation

uses
  HPDFTable;

var
  Tbl: THPDFTable;
  Row: THPDFTableRow;
begin
  Tbl:= THPDFTable.Create(HPDF);
  try
    Tbl.AddColumn(80); Tbl.AddColumn(200); Tbl.AddColumn(120);
    Tbl.SetBounds(50, 60);
    Row:= Tbl.AddRow; Row.IsHeader:= True;
    Row.Cells[0].Text:= 'No';
    Row.Cells[1].Text:= 'Description';
    Row:= Tbl.AddRow;
    Row.Cells[0].ColSpan:= 2;          // merged cell across columns 0..1
    Row.Cells[0].Text:= 'merged header';
    Tbl.Render;
  finally
    Tbl.Free;
  end;
end;

THPDFTable

THPDFTable possède la mise en page des colonnes, la collection de lignes et la passe de rendu ; il dessine via le composant THotPDF transmis à THPDFTable.Create et n'utilise que des membres publics de THPDFPage et THotPDF

Méthodes

Propriétés

THPDFTableRow

THPDFTableRow contient les cellules d'une ligne de tableau plus les indicateurs de niveau ligne utilisés pendant la mesure et le rendu

THPDFTableCell

THPDFTableCell porte le contenu et les surcharges par cellule appliquées par-dessus les valeurs par défaut du tableau

Énumérations d'alignement

THPDFCellAlign = (caLeft, caCenter, caRight) sélectionne l'alignement horizontal des cellules et THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) sélectionne l'alignement vertical des cellules

Mise en page et comportement des sauts de page

Les hauteurs de lignes sont mesurées depuis le contenu des cellules en honorant le repli de texte et THPDFTableRow.MinHeight, les cellules étendues sont placées sur une grille interne afin que THPDFTableCell.ColSpan et THPDFTableCell.RowSpan fusionnent correctement à travers les lignes, et la passe de rendu passe à une nouvelle page lorsque la ligne suivante ne tient pas au-dessus de THPDFTable.BottomMargin

Lorsque THPDFTable.RepeatHeader est vrai, la bande d'en-tête est réémise en haut de chaque page de continuation avant que d'autres lignes ne soient dessinées

Les cellules image introduites en v2.432.0 référencent par index une image enregistrée via THotPDF.AddImage, se mettent à l'échelle de la largeur de la cellule et dérivent leur hauteur de THPDFTableCell.ImageAspect afin que l'image conserve son ratio d'origine

Voir aussi

• Classe THotPDF
• Classe THPDFPage
• Méthode THotPDF.AddImage
• Texte avancé et mise en page en flux
• Extraction typée de tableaux