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

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