THPDFTable 表格布局与渲染

THPDFTable 是 v2.429.0 引入的轻量级表格布局与渲染引擎，由 HPDFTable 单元提供

v2.429.0 之前，生成方不得不用 Rectangle 加 TextOut 手绘单元格并硬编码列 X 坐标，行高、斑马纹和分页都要手工管理；THPDFTable 驱动既有的 THPDFPage 绘图原语，让表格以实测行高、合并单元格和自动分页延续的方式渲染

单元

HPDFTable

使用示例

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 持有列布局、行集合和渲染过程；它通过传给 THPDFTable.Create 的 THotPDF 组件绘制，只使用公共的 THPDFPage 与 THotPDF 成员

方法

属性

THPDFTableRow

THPDFTableRow 保存一个表格行的单元格，以及测量与渲染期间使用的行级标志

THPDFTableCell

THPDFTableCell 携带单元格内容，以及在表格默认值之上应用的逐单元格覆盖

对齐枚举

THPDFCellAlign = (caLeft, caCenter, caRight) 选择单元格水平对齐，THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) 选择单元格垂直对齐

布局与分页行为

行高根据单元格内容测量，并遵循自动换行与 THPDFTableRow.MinHeight；跨行跨列单元格放到内部网格上，使 THPDFTableCell.ColSpan 与 THPDFTableCell.RowSpan 正确跨行合并；下一行在 THPDFTable.BottomMargin 之上放不下时，渲染过程会分页到新页面

THPDFTable.RepeatHeader 为 true 时，每个延续页面在绘制后续行之前先重新输出表头带

v2.432.0 引入的图像单元格按索引引用经 THotPDF.AddImage 注册的图像，缩放到单元格宽度，并按 THPDFTableCell.ImageAspect 推导高度，使图片保持源纵横比

另请参见

• THotPDF 类
• THPDFPage 类
• THotPDF.AddImage 方法
• 高级文本与流式布局
• 类型化表格提取