|CMake:|| find_package(Qt6 REQUIRED COMPONENTS Gui) |
target_link_libraries(mytarget PRIVATE Qt6::Gui)
|qmake:||QT += gui|
Note: All functions in this class are reentrant.
|void||setColumnWidthConstraints(const QList<QTextLength> &constraints)|
A table is a group of cells ordered into rows and columns. Each table contains at least one row and one column. Each cell contains a block. Tables in rich text documents are formatted using the properties defined in this class.
Cells within the table are separated by cell spacing. The number of pixels between cells is set with setCellSpacing() and read with cellSpacing(). The contents of each cell is surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().
The table's background color can be read with the background() function, and can be specified with setBackground(). The background color of each cell can be set independently, and will control the color of the cell within the padded area.
The table format also provides a way to constrain the widths of the columns in the table. Columns can be assigned a fixed width, a variable width, or a percentage of the available width (see QTextLength). The columns() function returns the number of columns with constraints, and the columnWidthConstraints() function returns the constraints defined for the table. These quantities can also be set by calling setColumnWidthConstraints() with a list containing new constraints. If no constraints are required, clearColumnWidthConstraints() can be used to remove them.
Member Function Documentation
Constructs a new table format object.
Qt::Alignment QTextTableFormat::alignment() const
Returns the table's alignment.
See also setAlignment().
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().
Clears the column width constraints for the table.
QList<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().
Returns the number of columns specified by the table format.
Returns the number of rows in the table that define the header.
See also setHeaderRowCount().
true if this table format is valid; otherwise returns
void QTextTableFormat::setAlignment(Qt::Alignment alignment)
Sets the table's alignment.
See also alignment().
Enabling borderCollapse will have the following implications:
- The borders and grid of the table will be rendered following the CSS table
- Setting the
borderproperty to a minimum value of
1will 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
This function was introduced in Qt 5.14.
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 QList<QTextLength> &constraints)
Sets the column width constraints for the table.
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.
See also headerRowCount().
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.