THPDFTable — układ i renderowanie tabel

THPDFTable to lekki silnik układu i renderowania tabel wprowadzony w v2.429.0 i wystawiany przez unit HPDFTable

Przed v2.429.0 producenci musieli rysować komórki ręcznie przez Rectangle plus TextOut z zaszytymi na stałe współrzędnymi X kolumn, sami zarządzając wysokościami wierszy, pasami zebry i łamaniem stron; THPDFTable steruje istniejącymi prymitywami rysowania THPDFPage, więc tabele renderują się z wymiernymi wysokościami wierszy, scalonymi komórkami i automatyczną kontynuacją po łamaniu stron

Unit

HPDFTable

Przykład użycia

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 jest właścicielem układu kolumn, kolekcji wierszy i przebiegu renderowania; rysuje przez komponent THotPDF przekazany do THPDFTable.Create i korzysta wyłącznie z publicznych składowych THPDFPage i THotPDF

Metody

Właściwości

THPDFTableRow

THPDFTableRow przechowuje komórki jednego wiersza tabeli plus flagi poziomu wiersza używane podczas pomiaru i renderowania

THPDFTableCell

THPDFTableCell niesie zawartość i nadpisania per komórka nakładane na wartości domyślne tabeli

Wyliczenia wyrównania

THPDFCellAlign = (caLeft, caCenter, caRight) wybiera poziome wyrównanie komórki, a THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) — pionowe wyrównanie komórki

Layout i zachowanie łamania stron

Wysokości wierszy są mierzone z zawartości komórek z poszanowaniem zawijania słów i THPDFTableRow.MinHeight, komórki rozciągane trafiają na wewnętrzną siatkę, więc THPDFTableCell.ColSpan i THPDFTableCell.RowSpan scalają się poprawnie w poprzek wierszy, a przebieg renderowania łamie się do nowej strony, gdy następny wiersz nie mieści się nad THPDFTable.BottomMargin

Gdy THPDFTable.RepeatHeader jest true, pas nagłówka jest emitowany ponownie w górnej części każdej strony kontynuacji przed dalszymi wierszami

Komórki obrazowe wprowadzone w v2.432.0 odwołują się po indeksie do obrazu zarejestrowanego przez THotPDF.AddImage, skalują się do szerokości komórki i wyliczają wysokość z THPDFTableCell.ImageAspect, dzięki czemu obraz zachowuje proporcje źródła

Zobacz też

• Klasa THotPDF
• Klasa THPDFPage
• Metoda THotPDF.AddImage
• Zaawansowany tekst i układ strumieniowy
• Ekstrakcja tabel typowanych