Класс 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 table 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().