Класс QTextTableFormat

Класс QTextTableFormat предоставляет информацию о форматировании таблиц в QTextDocument. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Таблица — это группа ячеек, упорядоченных в строки и столбцы. Каждая таблица содержит по меньшей мере одну строку и один столбец. Каждая ячейка содержит блок. Таблицы в документах форматированного текста форматируются с помощью свойств, определенных в этом классе.

Таблицы выравниваются по горизонтали в рамках родительской рамки в соответствии с выравниванием таблицы. Это можно прочитать с помощью функции alignment() и установить с помощью setAlignment().

Ячейки в таблице разделены межклеточным пространством. Количество пикселей между ячейками устанавливается с помощью setCellSpacing() и читается с помощью cellSpacing(). Содержимое каждой ячейки окружено межклеточным отступом. Количество пикселей между каждым краем ячейки и её содержимым устанавливается с помощью setCellPadding() и читается с помощью cellPadding().

Цвет фона таблицы можно прочитать с помощью функции background() и указать с помощью setBackground(). Цвет фона каждой ячейки можно задать независимо, и он будет контролировать цвет ячейки в области с отступом.

Формат таблицы также предоставляет способ ограничения ширины столбцов в таблице. Столбцам можно назначить фиксированную ширину, переменную ширину или процент от доступной ширины (см. QTextLength). Функция columns() возвращает количество столбцов с ограничениями, а функция columnWidthConstraints() возвращает определённые для таблицы ограничения. Эти величины также можно установить, вызвав setColumnWidthConstraints() со списком, содержащим новые ограничения. Если ограничения не требуются, можно использовать clearColumnWidthConstraints() для их удаления.

См. также QTextTable, QTextTableCell и QTextLength.

Документация по функциям-членам

QTextTableFormat::QTextTableFormat()

Создаёт новый объект формата таблицы.

Qt::Alignment QTextTableFormat::alignment() const

Возвращает выравнивание таблицы.

См. также setAlignment().

[since 5.14] bool QTextTableFormat::borderCollapse() const

Возвращает true, если borderCollapse включен.

Эта функция была добавлена в Qt 5.14.

См. также setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

Возвращает межклеточный отступ таблицы. Это описывает расстояние между границей ячейки и её содержимым.

См. также setCellPadding().

qreal QTextTableFormat::cellSpacing() const

Возвращает межклеточное расстояние таблицы. Это описывает расстояние между смежными ячейками.

См. также setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Очищает ограничения ширины столбцов для таблицы.

См. также columnWidthConstraints() и setColumnWidthConstraints().

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

Возвращает список ограничений, используемых этим форматом таблицы для управления отображением столбцов в таблице.

См. также setColumnWidthConstraints().

int QTextTableFormat::columns() const

Возвращает количество столбцов, указанных в формате таблицы.

int QTextTableFormat::headerRowCount() const

Возвращает количество строк в таблице, определяющих заголовок.

См. также setHeaderRowCount().

bool QTextTableFormat::isValid() const

Возвращает true , если этот формат таблицы действителен; в противном случае возвращает false.

void QTextTableFormat::setAlignment(Qt::Alignment alignment)

Устанавливает выравнивание таблицы.

См. также alignment().

[since 5.14] void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Включение borderCollapse приведёт к следующим последствиям:

• Границы и сетка таблицы будут отрисованы в соответствии с правилами CSS таблицы border-collapse: collapse
• Установка свойства border до минимального значения 1 отобразит однопиксельную твёрдую внутреннюю сетку таблицы с использованием свойства borderBrush и внешней границы, как указано
• Различные свойства стиля границы QTextTableCellFormat могут использоваться для настройки сетки и иметь приоритет над границей и сеткой таблицы
• Свойство cellSpacing будет проигнорировано
• Для печати:
  • Столбцы, продолжающиеся на следующей странице, не будут иметь верхней границы ячейки
  • Повторяющиеся заголовки строк всегда будут иметь нижнюю границу ячейки

При отключённом borderCollapse границы ячеек по-прежнему можно стилизовать с помощью QTextTableCellFormat, но стили будут применяться только в рамках рамки ячейки, что, вероятно, не очень полезно на практике.

Эта функция была добавлена в Qt 5.14.

См. также borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle(), и QTextTableCellFormat.

void QTextTableFormat::setCellPadding(qreal padding)

Устанавливает отступ ячеек padding для таблицы. Это определяет расстояние между границей ячейки и ее содержимым.

См. также cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Устанавливает интервал между ячейками spacing для таблицы. Это определяет расстояние между соседними ячейками.

Этот параметр будет игнорироваться, если включена borderCollapse.

См. также cellSpacing().

void QTextTableFormat::setColumnWidthConstraints(const QList<QTextLength> &constraints)

Устанавливает ограничения ширины столбцов constraints для таблицы.

См. также columnWidthConstraints() и clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount(int count)

Объявляет первые count строк таблицы как заголовок таблицы. Строки заголовка таблицы повторяются при разрыве таблицы на границе страницы.

См. также headerRowCount().