THPDFTable Table Layout and Rendering

THPDFTable is the lightweight table layout and rendering engine that arrived in v2.429.0 and is exposed by the HPDFTable unit

Before v2.429.0, producers had to draw cells by hand with Rectangle plus TextOut and hard-coded column X coordinates, handling row heights, zebra striping and page breaks themselves; THPDFTable drives the existing THPDFPage drawing primitives, so tables render with measured row heights, merged cells and automatic page-break continuation

Unit

HPDFTable

Example of use

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 owns the column layout, the row collection and the render pass; it draws through the THotPDF component handed to THPDFTable.Create and touches only public THPDFPage and THotPDF members

Methods

Properties

THPDFTableRow

THPDFTableRow holds one table row's cells together with the row-level flags used during measurement and rendering

THPDFTableCell

THPDFTableCell carries the content plus the per-cell overrides layered on top of the table defaults

Alignment enums

THPDFCellAlign = (caLeft, caCenter, caRight) picks the horizontal cell alignment and THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) the vertical one

Layout and page-break behaviour

Row heights are measured from cell content with word wrap and THPDFTableRow.MinHeight honoured; spanning cells sit on an internal grid so THPDFTableCell.ColSpan and THPDFTableCell.RowSpan merge correctly across rows; and the render pass breaks to a new page when the next row will not fit above THPDFTable.BottomMargin

With THPDFTable.RepeatHeader true, the header band is emitted again at the top of every continuation page before any further rows are drawn

Image cells, introduced in v2.432.0, reference by index an image registered through THotPDF.AddImage, scale to the cell width and take their height from THPDFTableCell.ImageAspect, so the picture keeps its source aspect ratio

See also

• THotPDF Class
• THPDFPage Class
• THotPDF.AddImage Method
• Advanced text and streaming layout
• Typed table extraction