QTextTableFormat 类

The QTextTableFormat class provides formatting information for tables in a QTextDocument. 更多信息...

头文件	#include <QTextTableFormat>
CMake	find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake	QT += gui
继承自	QTextFrameFormat

包括继承成员的所有成员列表
QTextTableFormat 是丰富文本处理 API 的一部分，也是隐式共享类的一部分。Rich Text Processing APIs 和 Implicitly Shared Classes.

注意： 此类中的所有函数都是可重入的。

公共函数

	QTextTableFormat()
Qt::Alignment	alignment() const
bool	borderCollapse() const
qreal	cellPadding() const
qreal	cellSpacing() const
void	clearColumnWidthConstraints()
QList<QTextLength>	columnWidthConstraints() const
int	columns() const
int	headerRowCount() const
bool	isValid() const
void	setAlignment(Qt::Alignment alignment)
void	setBorderCollapse(bool borderCollapse)
void	setCellPadding(qreal padding)
void	setCellSpacing(qreal spacing)
void	setColumnWidthConstraints(const QList<QTextLength> &constraints)
void	setHeaderRowCount(int count)

详细描述

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.

Tables are horizontally justified within their parent frame according to the table's alignment. This can be read with the alignment() function and set with setAlignment().

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 are surrounded by cell padding. The number of pixels between each cell edge and its contents is set with setCellPadding() and read with cellPadding().

可以通过 background() 函数读取表格的背景颜色，并用 setBackground() 指定。每个单元格的背景颜色可以独立设置，并将控制填充区域内单元格的颜色。

表格格式还提供了一种方法来限制表格中列的宽度。列可以分配固定宽度、可变宽度或可用宽度的百分比（参见 QTextLength）。columns() 函数返回受限列的数量，columnWidthConstraints() 函数返回定义在表格上的约束。这些数量也可以通过调用包含新约束的列表的 setColumnWidthConstraints() 来设置。如果不需要约束，可以使用 clearColumnWidthConstraints() 来删除它们。

另请参阅 QTextTable、QTextTableCell 和 QTextLength。

成员函数文档

QTextTableFormat::QTextTableFormat()

构建一个新的表格格式对象。

Qt::Alignment QTextTableFormat::alignment() const

返回表格的对齐方式。

另请参阅 setAlignment()。

bool QTextTableFormat::borderCollapse() const

如果启用 borderCollapse，则返回 true。

另请参阅 setBorderCollapse()。

qreal QTextTableFormat::cellPadding() const

返回表格的单元格填充。这描述了单元格边框与其内容之间的距离。

另请参阅 setCellPadding()。

qreal QTextTableFormat::cellSpacing() const

返回表格的单元格间距。这描述了相邻单元格之间的距离。

另请参阅 setCellSpacing()。

void QTextTableFormat::clearColumnWidthConstraints()

清除表格的列宽度约束。

另请参阅 columnWidthConstraints() 和 setColumnWidthConstraints()。

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

返回此表格格式所使用的约束列表，用于控制表格中的列的显示。

另请参阅 setColumnWidthConstraints()。

int QTextTableFormat::columns() const

返回由表格格式指定的列数。

int QTextTableFormat::headerRowCount() const

返回定义标题的表格中的行列数。

另请参阅 setHeaderRowCount()。

bool QTextTableFormat::isValid() const

如果此表格格式有效，则返回 true；否则返回 false。

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

设置表格的对齐。

另请参阅 对齐()。

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

启动 borderCollapse 将有以下影响

表格的边框和网格将按照CSS表格 border-collapse: collapse 规则渲染
将 border 属性设置为最小值 1 将使用 borderBrush 属性和指定的外边框渲染一个像素的单实线内表格网格
可以使用 QTextTableCellFormat 的各种边框样式属性来自定义网格，并优先于表格的边框和网格
将忽略 cellSpacing 属性
对于打印分页
- 在页面继续的列将不会绘制顶部单元格边框
- 重复的标题行总是会绘制底部单元格边框

如果 borderCollapse 被禁用，仍然可以使用 QTextTableCellFormat 来样式化单元格边框，但样式将仅应用于单元格的框架内，这在实际中可能不太有用。

另请参阅 borderCollapse()，setBorder()，setBorderBrush()，setBorderStyle() 和 QTextTableCellFormat。

void QTextTableFormat::setCellPadding(qreal padding)

设置表格单元格的 padding。这决定了单元格边框和其内容之间的距离。

另请参阅 cellPadding()。

void QTextTableFormat::setCellSpacing(qreal spacing)

设置表格单元格的 spacing。这决定了相邻单元格之间的距离。

如果 borderCollapse 启用，则将忽略此属性。

另请参阅 cellSpacing()。

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

设置表格的列宽 constraints。

另请参阅 columnWidthConstraints() 和 clearColumnWidthConstraints。

void QTextTableFormat::setHeaderRowCount(int count)

将表格的前 count 行指定为表头。当表格跨页边界断裂时，表头行会被重复。

另请参阅 headerRowCount。