THPDFTable 표 레이아웃 및 렌더링

THPDFTable은 v2.429.0에서 도입되어 HPDFTable unit을 통해 노출되는 경량 표 레이아웃·렌더링 엔진입니다

v2.429.0 이전 생산자는 Rectangle과 TextOut에 하드코딩한 컬럼 X 좌표로 셀을 직접 그리면서 행 높이, 줄무늬 배경, 페이지 나눔을 손으로 관리해야 했습니다. THPDFTable은 기존 THPDFPage 드로잉 프리미티브를 구동하므로 표가 측정된 행 높이, 병합 셀, 자동 페이지 나눔 연속과 함께 렌더링됩니다

Unit

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 컴포넌트를 통해 그리며, public THPDFPage와 THotPDF 멤버만 사용합니다

메서드

Property

THPDFTableRow

THPDFTableRow는 표 행 하나의 셀들과 측정·렌더링 과정에서 쓰이는 행 수준 플래그를 담습니다

THPDFTableCell

THPDFTableCell은 셀 내용과 표 기본값 위에 적용되는 셀별 재정의를 담습니다

정렬 enum

THPDFCellAlign = (caLeft, caCenter, caRight)는 셀의 가로 정렬을 고르고 THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom)은 세로 정렬을 고릅니다

레이아웃과 페이지 나눔 동작

행 높이는 word wrap과 THPDFTableRow.MinHeight를 존중해 셀 내용에서 측정되고, 병합 셀은 내부 그리드에 배치되어 THPDFTableCell.ColSpan과 THPDFTableCell.RowSpan이 여러 행에 걸쳐 올바르게 병합됩니다. 다음 행이 THPDFTable.BottomMargin 위에 들어가지 않으면 렌더링 패스가 새 페이지로 넘어갑니다

THPDFTable.RepeatHeader가 True이면 이후 행이 그려지기 전에 연속 페이지마다 상단에 헤더 밴드를 다시 출력합니다

v2.432.0에서 도입된 이미지 셀은 THotPDF.AddImage로 등록된 이미지를 인덱스로 참조하고, 셀 폭에 맞춰 크기를 조정하며, THPDFTableCell.ImageAspect에서 높이를 결정해 그림이 원본 종횡비를 유지합니다

참고 항목

• THotPDF 클래스
• THPDFPage 클래스
• THotPDF.AddImage 메서드
• 고급 텍스트와 스트리밍 레이아웃
• 타입화된 표 추출