Diseño y renderizado de tablas THPDFTable

THPDFTable es el engine liviano de diseño y renderizado de tablas introducido en v2.429.0 y expuesto por la unidad HPDFTable

Antes de v2.429.0 quienes producían PDF tenían que dibujar las celdas a mano con Rectangle más TextOut y coordenadas X de columnas codificadas en duro, gestionando alturas de fila, rayado cebra y saltos de página manualmente; THPDFTable maneja las primitivas de dibujo existentes de THPDFPage de modo que las tablas se rendericen con alturas de fila medidas, celdas combinadas y continuación automática en 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 es dueño del layout de columnas, de la colección de filas y de la pasada de render; 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 flags a nivel de fila usados durante la medición y el render

THPDFTableCell

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

Enums 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 de la celda

Layout y comportamiento de saltos de página

Las alturas de fila se miden a partir del contenido de las celdas honrando el word wrap y THPDFTableRow.MinHeight, las celdas con span se colocan en una grilla interna de modo que THPDFTableCell.ColSpan y THPDFTableCell.RowSpan se combinen correctamente a través de filas, y la pasada de render 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 encabezado se vuelve a emitir al inicio de cada página de continuación antes de dibujar más filas

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

Véase también

• THotPDF Class
• THPDFPage Class
• THotPDF.AddImage Method
• Layout avanzado de texto y streaming
• Extracción tipada de tablas