QTextFrame#

QTextFrame类表示一个QTextDocument中的框架。 更多...

Inheritance diagram of PySide6.QtGui.QTextFrame

继承自: QTextTable

概述#

方法#

注意

本说明文档可能包含自动从C++转换为Python的代码片段。我们始终欢迎使用对代码片段翻译的贡献。如果您发现翻译有问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建工单来告诉我们。

详细说明#

文本框架提供了一个文档中文本的结构。它们被用作其他文档元素的通用容器。框架通常通过使用insertFrame() 创建。

框架可以用于在丰富的文本文档中创建层次结构。每个文档都有一个根框架( rootFrame() ),根框架下方的每个框架都有一个父框架和一个(可能为空)子框架列表。可以使用parentFrame() 找到父框架,而childFrames() 函数提供了子框架的列表。

每个框架至少包含一个文本块,以便文本光标能够在其中插入新的文档元素。因此,使用iterator 类来遍历给定框架内的块和子框架。可以使用begin()end() 找到框架中的第一个和最后一个子元素。

框架还有格式(使用QTextFrameFormat 指定),可以使用setFormat() 设置并使用format() 读取。

可以使用指向框架内第一个和最后一个有效光标位置的光标;使用firstCursorPosition()lastCursorPosition() 函数来完成此操作。使用firstPosition()lastPosition() 可在文档中找到框架的范围。

您可以使用 iterator 类遍历框架的内容:这提供了对其内部文本块和子框架列表的只读访问。

另请参阅

QTextCursor QTextDocument

__init__(doc)#
参数:

docQTextDocument

为文本 document 创建一个新的空框架。

__iter__()#
返回类型:

对象

begin()#
返回类型:

迭代器

返回指向框架内第一个文档元素的迭代器。请参阅文档中有关 STL-style-Iterators 的更多信息。

另请参阅

end()

childFrames()#
返回类型:

.字面量为 QTextFrame

返回一个(可能为空)的子框架列表。

另请参阅

parentFrame()

end()#
返回类型:

迭代器

返回指向框架内最后一个文档元素之后位置的迭代器。请参阅有关 STL-Style Iterators 的文档以获取更多信息。

另请参阅

begin()

firstCursorPosition()#
返回类型:

QTextCursor

返回框架内的第一个光标位置。

firstPosition()#
返回类型:

int

返回框架内的第一个文档位置。

frameFormat()#
返回类型:

QTextFrameFormat

返回框架的格式。

另请参阅

setFrameFormat()

lastCursorPosition()#
返回类型:

QTextCursor

返回框架内的最后一个光标位置。

lastPosition()#
返回类型:

int

返回框架内部的最后文档位置。

parentFrame()#
返回类型:

QTextFrame

返回框架的父框架。如果框架是文档的根框架,则返回0。

另请参阅

childFrames() rootFrame()

setFrameFormat(format)#
参数:

formatQTextFrameFormat

设置框架的格式。

另请参阅

frameFormat()