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 は 1 つのテーブル行のセルに加えて、測定とレンダリングで使われる行レベルのフラグを保持します

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 メソッド
• 制約付きストリーミングレイアウト
• 型付きテーブル抽出