QTextTableFormat Class

成员函数文档

QTextTableFormat::QTextTableFormat()

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

Qt::Alignment QTextTableFormat::alignment() const

返回表格的对齐方式。

另请参见 setAlignment()。

bool QTextTableFormat::borderCollapse() const

如果要折叠表格边框，则返回true 。默认值为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)

设置表格的alignment 。

另请参阅 alignment() 。

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

默认情况下，borderCollapse() 是true ，其含义如下：

• 表格的边框和网格将按照 CSS 表格border-collapse:collapse 规则呈现
• 将border 属性设置为1 的最小值，将使用borderBrush 属性渲染一个一像素实心的表格内网格，并渲染指定的外边框
• QTextTableCellFormat 的各种边框样式属性可用于自定义网格，并优先于表格的边框和网格
• cellSpacing 属性将被忽略
• 用于打印分页：
  • 页面上继续显示的列将不会显示其顶部单元格边框
  • 重复的标题行将始终显示其单元格下边框

当borderCollapse 设置为false 时，仍可使用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()。