THPDFTable tabelayout og rendering

THPDFTable er den letvægts tabelayout- og renderingmotor, der kom til i v2.429.0 og eksponeres af HPDFTable-unit'en

Før v2.429.0 skulle man tegne celler i hånden med Rectangle plus TextOut og hårdkodede kolonne-X-koordinater, mens rækkehøjder, zebra-stribning og sideskift skulle styres manuelt; THPDFTable kører oven på de eksisterende THPDFPage-tegneprimitiver, så tabeller renderes med målte rækkehøjder, flettede celler og automatisk fortsættelse ved sideskift

Enhed

HPDFTable

Eksempel på brug

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 ejer kolonnelayoutet, rækkesamlingen og selve renderingen; den tegner gennem THotPDF-komponenten, som sendes til THPDFTable.Create, og bruger kun offentlige THPDFPage- og THotPDF-medlemmer

Metoder

Egenskaber

THPDFTableRow

THPDFTableRow rummer cellerne i én tabelrække plus de række-niveau flag, der bruges under måling og rendering

THPDFTableCell

THPDFTableCell bærer indholdet og de celle-specifikke tilsidesættelser, som lægges oven på tabelstandarderne

Justering-enums

THPDFCellAlign = (caLeft, caCenter, caRight) vælger vandret cellejustering, og THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) vælger lodret cellejustering

Layout og sideskift-adfærd

Rækkehøjder måles ud fra celleindholdet med ordombrydning og THPDFTableRow.MinHeight respekteret, spændende celler placeres på et internt gitter, så THPDFTableCell.ColSpan og THPDFTableCell.RowSpan fletter korrekt på tværs af rækker, og renderingen skifter til en ny side, når næste række ikke kan være over THPDFTable.BottomMargin

Når THPDFTable.RepeatHeader er sand, gentages hovedbåndet øverst på hver fortsættelsesside, før yderligere rækker tegnes

Billedceller, der kom til i v2.432.0, refererer til et billede registreret gennem THotPDF.AddImage via indeks, skaleres til cellebredden og afleder deres højde fra THPDFTableCell.ImageAspect, så billedet bevarer sit oprindelige aspektforhold

Se også

• THotPDF Class
• THPDFPage Class
• THotPDF.AddImage Method
• Avanceret tekst- og streaminglayout
• Typet tabeludtræk