QTextFrame Class
QTextFrame 类表示QTextDocument 中的一个框架。更多内容...
| 头文件： | #include <QTextFrame> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
| 继承自： | QTextObject |
| 被继承： |
- 所有成员列表（包括继承的成员）
- QTextFrame 属于富文本处理 API。
注意：该类中的所有函数均为可重入的。
公共类型
公共函数
| QTextFrame(QTextDocument *document) | |
| virtual | ~QTextFrame() |
| QTextFrame::iterator | begin() const |
| QList<QTextFrame *> | childFrames() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| int | firstPosition() const |
| QTextFrameFormat | frameFormat() const |
| QTextCursor | lastCursorPosition() const |
| int | lastPosition() const |
| QTextFrame * | parentFrame() const |
| void | setFrameFormat(const QTextFrameFormat &format) |
详细说明
文本框为文档中的文本提供了结构。它们用作其他文档元素的通用容器。文本框通常通过调用QTextCursor::insertFrame() 来创建。
可以通过框架在富文本文档中创建层次结构。每个文档都有一个根框架（QTextDocument::rootFrame()），根框架下的每个框架都有一个父框架和一个（可能为空的）子框架列表。可以通过parentFrame()查找父框架，而childFrames()函数则提供子框架列表。
每个帧至少包含一个文本块，以便文本光标能在其中插入新的文档元素。因此，QTextFrame::iterator 类用于遍历给定帧内的文本块和子帧。可通过begin() 和end() 获取帧中的第一个和最后一个子元素。
帧还具有一种格式（使用 `QTextFrameFormat` 指定），可通过 `setFormat()` 进行设置，并通过 `format()` 读取。
可以获取指向帧内第一个和最后一个有效光标位置的文本光标；为此请使用firstCursorPosition() 和lastCursorPosition() 函数。帧在文档中的范围可通过firstPosition() 和lastPosition() 获取。
您可以使用QTextFrame::iterator 类遍历帧的内容：该类提供对其内部文本块和子帧列表的只读访问权限。
另请参阅 QTextCursor 和QTextDocument 。
成员函数文档
[explicit] QTextFrame::QTextFrame(QTextDocument *document)
为文本“document ”创建一个新的空帧。
[virtual noexcept] QTextFrame::~QTextFrame()
删除文本框。
警告：文本 框属于文档，因此切勿自行将其删除。若要从文档中移除某个文本框，请使用QTextCursor 方法清除其内容。
QTextFrame::iterator QTextFrame::begin() const
返回一个指向帧内第一个文档元素的迭代器。更多信息请参阅文档《STL 风格迭代器》。
另请参阅 end()。
QList<QTextFrame *> QTextFrame::childFrames() const
返回一个包含该帧子帧的列表（该列表可能为空）。
另请参阅 parentFrame()。
QTextFrame::iterator QTextFrame::end() const
返回一个迭代器，该迭代器指向帧内最后一个文档元素之后的位置。更多信息请参阅文档《STL 风格迭代器》。
另请参阅 begin()。
QTextCursor QTextFrame::firstCursorPosition() const
返回帧内的第一个光标位置。
另请参阅 lastCursorPosition()、firstPosition() 和lastPosition()。
int QTextFrame::firstPosition() const
返回框架内的第一个文档位置。
另请参阅 lastPosition()、firstCursorPosition() 和lastCursorPosition()。
QTextFrameFormat QTextFrame::frameFormat() const
返回帧的格式。
另请参阅 setFrameFormat()。
QTextCursor QTextFrame::lastCursorPosition() const
返回帧内的最后一个光标位置。
另请参阅 firstCursorPosition()、firstPosition()，以及lastPosition()。
int QTextFrame::lastPosition() const
返回框架内的最后一个文档位置。
另请参阅 firstPosition()、firstCursorPosition() 和lastCursorPosition()。
QTextFrame *QTextFrame::parentFrame() const
返回该框架的父框架。如果该框架是文档的根框架，则返回 0。
另请参阅 childFrames() 和QTextDocument::rootFrame()。
void QTextFrame::setFrameFormat(const QTextFrameFormat &format)
设置画面的format 。
另请参阅 frameFormat()。
© 2026 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.
