QTextFrameFormat Class

QTextFrameFormat 类为QTextDocument 中的框架提供格式化信息 ... 更多...

头文件: #include <QTextFrameFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
继承: QTextFormat
继承于:

QTextTableFormat

注意:该类中的所有函数都是可重入的

公共类型

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() 函数确定。

另请参阅 QTextFrameQTextBlockFormat

成员类型文档

enum 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

enum 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()。

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.