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 给出的值，该值以LineHeightTypes 枚举描述的方式依赖于heightType 。

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

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

将应与段落一起呈现的装饰类型设置为marker 。例如，列表项可以用选中或未选中的复选框作为装饰，以替代其项目符号。默认值为NoMarker 。

另请参阅 marker() 。

void QTextBlockFormat::setNonBreakableLines(bool b)

如果b 为 true，则段落中的行被视为不可断开；否则为可断开。

另请参见 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()。