QTextFrameFormat Class
QTextFrameFormat 类为QTextDocument 中的框架提供格式化信息 ... 更多...
头文件: | #include <QTextFrameFormat> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
继承: | QTextFormat |
继承于: |
- 所有成员的列表,包括继承成员
- QTextFrameFormat 属于富文本处理 API和隐式共享类。
注意:该类中的所有函数都是可重入的。
公共类型
enum | BorderStyle { BorderStyle_None, BorderStyle_Dotted, BorderStyle_Dashed, BorderStyle_Solid, BorderStyle_Double, …, BorderStyle_Outset } |
enum | 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 width) |
qreal | topMargin() const |
QTextLength | width() const |
详细说明
文本框将一个或多个文本块组合在一起,提供比段落更大的结构层。文本框的格式指定了它在屏幕上的呈现和定位方式。它并不直接指定其中文本格式的行为,而是为其子帧的布局提供约束。
框架格式定义了框架在屏幕上的width() 和height() 。每个框架都可以有一个border() 用矩形框包围其内容。边框由围绕框架的margin() 包围,而框架的内容则通过框架的padding() 与边框分开。这种方案类似于层叠样式表用于 HTML 页面的框模型。
框架的position() 是通过setPosition() 设置的,它决定了框架相对于周围文本的位置。
QTextFrameFormat 对象的有效性可通过isValid() 函数确定。
另请参阅 QTextFrame 和QTextBlockFormat 。
成员类型文档
enum 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 。
enum 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()。
qreal 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)
设置边框的width (像素)。
另请参阅 border().
void QTextFrameFormat::setBorderBrush(const QBrush &brush)
设置用于边框的brush 。
另请参阅 borderBrush()。
void QTextFrameFormat::setBorderStyle(QTextFrameFormat::BorderStyle style)
设置边框的style 。
另请参阅 borderStyle()。
void QTextFrameFormat::setBottomMargin(qreal margin)
设置边框的底部margin (单位:像素)。
另请参阅 bottomMargin().
void QTextFrameFormat::setHeight(const QTextLength &height)
设置帧的height 。
另请参阅 height() 。
void QTextFrameFormat::setHeight(qreal height)
这是一个重载函数。
设置帧的height 。
void QTextFrameFormat::setLeftMargin(qreal margin)
设置帧的左margin ,单位为像素。
另请参阅 leftMargin().
void QTextFrameFormat::setMargin(qreal margin)
设置边框的margin (单位:像素)。此方法还会将边框的左、右、上和下边框设置为相同的值。单个边距覆盖总边距。
另请参阅 margin()。
void QTextFrameFormat::setPadding(qreal width)
设置width 帧内部填充的像素数。
另请参阅 padding()。
void QTextFrameFormat::setPageBreakPolicy(QTextFormat::PageBreakFlags policy)
将帧/表的分页符策略设置为policy 。
另请参阅 pageBreakPolicy() 。
void QTextFrameFormat::setPosition(QTextFrameFormat::Position policy)
设置policy ,用于定位该帧格式的帧。
另请参阅 position()。
void QTextFrameFormat::setRightMargin(qreal margin)
设置帧的右margin ,单位为像素。
另请参阅 rightMargin().
void QTextFrameFormat::setTopMargin(qreal margin)
设置边框的顶部margin (单位:像素)。
另请参阅 topMargin().
void QTextFrameFormat::setWidth(const QTextLength &width)
设置边框矩形的width 。
另请参阅 width() 和QTextLength 。
void QTextFrameFormat::setWidth(qreal width)
这是一个重载函数。
方便方法,用于将边框矩形的宽度设置为指定的固定值width 。
qreal QTextFrameFormat::topMargin() const
以像素为单位返回框架顶边的宽度。
另请参阅 setTopMargin()。
QTextLength QTextFrameFormat::width() const
返回边框矩形的宽度。
另请参阅 setWidth() 和QTextLength 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.