Табличная разметка и отрисовка 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
• Constrained Streaming Layout
• Извлечение типизированных таблиц