QTextBlockFormat Class

成员函数文档

QTextBlockFormat::QTextBlockFormat()

创建一个新的 QTextBlockFormat。

Qt::Alignment QTextBlockFormat::alignment() const

返回段落的对齐方式。

另请参阅 setAlignment()。

qreal QTextBlockFormat::bottomMargin() const

返回段落的底部边距。

另请参阅 setBottomMargin()和topMargin()。

int QTextBlockFormat::headingLevel() const

如果该段落是标题，则返回其标题级别；否则返回 0。

另请参阅 setHeadingLevel()。

int QTextBlockFormat::indent() const

返回该段落的缩进量。

另请参阅 setIndent()。

bool QTextBlockFormat::isValid() const

如果该块格式有效，则返回true ；否则返回false。

qreal QTextBlockFormat::leftMargin() const

返回该段落的左边距。

另请参阅 setLeftMargin()、rightMargin() 以及indent()。

qreal QTextBlockFormat::lineHeight() const

该方法返回该段落的 LineHeight 属性。

另请参阅 LineHeightTypes 、setLineHeight() 以及lineHeightType()。

qreal QTextBlockFormat::lineHeight(qreal scriptLineHeight, qreal scaling = 1.0) const

根据scriptLineHeight 指定的脚本行高度和指定的scaling 因子，返回段落中各行的高度。

返回的值还取决于段落的 LineHeightType 属性以及为该段落设置的 LineHeight 参数。

对于包含固定像素数的高程，需要进行缩放，以便在打印时进行适当调整。

另请参阅 LineHeightTypes 、setLineHeight() 和lineHeightType()。

int QTextBlockFormat::lineHeightType() const

此方法返回段落的 LineHeightType 属性。

另请参阅 LineHeightTypes 、setLineHeight() 以及lineHeight()。

QTextBlockFormat::MarkerType QTextBlockFormat::marker() const

如果已设置段落标记，则返回该标记；否则返回NoMarker 。

另请参阅 setMarker()。

bool QTextBlockFormat::nonBreakableLines() const

如果段落中的行不可换行，则返回 `true `；否则返回 `false`。

另请参阅 setNonBreakableLines()。

QTextFormat::PageBreakFlags QTextBlockFormat::pageBreakPolicy() const

返回该段落当前设置的分页策略。默认值为QTextFormat::PageBreak_Auto 。

另请参阅 setPageBreakPolicy()。

qreal QTextBlockFormat::rightMargin() const

返回段落的右边距。

另请参阅 setRightMargin() 和leftMargin()。

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

设置段落的alignment 。

另请参阅 alignment()。

void QTextBlockFormat::setBottomMargin(qreal margin)

设置段落的底部margin 。

另请参阅 bottomMargin()、setTopMargin()、setLeftMargin() 和setRightMargin()。

void QTextBlockFormat::setHeadingLevel(int level)

设置段落的标题级别level ，其中 1 代表最高级别的标题类型（通常采用最大的标题字号），数值越大，在文档中的层级越深（通常字号也越小）。 例如，在读取 HTML H1 标签时，标题级别会被设置为 1。设置标题级别并不会自动更改字体大小；但QTextDocumentFragment::fromHtml() 会同时设置标题级别和字体大小。

如果该段落不是标题，则应将级别设置为 0（默认值）。

另请参阅 headingLevel()。

void QTextBlockFormat::setIndent(int indentation)

设置段落的“indentation ”。边距可通过setLeftMargin()和setTextIndent()独立于缩进进行设置。indentation 是一个整数，它与文档范围内的标准缩进值相乘，从而得出段落的实际缩进量。

另请参阅 indent() 和QTextDocument::indentWidth()。

void QTextBlockFormat::setLeftMargin(qreal margin)

设置段落的左侧缩进margin 。缩进可通过setIndent()单独设置。

另请参阅 leftMargin()、setRightMargin()、setTopMargin() 以及setBottomMargin()。

void QTextBlockFormat::setLineHeight(qreal height, int heightType)

将段落的行高设置为height 指定的值，该值取决于heightType ，具体方式由LineHeightTypes 枚举所描述。

另请参阅 LineHeightTypes 、lineHeight() 以及lineHeightType()。

void QTextBlockFormat::setMarker(QTextBlockFormat::MarkerType marker)

将应与段落一同渲染的装饰类型设置为marker 。例如，列表项可以使用复选框（无论是否被选中）作为其项目符号的替代装饰。默认值为NoMarker 。

另请参阅 marker()。

void QTextBlockFormat::setNonBreakableLines(bool b)

如果b 为真，则段落中的行被视为不可换行；否则，这些行可换行。

另请参阅 nonBreakableLines()。

void QTextBlockFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)

将该段落的分页策略设置为policy 。

另请参阅 pageBreakPolicy()。

void QTextBlockFormat::setRightMargin(qreal margin)

设置段落的右对齐方式margin 。

另请参阅 rightMargin()、setLeftMargin()、setTopMargin() 以及setBottomMargin()。

void QTextBlockFormat::setTabPositions(const QList<QTextOption::Tab> &tabs)

将文本块的制表符位置设置为tabs 中指定的位置。

另请参阅 tabPositions()。

void QTextBlockFormat::setTextIndent(qreal indent)

设置块中第一行的indent 。这使得段落的第一行可以与其他行采用不同的缩进方式，从而提高文本的可读性。

另请参阅 textIndent()、setLeftMargin()、setRightMargin()、setTopMargin() 以及setBottomMargin()。

void QTextBlockFormat::setTopMargin(qreal margin)

设置段落的顶部margin 。

另请参阅 topMargin()、setBottomMargin()、setLeftMargin() 以及setRightMargin()。

QList<QTextOption::Tab> QTextBlockFormat::tabPositions() const

返回为该文本块定义的制表符位置列表。

另请参阅 setTabPositions()。

qreal QTextBlockFormat::textIndent() const

返回段落的文本缩进。

另请参阅 ` setTextIndent()`。

qreal QTextBlockFormat::topMargin() const

返回该段落的上边距。

另请参阅 setTopMargin() 和bottomMargin()。