Maquetación y renderizado de tablas THPDFTable

THPDFTable es el motor ligero de maquetación y renderizado de tablas introducido en la v2.429.0 y expuesto por la unidad HPDFTable

Antes de la v2.429.0 los productores tenían que dibujar las celdas a mano con Rectangle más TextOut y coordenadas X de columna fijadas en el código, gestionando a mano alturas de fila, franjas cebra y saltos de página; THPDFTable maneja las primitivas de dibujo existentes de THPDFPage, de modo que las tablas se renderizan con alturas de fila medidas, celdas fusionadas y continuación automática en los saltos de página

Unidad

HPDFTable

Ejemplo 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

THPDFTable posee la maquetación de columnas, la colección de filas y el pase de renderizado; dibuja a través del componente THotPDF pasado a THPDFTable.Create y usa solo miembros públicos de THPDFPage y THotPDF

Métodos

Propiedades

THPDFTableRow

THPDFTableRow contiene las celdas de una fila de tabla más los indicadores a nivel de fila usados durante la medición y el renderizado

THPDFTableCell

THPDFTableCell transporta el contenido y las sobrescrituras por celda aplicadas sobre los valores por defecto de la tabla

Enumerados de alineación

THPDFCellAlign = (caLeft, caCenter, caRight) selecciona la alineación horizontal de la celda y THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) selecciona la alineación vertical

Maquetación y comportamiento de salto de página

Las alturas de fila se miden a partir del contenido de las celdas respetando el ajuste de línea y THPDFTableRow.MinHeight, las celdas expandidas se colocan en una rejilla interna para que THPDFTableCell.ColSpan y THPDFTableCell.RowSpan se fusionen correctamente entre filas, y el pase de renderizado salta a una página nueva cuando la siguiente fila no cabe por encima de THPDFTable.BottomMargin

Cuando THPDFTable.RepeatHeader es true, la banda de cabecera se vuelve a emitir en la parte superior de cada página de continuación antes de dibujar más filas

Las celdas de imagen introducidas en la v2.432.0 referencian por índice una imagen registrada mediante THotPDF.AddImage, se escalan a la anchura de la celda y derivan su altura de THPDFTableCell.ImageAspect, de modo que la imagen mantiene su relación de aspecto de origen

Véase también

• Clase THotPDF
• Clase THPDFPage
• Método THotPDF.AddImage
• Maquetación avanzada de texto y flujo continuo
• Extracción tipada de tablas