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 ` 属性渲染一个 1 像素的实线内部表格网格，并按指定样式显示外部边框
• 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()。