QTextFrameFormat 类
QTextFrameFormat 类提供对 QTextDocument 中框架的格式信息的支持。更多信息...
头文件 | #include <QTextFrameFormat> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake | QT += gui |
继承自 | QTextFormat |
由以下类继承 |
- 包括继承成员在内的所有成员列表
- QTextFrameFormat 是丰富文本处理 API 的组成部分和 隐式共享类。
注意: 本类的所有函数都是可重入的。
公有类型
枚举 | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
枚举 | Position { InFlow, FloatLeft, FloatRight } |
公有函数
QTextFrameFormat() | |
qreal | border() const |
QBrush | borderBrush() const |
QTextFrameFormat::BorderStyle | borderStyle() const |
qreal | bottomMargin() const |
QTextLength | height() const |
bool | isValid() const |
qreal | leftMargin() const |
qreal | margin() const |
qreal | padding() const |
QTextFormat::PageBreakFlags | pageBreakPolicy() const |
QTextFrameFormat::Position | position() const |
qreal | rightMargin() const |
void | setBorder(qreal width) |
void | setBorderBrush(const QBrush &brush) |
void | setBorderStyle(QTextFrameFormat::BorderStyle style) |
void | setBottomMargin(qreal margin) |
void | setHeight(const QTextLength &height) |
void | setHeight(qreal height) |
void | setLeftMargin(qreal margin) |
void | setMargin(qreal margin) |
void | setPadding(qreal width) |
void | setPageBreakPolicy(QTextFormat::PageBreakFlags policy) |
void | setPosition(QTextFrameFormat::Position policy) |
void | setRightMargin(qreal margin) |
void | setTopMargin(qreal margin) |
void | setWidth(const QTextLength &width) |
void | setWidth(qreal 宽度) |
qreal | topMargin() const |
QTextLength | width() const |
详细描述
文本框架将一个或多个文本块组合在一起,提供比段落更大的层次结构。框架的格式指定其在屏幕上如何渲染和定位。它不直接指定内部文本格式化的行为,但提供对其子项布局的限制。
框架格式定义了框架在屏幕上的width() 和 height()。每个框架都可以有一个border(),其内容被矩形框包围。该边框周围有一个框架的margin(),框架的内容通过框架的padding()与边框分开。此方案类似于用于HTML页面的层叠样式表所使用的框模型。
框架的位置position()是通过setPosition()设定的,它决定了它相对于周围文本的位置。
可以用isValid()函数确定QTextFrameFormat对象的合法性。
另请参阅QTextFrame和QTextBlockFormat。
成员类型文档
枚举QTextFrameFormat::BorderStyle
此枚举描述了文本框架的不同边框样式。
常量 | 值 |
---|---|
QTextFrameFormat::BorderStyle_None | 0 |
QTextFrameFormat::BorderStyle_Dotted | 1 |
QTextFrameFormat::BorderStyle_Dashed | 2 |
QTextFrameFormat::BorderStyle_Solid | 3 |
QTextFrameFormat::BorderStyle_Double | 4 |
QTextFrameFormat::BorderStyle_DotDash | 5 |
QTextFrameFormat::BorderStyle_DotDotDash | 6 |
QTextFrameFormat::BorderStyle_Groove | 7 |
QTextFrameFormat::BorderStyle_Ridge | 8 |
QTextFrameFormat::BorderStyle_Inset | 9 |
QTextFrameFormat::BorderStyle_Outset | 10 |
另请参阅borderStyle()和FrameBorderStyle。
枚举QTextFrameFormat::Position
此枚举描述了框架相对于周围文本的位置。
常量 | 值 |
---|---|
QTextFrameFormat::InFlow | 0 |
QTextFrameFormat::FloatLeft | 1 |
QTextFrameFormat::FloatRight | 2 |
成员函数文档
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公司的商标。所有其他商标均为其所有者的财产。