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 方法
• 進階文字與串流版面
• 具型別表格擷取