class QTextTableFormat#

QTextTableFormat 类提供 QTextDocument 表格的格式信息。更多信息...

概要#

方法#

def __init__()
def alignment()
def borderCollapse()
def cellPadding()
def cellSpacing()
def clearColumnWidthConstraints()
def columnWidthConstraints()
def columns()
def headerRowCount()
def setAlignment()
def setBorderCollapse()
def setCellPadding()
定义 setCellSpacing()
定义 setColumnWidthConstraints()
定义 setColumns()
定义 setHeaderRowCount()

注意

本文档可能包含从C++到Python自动翻译的代码片断。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告诉我们

详细信息#

表格是一组按行和列排列的单元格。每个表格至少包含一行和一列。每个单元格包含一个块。在富文本文档中，表格使用此类定义的属性进行格式化。

表格在其父框架内水平居中对齐。这可以通过alignment()函数读出，并通过setAlignment()设置。

表中的单元格通过单元格间距分开。单元格之间的像素数由setCellSpacing()设置并通过cellSpacing()读取。每个单元格的内容周围是单元格填充。每个单元格边缘与其内容之间的像素数由setCellPadding()设置并通过cellPadding()读取。

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

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

也请参阅

QTextTable QTextTableCell QTextLength

__init__(fmt)#

参数:: fmt – QTextFormat

__init__()

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

alignment()#

返回类型:: AlignmentFlag的组合

返回表格的对齐方式。

也请参阅

setAlignment()

borderCollapse()#

返回类型:: 布尔值

如果已启用borderCollapse，则返回true。

也请参阅

setBorderCollapse()

cellPadding()#

返回类型:: 浮点数

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

也请参阅

setCellPadding()

cellSpacing()#

返回类型:: 浮点数

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

也请参阅

setCellSpacing()

clearColumnWidthConstraints()#

清除表格的列宽约束。

也请参阅

columnWidthConstraints() setColumnWidthConstraints()

columnWidthConstraints()#

返回类型:: .QTextLength对象的列表

返回由该表格格式使用，以控制表格中列外观的约束列表。

也请参阅

setColumnWidthConstraints()

columns()#

返回类型:: int

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

headerRowCount()#

返回类型:: int

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

也请参阅

setHeaderRowCount()

setAlignment(alignment)#

参数:: alignment - `AlignmentFlag`的组合

设置表格的对齐方式。

也请参阅

alignment()

setBorderCollapse(borderCollapse)#

参数:: borderCollapse – bool

启用`borderCollapse`会有以下影响

表格的边框和网格将按照CSS表格`border-collapse`: `collapse`规则进行渲染

将`border`属性设置为一个最小值为`1`的值，将使用`borderBrush`属性和指定的外部边框渲染一个一像素实心内部表格网格

可以使用`QTextTableCellFormat`的各种边框样式属性来自定义网格，并将优先级置于表格的边框和网格之上

`cellSpacing`属性将被忽略

对于打印分页

在页面上继续的列将不会渲染顶单元格边框

重复的标题行将始终渲染底单元格边框

禁用 borderCollapse 后，单元格边框仍可以使用 QTextTableCellFormat 进行样式设置，但样式仅应用于单元格的框架内，这在实际应用中可能不太有用。

也请参阅

borderCollapse() setBorder() setBorderBrush() setBorderStyle() QTextTableCellFormat

setCellPadding(padding)#

参数:: padding – float

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

也请参阅

cellPadding()

setCellSpacing(spacing)#

参数:: spacing – float

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

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

也请参阅

cellSpacing()

setColumnWidthConstraints(constraints)#

参数:: constraints – .list of QTextLength

设置表格列宽 constraints。

也请参阅

columnWidthConstraints() clearColumnWidthConstraints()

setColumns(columns)#

参数:: columns – int

setHeaderRowCount(count)#

参数:: count – int

将表格的前 count 行声明为表头。当表格跨越页面边界分割时，表头行将被重复。

也请参阅

headerRowCount()