class QTextDocumentFragment#

QTextDocumentFragment 类表示来自 QTextDocument 的格式化文本。 更多…

概要#

方法#

静态函数#

注意

本文档可能包含自动从 C++ 转换到 Python 的代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译存在问题，您也可以在 https:/bugreports.qt.io/projects/PYSIDE 上创建一个工单来告知我们。

详细描述#

一个 QTextDocumentFragment 是一个富文本片段，可以插入到 QTextDocument 中。一个文档片段可以从 QTextDocument 创建，从一个 QTextCursor 的选择或另一个文档片段创建。文档片段也可以通过静态函数 fromPlainText() 和 fromHtml() 创建。

可以使用 toRawText() 函数获取文档片段的内容作为原始文本，通过 toPlainText() 作为ASCII文本，通过 toHtml() 作为HTML文本，或者通过 toMarkdown() 作为Markdown文本。

__init__()#

构建一个空的 QTextDocumentFragment 。

另请参阅

isEmpty()

__init__(range)
参数:

range – QTextCursor

从光标的当前选择创建一个 QTextDocumentFragment 。如果光标没有选择，则创建的片段是空的。

另请参阅

isEmpty() selection()

__init__(document)
参数:

document – QTextDocument

将给定的 document 转换为 QTextDocumentFragment . 注意到，QTextDocumentFragment 只存储文档内容，不存储诸如文档的标题等元信息。

__init__(rhs)
参数:

rhs – QTextDocumentFragment

复制构造函数。创建其他片段的副本。

static fromHtml(html[, resourceProvider=None])#
参数:
返回类型:

QTextDocumentFragment

返回一个基于给定 text 中的任意 HTML 片段的 QTextDocumentFragment 。格式尽可能保留；例如，“<b>bold</b>” 将成为一个包含文本 “bold” 且具有加粗字符格式的文档片段。

如果提供的 HTML 包含对如导入样式表的外部资源的引用，则将通过 resourceProvider 加载。

static fromMarkdown(markdown[, features=QTextDocument.MarkdownDialectGitHub])#
参数:
返回类型:

QTextDocumentFragment

返回类型:

返回一个基于指定 features 的给定 markdown 文本创建的 QTextDocumentFragment 。默认为 GitHub 方言。

注意

不支持加载外部资源。

static fromPlainText(plainText)#
参数:

plainText – str

返回类型:

QTextDocumentFragment

返回包含给定 plainText 的文档片段。

当将此片段插入到QTextDocument时，使用于插入的QTextCursor的当前字符格式用作文本的格式。

isEmpty()#
返回类型:

bool

如果片段为空，则返回true；否则返回false。

toHtml()#
返回类型:

str

以HTML格式返回文档片段的内容。

toMarkdown([features=QTextDocument.MarkdownDialectGitHub])#
参数:

features – MarkdownFeature 的组合

返回类型:

str

返回以Markdown格式表示的内容，带有指定的features。默认为GitHub方言。

toPlainText()#
返回类型:

str

该函数返回的内容与toRawText()相同，但会将某些Unicode字符替换为ASCII等价物。特别是，不间断空格（U+00A0）被替换为常规空格（U+0020），而段落（U+2029）和行（U+2028）分隔符都被替换为换行符（U+000A）。如果您需要文档的精确内容，请改用toRawText()。

toRawText()#
返回类型:

str

以原始文本形式返回文档片段的文本（即不带格式信息）。