QTextTableFormat Class

Member Function Documentation

QTextTableFormat::QTextTableFormat()

Constructs a new table format object.

Qt::Alignment QTextTableFormat::alignment() const

Returns the table's alignment.

See also setAlignment().

bool QTextTableFormat::borderCollapse() const

Returns true if borderCollapse is enabled.

This function was introduced in Qt 5.14.

See also setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

Returns the table's cell padding. This describes the distance between the border of a cell and its contents.

See also setCellPadding().

qreal QTextTableFormat::cellSpacing() const

Returns the table's cell spacing. This describes the distance between adjacent cells.

See also setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Clears the column width constraints for the table.

See also columnWidthConstraints() and setColumnWidthConstraints().

QVector<QTextLength> QTextTableFormat::columnWidthConstraints() const

Returns a list of constraints used by this table format to control the appearance of columns in a table.

See also setColumnWidthConstraints().

int QTextTableFormat::columns() const

Returns the number of columns specified by the table format.

int QTextTableFormat::headerRowCount() const

Returns the number of rows in the table that define the header.

This function was introduced in Qt 4.2.

See also setHeaderRowCount().

bool QTextTableFormat::isValid() const

Returns true if this table format is valid; otherwise returns false.

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

Sets the table's alignment.

See also alignment().

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Enabling borderCollapse will have the following implications:

• The borders and grid of the table will be rendered following the CSS table border-collapse: collapse rules
• Setting the border property to a minimum value of 1 will render a one pixel solid inner table grid using the borderBrush property and an outer border as specified
• The various border style properties of QTextTableCellFormat can be used to customize the grid and have precedence over the border and grid of the table
• The cellSpacing property will be ignored
• For print pagination:
  • Columns continued on a page will not have their top cell border rendered
  • Repeated header rows will always have their bottom cell border rendered

With borderCollapse disabled, cell borders can still be styled using QTextTableCellFormat but styling will be applied only within the cell's frame, which is probably not very useful in practice.

This function was introduced in Qt 5.14.

See also borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle(), and QTextTableCellFormat.

void QTextTableFormat::setCellPadding(qreal padding)

Sets the cell padding for the table. This determines the distance between the border of a cell and its contents.

See also cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Sets the cell spacing for the table. This determines the distance between adjacent cells.

This property will be ignored if borderCollapse is enabled.

See also cellSpacing().

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

Sets the column width constraints for the table.

See also columnWidthConstraints() and clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount(int count)

Declares the first count rows of the table as table header. The table header rows get repeated when a table is broken across a page boundary.

This function was introduced in Qt 4.2.

See also headerRowCount().