QTextFrameFormat 类

QTextFrameFormat 类提供对 QTextDocument 中框架的格式信息的支持。更多信息...

头文件 #include <QTextFrameFormat>
CMakefind_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmakeQT += gui
继承自 QTextFormat
由以下类继承

QTextTableFormat

注意: 本类的所有函数都是可重入的。

公有类型

枚举BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset }
枚举Position { InFlow, FloatLeft, FloatRight }

公有函数

QTextFrameFormat()
qrealborder() const
QBrushborderBrush() const
QTextFrameFormat::BorderStyleborderStyle() const
qrealbottomMargin() const
QTextLengthheight() const
boolisValid() const
qrealleftMargin() const
qrealmargin() const
qrealpadding() const
QTextFormat::PageBreakFlagspageBreakPolicy() const
QTextFrameFormat::Positionposition() const
qrealrightMargin() const
voidsetBorder(qreal width)
voidsetBorderBrush(const QBrush &brush)
voidsetBorderStyle(QTextFrameFormat::BorderStyle style)
voidsetBottomMargin(qreal margin)
voidsetHeight(const QTextLength &height)
voidsetHeight(qreal height)
voidsetLeftMargin(qreal margin)
voidsetMargin(qreal margin)
voidsetPadding(qreal width)
voidsetPageBreakPolicy(QTextFormat::PageBreakFlags policy)
voidsetPosition(QTextFrameFormat::Position policy)
voidsetRightMargin(qreal margin)
voidsetTopMargin(qreal margin)
voidsetWidth(const QTextLength &width)
voidsetWidth(qreal 宽度)
qrealtopMargin() const
QTextLengthwidth() const

详细描述

文本框架将一个或多个文本块组合在一起,提供比段落更大的层次结构。框架的格式指定其在屏幕上如何渲染和定位。它不直接指定内部文本格式化的行为,但提供对其子项布局的限制。

框架格式定义了框架在屏幕上的width() 和 height()。每个框架都可以有一个border(),其内容被矩形框包围。该边框周围有一个框架的margin(),框架的内容通过框架的padding()与边框分开。此方案类似于用于HTML页面的层叠样式表所使用的框模型。

框架的位置position()是通过setPosition()设定的,它决定了它相对于周围文本的位置。

可以用isValid()函数确定QTextFrameFormat对象的合法性。

另请参阅QTextFrameQTextBlockFormat

成员类型文档

枚举QTextFrameFormat::BorderStyle

此枚举描述了文本框架的不同边框样式。

常量
QTextFrameFormat::BorderStyle_None0
QTextFrameFormat::BorderStyle_Dotted1
QTextFrameFormat::BorderStyle_Dashed2
QTextFrameFormat::BorderStyle_Solid3
QTextFrameFormat::BorderStyle_Double4
QTextFrameFormat::BorderStyle_DotDash5
QTextFrameFormat::BorderStyle_DotDotDash6
QTextFrameFormat::BorderStyle_Groove7
QTextFrameFormat::BorderStyle_Ridge8
QTextFrameFormat::BorderStyle_Inset9
QTextFrameFormat::BorderStyle_Outset10

另请参阅borderStyle()和FrameBorderStyle

枚举QTextFrameFormat::Position

此枚举描述了框架相对于周围文本的位置。

常量
QTextFrameFormat::InFlow0
QTextFrameFormat::FloatLeft1
QTextFrameFormat::FloatRight2

另请参阅position()和CssFloat

成员函数文档

QTextFrameFormat::QTextFrameFormat()

使用默认属性构建文本框架格式对象。

qreal QTextFrameFormat::border() const

返回边框的像素宽度。

另请参阅setBorder

QBrush QTextFrameFormat::borderBrush() const

返回用于框架边框的画笔。

另请参阅setBorderBrush

QTextFrameFormat::BorderStyle QTextFrameFormat::borderStyle() const

返回框架边框的样式。

另请参阅setBorderStyle

qreal QTextFrameFormat::bottomMargin() const

返回框架底部边距的像素宽度。

参见setBottomMargin().

QTextLength QTextFrameFormat::height() const

返回框架边框矩形的长度。

参见setHeight().

bool QTextFrameFormat::isValid() const

如果格式描述有效,则返回 true;否则返回 false

qreal QTextFrameFormat::leftMargin() const

返回框架左侧边距的像素宽度。

参见setLeftMargin().

QTextLength QTextFrameFormat::margin() const

返回框架外部边距的像素宽度。

参见setMargin().

qreal QTextFrameFormat::padding() const

返回框架内部填充的像素宽度。

参见setPadding().

QTextFormat::PageBreakFlags QTextFrameFormat::pageBreakPolicy() const

返回框架/表格设置的分页策略。默认为 QTextFormat::PageBreak_Auto

参见setPageBreakPolicy().

QTextFrameFormat::Position QTextFrameFormat::position() const

返回此框架格式的框架定位策略。

参见setPosition().

qreal QTextFrameFormat::rightMargin() const

返回框架右侧边距的像素宽度。

参见setRightMargin().

void QTextFrameFormat::setBorder(qreal width)

设置框架边框的宽度(以像素为单位)。

参见border().

void QTextFrameFormat::setBorderBrush(const QBrush &brush)

设置用于框架边框的 刷子

参见borderBrush().

void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)

设置框架边框的 样式

参见borderStyle().

void QTextFrameFormat::setBottomMargin(qreal margin)

以像素为单位设置框架的底部 边距

参见bottomMargin().

void QTextFrameFormat::setHeight(const QTextLength = &height)

设置框架的高度。

另请参阅height()。

void QTextFrameFormat::setHeight(qreal height)

这是一个重载函数。

设置框架的高度。

void QTextFrameFormat::setLeftMargin(qreal margin)

以像素为单位设置框架的左边界。

另请参阅leftMargin()。

void QTextFrameFormat::setMargin(qreal margin)

以像素为单位设置框架的边界。此方法还将框架的左、右、上和下边界设置为相同的值。个别边界将覆盖普通边界。

另请参阅margin()。

void QTextFrameFormat::setPadding(qreal width)

以像素为单位设置框架内部边距的宽度。

另请参阅padding()。

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

将框架/表格的页面分页策略设置为策略

另请参阅pageBreakPolicy()。

void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)

为此框架格式设置定位框架的政策

另请参阅position()。

void QTextFrameFormat::setRightMargin(qreal margin)

以像素为单位设置框架的右边界。

另请参阅rightMargin()。

void QTextFrameFormat::setTopMargin(qreal margin)

以像素为单位设置框架的上边界。

另请参阅topMargin()。

void QTextFrameFormat::setWidth(const QTextLength = &width)

设置框架边框矩形的宽度

另请参阅width() 和 QTextLength

void QTextFrameFormat::setWidth(qreal width)

这是一个重载函数。

这是一个方便方法,用于将框架边框矩形的宽度设置为指定的固定宽度

qreal QTextFrameFormat::topMargin() const

返回框架顶部边距的像素宽度。

另请参阅 setTopMargin()。

QTextLength QTextFrameFormat::width() const

返回框架边框矩形的宽度。

另请参阅 setWidth() 和 QTextLength

© 2024 Qt公司有限公司。本文档中的文档贡献是各自所有者的版权。本提供的文档根据自由软件基金会发布的 GNU自由文档许可证版本1.3 的条款进行许可。Qt和相应的标志是芬兰以及/或其他国家/地区的Qt公司的商标。所有其他商标均为其所有者的财产。