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

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

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::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)

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

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

void QTextTableFormat::setCellSpacing(qreal spacing)

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

Это свойство будет проигнорировано, если borderCollapse включено.

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

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

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

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

void QTextTableFormat::setHeaderRowCount(int count)

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

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

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