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

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().

void QTextTableFormat::setCellPadding(qreal padding)

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

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

void QTextTableFormat::setCellSpacing(qreal spacing)

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

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

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

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

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

void QTextTableFormat::setHeaderRowCount(int count)

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

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

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