Класс QTextTableFormat

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

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

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

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

• 29 открытых функций, унаследованных от QTextFrameFormat
• 51 открытых функций, унаследованных от QTextFormat

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

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

qreal QTextTableFormat::cellPadding() const

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

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

qreal QTextTableFormat::cellSpacing() const

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

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

void QTextTableFormat::clearColumnWidthConstraints()

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

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

QVector<QTextLength> QTextTableFormat::columnWidthConstraints() const

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

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

int QTextTableFormat::columns() const

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

int QTextTableFormat::headerRowCount() const

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

Эта функция была представлена в Qt 4.2.

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

bool QTextTableFormat::isValid() const

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

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

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

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

void QTextTableFormat::setCellPadding(qreal padding)

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

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

void QTextTableFormat::setCellSpacing(qreal spacing)

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

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

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

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

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

void QTextTableFormat::setHeaderRowCount(int count)

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

Эта функция была представлена в Qt 4.2.

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