Layout e renderização de tabelas THPDFTable

O THPDFTable é a engine leve de layout e renderização de tabelas introduzida no v2.429.0 e exposta pela unidade HPDFTable

Antes do v2.429.0, os produtores precisavam desenhar células à mão com Rectangle mais TextOut e coordenadas X de colunas fixadas no código, gerenciando alturas de linha, listras zebra e quebras de página manualmente; o THPDFTable dirige as primitivas de desenho existentes do THPDFPage para que as tabelas sejam renderizadas com alturas de linha medidas, células mescladas e continuação automática de quebra de página

Unidade

HPDFTable

Exemplo de uso

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

O THPDFTable é dono do layout de colunas, da coleção de linhas e da passada de renderização; ele desenha por meio do componente THotPDF passado ao THPDFTable.Create e usa apenas membros públicos de THPDFPage e THotPDF

Métodos

Propriedades

THPDFTableRow

O THPDFTableRow guarda as células de uma linha da tabela mais as flags no nível de linha usadas durante a medição e a renderização

THPDFTableCell

O THPDFTableCell carrega o conteúdo e as sobrescritas por célula aplicadas sobre os padrões da tabela

Enums de alinhamento

O THPDFCellAlign = (caLeft, caCenter, caRight) seleciona o alinhamento horizontal da célula e o THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) seleciona o alinhamento vertical da célula

Layout e comportamento de quebra de página

As alturas das linhas são medidas a partir do conteúdo das células respeitando o word wrap e o THPDFTableRow.MinHeight, as células de span são posicionadas em um grid interno para que o THPDFTableCell.ColSpan e o THPDFTableCell.RowSpan mesclem corretamente entre linhas, e a passada de renderização quebra para uma nova página quando a próxima linha não cabe acima do THPDFTable.BottomMargin

Quando o THPDFTable.RepeatHeader é true, a faixa de cabeçalho é emitida novamente no topo de cada página de continuação antes que mais linhas sejam desenhadas

As células de imagem introduzidas no v2.432.0 referenciam por índice uma imagem registrada por meio do THotPDF.AddImage, escalam para a largura da célula e derivam a altura delas do THPDFTableCell.ImageAspect, de modo que a figura mantenha o aspect ratio da origem

Veja também

• Classe THotPDF
• Classe THPDFPage
• Método THotPDF.AddImage
• Layout avançado de texto e streaming
• Extração tipada de tabelas