QTextBlockFormat 类

成员函数文档

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(qreal scriptLineHeight, qreal scaling = 1.0) const

基于由scriptLineHeight给出的脚本行高和指定的缩放因子返回段落的行高。

返回的值也取决于段落的给定LineHeightType以及为段落设置的LineHeight设置。

缩放对于包括固定像素数的行高是必要的，以便适当地进行打印缩放。

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

qreal QTextBlockFormat::lineHeight() const

这返回段落的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。

void QTextBlockFormat::setBottomMargin(qreal margin)

设置段落的底部 页边距。

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

void QTextBlockFormat::setHeadingLevel(int level)

设置段落的标题 级别，其中 1 是最高级别标题类型（通常具有可能的最大标题字体大小），并且增加的值表示文档中更深入的级别（通常具有更小的字体大小）。例如，当读取 HTML 的 H1 标签时，标题级别设置为 1。设置标题级别不会自动更改字体大小；然而，QTextDocumentFragment::fromHtml() 同时设置标题级别和字体大小。

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

另请参阅 headingLevel。

void QTextBlockFormat::setIndent(int indentation)

设置段落的 缩进。使用 setLeftMargin() 和 setTextIndent() 独立于缩进设置页边距。缩进是一个整数，它乘以文档范围的标准缩进，从而得到段落的实际缩进。

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

void QTextBlockFormat::setLeftMargin(qreal 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 为 true，则段落的行被视为不可断行；否则，可以断行。

另请参阅 nonBreakableLines().

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

将段落的页面断页策略设置为 policy。

另请参阅 pageBreakPolicy().

void QTextBlockFormat::setRightMargin(qreal margin)

设置段落的右边距。

另请参阅 rightMargin()，setLeftMargin()，setTopMargin() 以及 setBottomMargin().

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

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

另请参阅 tabPositions().

void QTextBlockFormat::setTextIndent(qreal indent)

设置块中第一行的缩进。这允许段落的第—行与其他行缩进不同，从而提高文本的可读性。

另请参阅 textIndent()，setLeftMargin()，setRightMargin()，setTopMargin() 和 setBottomMargin()。

void QTextBlockFormat::setTopMargin(qreal margin)

设置段落的顶部缩进。

另请参阅 topMargin()，setBottomMargin()，setLeftMargin() 和 setRightMargin()。

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

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

另请参阅 setTabPositions()。

qreal QTextBlockFormat::textIndent() const

返回段落的文本缩进。

另请参阅 setTextIndent()。

qreal QTextBlockFormat::topMargin() const

返回段落的顶部边距。

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