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