THPDFTable-Tabellenlayout und -Rendering

THPDFTable ist die schlanke Tabellenlayout- und Rendering-Engine, die in v2.429.0 eingeführt wurde und über die Unit HPDFTable bereitgestellt wird

Vor v2.429.0 mussten Erzeuger Zellen von Hand mit Rectangle plus TextOut und fest einprogrammierten Spalten-X-Koordinaten zeichnen und Zeilenhöhen, Zebra-Streifen und Seitenumbrüche selbst verwalten; THPDFTable steuert die vorhandenen Zeichenprimitive von THPDFPage, sodass Tabellen mit gemessenen Zeilenhöhen, verbundenen Zellen und automatischer Seitenumbruch-Fortsetzung gerendert werden

Unit

HPDFTable

Verwendungsbeispiel

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 besitzt das Spaltenlayout, die Zeilensammlung und den Render-Durchlauf; es zeichnet über die an THPDFTable.Create übergebene THotPDF-Komponente und verwendet ausschließlich öffentliche Member von THPDFPage und THotPDF

Methoden

Eigenschaften

THPDFTableRow

THPDFTableRow hält die Zellen einer Tabellenzeile plus die zeilenbezogenen Flags, die während Messung und Rendering verwendet werden

THPDFTableCell

THPDFTableCell trägt den Inhalt und die zellbezogenen Überschreibungen, die auf den Tabellen-Standardwerten aufsetzen

Ausrichtungs-Enums

THPDFCellAlign = (caLeft, caCenter, caRight) wählt die horizontale Zellausrichtung und THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) die vertikale Zellausrichtung

Layout- und Seitenumbruch-Verhalten

Zeilenhöhen werden aus dem Zellinhalt mit Word-Wrap und beachtetem THPDFTableRow.MinHeight gemessen, Zellen mit Spannen liegen auf einem internen Raster, sodass THPDFTableCell.ColSpan und THPDFTableCell.RowSpan zeilenübergreifend korrekt verbinden, und der Render-Durchlauf bricht auf eine neue Seite um, wenn die nächste Zeile nicht mehr über THPDFTable.BottomMargin hinaus passt

Wenn THPDFTable.RepeatHeader true ist, wird der Kopfzeilenblock am Anfang jeder Fortsetzungsseite erneut ausgegeben, bevor weitere Zeilen gezeichnet werden

Bildzellen, die in v2.432.0 eingeführt wurden, referenzieren ein per Index über THotPDF.AddImage registriertes Bild, skalieren es auf die Zellbreite und leiten ihre Höhe aus THPDFTableCell.ImageAspect ab, sodass das Bild sein Ursprungsseitenverhältnis behält

Siehe auch

• THotPDF-Klasse
• THPDFPage-Klasse
• THotPDF.AddImage-Methode
• Erweitertes Text- und Streaming-Layout
• Extrahieren typisierter Tabellen