Компонування та рендеринг таблиць THPDFTable

THPDFTable — це легкий рушій компонування та рендерингу таблиць, представлений у v2.429.0 і доступний через юніт HPDFTable

До v2.429.0 генераторам доводилося малювати комірки вручну через Rectangle плюс TextOut із зашитими X-координатами стовпців, керуючи висотами рядків, зебра-смугуванням і розривами сторінок власноруч; THPDFTable керує наявними примітивами малювання THPDFPage, тож таблиці рендеряться з виміряними висотами рядків, об'єднаними комірками та автоматичним продовженням на нових сторінках

Юніт

HPDFTable

Приклад використання

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 володіє компонуванням стовпців, колекцією рядків і проходом рендерингу; він малює через компонент THotPDF, переданий у THPDFTable.Create, і використовує лише публічні члени THPDFPage і THotPDF

Методи

Властивості

THPDFTableRow

THPDFTableRow утримує комірки одного рядка таблиці плюс прапорці рівня рядка, що використовуються під час вимірювання та рендерингу

THPDFTableCell

THPDFTableCell несе вміст і перевизначення на рівні комірки, що застосовуються поверх усталених значень таблиці

Перечислення вирівнювання

THPDFCellAlign = (caLeft, caCenter, caRight) обирає горизонтальне вирівнювання комірки, а THPDFCellVAlign = (cvaTop, cvaMiddle, cvaBottom) — вертикальне вирівнювання комірки

Компонування та поведінка розривів сторінок

Висоти рядків вимірюються з вмісту комірок з урахуванням перенесення слів і THPDFTableRow.MinHeight, комірки, що охоплюють кілька позицій, розміщуються на внутрішній сітці, тож THPDFTableCell.ColSpan і THPDFTableCell.RowSpan коректно об'єднуються крізь рядки, а прохід рендерингу переходить на нову сторінку, коли наступний рядок не вміщується над THPDFTable.BottomMargin

Коли THPDFTable.RepeatHeader дорівнює true, смуга заголовка повторно видається вгорі кожної сторінки-продовження перед малюванням подальших рядків

Комірки з зображеннями, представлені у v2.432.0, посилаються за індексом на зображення, зареєстроване через THotPDF.AddImage, масштабуються до ширини комірки та виводять висоту з THPDFTableCell.ImageAspect, тож картинка зберігає пропорції джерела

Дивіться також

• THotPDF Class
• THPDFPage Class
• THotPDF.AddImage Method
• Advanced text and streaming layout
• Typed table extraction