PySide6.QtGui.QTextTableFormat¶

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()
def setCellSpacing()
def setColumnWidthConstraints()
def setColumns()
def 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__()¶

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

__init__(fmt)

Parameters:: fmt – QTextFormat

alignment()¶

Return type:: AlignmentFlag 的组合

返回表格的对齐方式。

另请参阅

setAlignment()

borderCollapse()¶

Return type:: 布尔

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

另请参阅

setBorderCollapse()

cellPadding()¶

Return type:: 浮点数

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

另请参阅

setCellPadding()

cellSpacing()¶

Return type:: 浮点数

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

另请参阅

setCellSpacing()

clearColumnWidthConstraints()¶

清除表格的列宽约束。

另请参阅

columnWidthConstraints() setColumnWidthConstraints()

columnWidthConstraints()¶

Return type:: QTextLength的列表

返回此表格式用于控制表中列外观的约束列表。

另请参阅

setColumnWidthConstraints()

columns()¶

Return type:: 整数

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

headerRowCount()¶

Return type:: 整数

返回定义表头的行数。

另请参阅

setHeaderRowCount()

setAlignment(alignment)¶

Parameters:: alignment – AlignmentFlag 的组合

设置表格的alignment。

另请参阅

alignment()

setBorderCollapse(borderCollapse)¶

Parameters:: borderCollapse – 布尔值

启用 borderCollapse 将产生以下影响：

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

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

QTextTableCellFormat 的各种边框样式属性可用于自定义网格，并优先于表格的边框和网格。

cellSpacing 属性将被忽略

用于打印分页：

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

重复的表头行将始终渲染其底部单元格边框

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

另请参阅

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

setCellPadding(padding)¶

Parameters:: padding – 浮点数

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

另请参阅

cellPadding()

setCellSpacing(spacing)¶

Parameters:: 间距 – float

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

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

另请参阅

cellSpacing()

setColumnWidthConstraints(constraints)¶

Parameters:: constraints – QTextLength 的列表

设置表格的列宽约束。

另请参阅

columnWidthConstraints() clearColumnWidthConstraints()

setColumns(columns)¶

Parameters:: columns – int

setHeaderRowCount(count)¶

Parameters:: count – int

声明表格的前count行为表头。当表格跨页时，表头行会重复显示。

另请参阅

headerRowCount()