PySide6.QtWidgets.QTextEdit

class QTextEdit

QTextEdit 类提供了一个用于编辑和显示纯文本和富文本的小部件。More_…

PySide6.QtWidgets.QTextEdit 的继承图

继承者： QTextBrowser

概要

属性

方法

虚拟方法

插槽

信号

注意

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

详细描述

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

介绍与概念

QTextEdit 是一个高级的所见即所得查看器/编辑器，支持使用HTML样式标签或Markdown格式进行富文本格式化。它经过优化，可以处理大型文档并快速响应用户输入。

QTextEdit 处理段落和字符。段落是一个格式化的字符串，它会自动换行以适应小部件的宽度。默认情况下，在读取纯文本时，一个换行符表示一个段落。文档由零个或多个段落组成。段落中的单词根据段落的对齐方式对齐。段落之间通过硬换行符分隔。段落中的每个字符都有其自己的属性，例如字体和颜色。

QTextEdit 可以显示图像、列表和表格。如果文本太大，无法在文本编辑器的视口中查看，将会出现滚动条。文本编辑器可以加载纯文本和富文本文件。富文本可以使用HTML 4标记的子集来描述；有关更多信息，请参阅支持的HTML子集页面。

如果你只需要显示一小段富文本，请使用QLabel。

Qt中的富文本支持旨在提供一种快速、可移植且高效的方式，为应用程序添加合理的在线帮助功能，并为富文本编辑器提供基础。如果您发现HTML支持不足以满足您的需求，您可以考虑使用Qt WebKit，它提供了一个功能齐全的网页浏览器小部件。

鼠标光标在QTextEdit上的形状默认是Qt::IBeamCursor。可以通过viewport()的光标属性来更改。

使用QTextEdit作为显示部件

QTextEdit 可以显示大量的HTML子集，包括表格和图像。

可以使用setHtml()来设置或替换文本，这将删除任何现有文本并将其替换为setHtml()调用中传入的文本。如果你使用遗留的HTML调用setHtml()，然后调用toHtml()，返回的文本可能会有不同的标记，但渲染效果相同。可以使用clear()删除整个文本。

文本也可以使用setMarkdown()来设置或替换，同样的注意事项适用：如果你随后调用toMarkdown()，返回的文本可能会有所不同，但意义尽可能保持不变。可以解析包含一些嵌入HTML的Markdown，具有与setHtml()相同的限制；但toMarkdown()只写入“纯”Markdown，不包含任何嵌入的HTML。

文本本身可以使用QTextCursor类或使用便捷函数insertHtml()、insertPlainText()、append()或paste()插入。QTextCursor还能够将复杂对象（如表格或列表）插入到文档中，并且它处理创建选择和应用对选定文本的更改。

默认情况下，文本编辑器会在空白处换行以适应文本编辑小部件。setLineWrapMode() 函数用于指定你想要的换行方式，或者如果你不希望任何换行，可以使用 NoWrap。调用 setLineWrapMode() 来设置固定的像素宽度 FixedPixelWidth，或者字符列（例如80列）FixedColumnWidth，并使用 setLineWrapColumnOrWidth() 指定像素或列。如果你使用小部件宽度的自动换行 WidgetWidth，你可以通过 setWordWrapMode() 指定是否在空白处或任意位置换行。

find() 函数可用于在文本中查找并选择给定的字符串。

如果你想限制QTextEdit中的段落总数，例如这在日志查看器中通常很有用，那么你可以使用QTextDocument的maximumBlockCount属性来实现。

只读键绑定

当QTextEdit以只读方式使用时，键绑定仅限于导航，且文本只能通过鼠标选择：

按键

操作

上

向上移动一行。

向下

向下移动一行。

左

向左移动一个字符。

右

向右移动一个字符。

PageUp

向上移动一个（视口）页面。

PageDown

向下移动一个（视口）页面。

首页

移动到文本的开头。

结束

移动到文本的末尾。

Alt+滚轮

水平滚动页面（滚轮是鼠标滚轮）。

Ctrl+滚轮

缩放文本。

Ctrl+A

选择所有文本。

文本编辑器可能能够提供一些元信息。例如，documentTitle() 函数将返回 HTML 标签内的文本。

注意

只有在字体大小未设置为固定大小时，才能对HTML文档进行缩放。

使用QTextEdit作为编辑器

所有关于使用QTextEdit作为显示小部件的信息也适用于此处。

当前字符格式的属性通过setFontItalic()、setFontWeight()、setFontUnderline()、setFontFamily()、setFontPointSize()、setTextColor()和setCurrentFont()设置。当前段落的对齐方式通过setAlignment()设置。

文本的选择由QTextCursor类处理，该类提供了创建选择、检索文本内容或删除选择的功能。您可以使用textCursor()方法检索与用户可见光标对应的对象。如果您想在QTextEdit中设置选择，只需在QTextCursor对象上创建一个选择，然后使用setTextCursor()将该光标设置为可见光标。选择可以通过copy()复制到剪贴板，或通过cut()剪切到剪贴板。可以使用selectAll()选择整个文本。

当光标移动并且底层的格式化属性发生变化时，会发出currentCharFormatChanged()信号，以反映新光标位置的新属性。

每当文本发生变化时（由于setText()或通过编辑器本身），textChanged()信号就会被发出。

QTextEdit 持有一个 QTextDocument 对象，可以使用 document() 方法获取。你也可以使用 setDocument() 设置你自己的文档对象。

QTextDocument 提供了一个 isModified() 函数，如果文本自加载以来或自上次调用 setModified 并将 false 作为参数以来已被修改，则该函数将返回 true。此外，它还提供了撤销和重做的方法。

拖放

QTextEdit 还支持自定义拖放行为。默认情况下，QTextEdit 会在用户将数据拖放到文档上时插入纯文本、HTML 和富文本。重新实现 canInsertFromMimeData() 和 insertFromMimeData() 以添加对其他 MIME 类型的支持。

例如，为了允许用户将图像拖放到QTextEdit上，你可以以下列方式实现这些函数：

def canInsertFromMimeData(self, QMimeData source ):

    if source.hasImage():
        return True
else:
        return QTextEdit.canInsertFromMimeData(source)

我们通过返回true来添加对图像MIME类型的支持。对于所有其他MIME类型，我们使用默认实现。

def insertFromMimeData(self, source):

    if source.hasImage():

        image = QImage(source.imageData())
        cursor = self.textCursor()
        document = self.document()
        document.addResource(QTextDocument.ImageResource, QUrl("image"), image)
        cursor.insertImage("image")

我们从MIME源持有的QVariant中解包图像，并将其作为资源插入到文档中。

编辑键绑定

用于编辑的快捷键绑定列表：

按键

操作

退格键

删除光标左侧的字符。

删除

删除光标右侧的字符。

Ctrl+C

将选定的文本复制到剪贴板。

Ctrl+Insert

将选定的文本复制到剪贴板。

Ctrl+K

删除到行尾。

Ctrl+V

将剪贴板文本粘贴到文本编辑器中。

Shift+Insert

将剪贴板文本粘贴到文本编辑中。

Ctrl+X

删除选定的文本并将其复制到剪贴板。

Shift+Delete

删除选定的文本并将其复制到剪贴板。

Ctrl+Z

撤销上一次操作。

Ctrl+Y

重做上一个操作。

左

将光标向左移动一个字符。

Ctrl+左键

将光标向左移动一个单词。

右

将光标向右移动一个字符。

Ctrl+右箭头

将光标向右移动一个单词。

上

将光标向上移动一行。

向下

将光标向下移动一行。

PageUp

将光标向上移动一页。

PageDown

将光标向下移动一页。

首页

将光标移动到行的开头。

Ctrl+Home

将光标移动到文本的开头。

结束

将光标移动到行尾。

Ctrl+End

将光标移动到文本的末尾。

Alt+滚轮

水平滚动页面（滚轮是鼠标滚轮）。

要选择（标记）文本，请在按住Shift键的同时按下一个移动键，例如，Shift+Right将选择右侧的字符，Shift+Ctrl+Right将选择右侧的单词，等等。

另请参阅

语法高亮示例 Rich Text Processing

class LineWrapMode

常量

描述

QTextEdit.NoWrap

QTextEdit.WidgetWidth

QTextEdit.FixedPixelWidth

QTextEdit.FixedColumnWidth
class AutoFormattingFlag

常量

描述

QTextEdit.AutoNone

(继承自 enum.Flag) 不进行任何自动格式化。

QTextEdit.AutoBulletList

自动创建项目符号列表（例如，当用户在最左侧列输入星号（'*'），或在现有列表项中按下Enter键时）。

QTextEdit.AutoAll

应用所有自动格式化。目前仅支持自动项目符号列表。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property acceptRichTextᅟ: bool

此属性表示文本编辑是否接受用户插入的富文本。

当此属性设置为false时，文本编辑将仅接受用户的纯文本输入。例如通过剪贴板或拖放。

此属性的默认值为 true。

Access functions:
property autoFormattingᅟ: Combination of QTextEdit.AutoFormattingFlag

此属性保存启用的自动格式化功能集。

该值可以是AutoFormattingFlag枚举中值的任意组合。默认值为AutoNone。选择AutoAll以启用所有自动格式化。

目前，提供的唯一自动格式化功能是AutoBulletList；未来版本的Qt可能会提供更多功能。

Access functions:
property cursorWidthᅟ: int

此属性指定光标的宽度（以像素为单位）。默认值为1。

Access functions:
property documentᅟ: QTextDocument

此属性保存文本编辑器的基础文档。

注意

编辑器不会拥有文档的所有权，除非它是文档的父对象。提供的文档的父对象仍然是该对象的所有者。如果之前分配的文档是编辑器的子对象，那么它将被删除。

Access functions:
property documentTitleᅟ: str

此属性保存从文本解析出的文档标题。

默认情况下，对于新创建的空白文档，此属性包含一个空字符串。

Access functions:
property htmlᅟ: str

此属性为文本编辑的文本提供了一个HTML接口。

toHtml() 返回文本编辑器的文本内容为 HTML 格式。

setHtml() 更改文本编辑器的文本。任何先前的文本都会被移除，并且撤销/重做历史记录会被清除。输入的文本会被解释为HTML格式的富文本。currentCharFormat() 也会被重置，除非 textCursor() 已经在文档的开头。

注意

调用者有责任确保在创建包含HTML的QString并将其传递给setHtml()时，文本被正确解码。

默认情况下，对于新创建的空白文档，此属性包含描述没有正文文本的HTML 4.0文档的文本。

另请参阅

plainText

Access functions:
property lineWrapColumnOrWidthᅟ: int

此属性保存文本将换行的位置（以像素或列为单位，取决于换行模式）。

如果换行模式是FixedPixelWidth，则该值是从文本编辑的左侧边缘开始，文本应该换行的像素数。如果换行模式是FixedColumnWidth，则该值是从文本编辑的左侧边缘开始，文本应该换行的列号（以字符列计）。

默认情况下，此属性包含的值为0。

另请参阅

lineWrapMode

Access functions:
property lineWrapModeᅟ: QTextEdit.LineWrapMode

此属性保存行换行模式。

默认模式是WidgetWidth，这会导致文本在文本编辑的右边缘换行。换行发生在空白处，保持整个单词完整。如果你希望在单词内换行，请使用setWordWrapMode()。如果你设置了FixedPixelWidth或FixedColumnWidth的换行模式，你还应该调用setLineWrapColumnOrWidth()并指定你想要的宽度。

另请参阅

lineWrapColumnOrWidth

Access functions:
property markdownᅟ: str

此属性为文本编辑的文本提供了一个Markdown接口。

toMarkdown() 返回文本编辑器的文本为“纯”Markdown，不包含任何嵌入的HTML格式。QTextDocument支持的一些功能（例如使用特定颜色和命名字体）无法在“纯”Markdown中表达，它们将被省略。

setMarkdown() 更改文本编辑器的文本。任何先前的文本将被移除，并且撤销/重做历史记录将被清除。输入的文本将被解释为Markdown格式的富文本。

包含在markdown字符串中的HTML解析方式与setHtml中的处理方式相同；但是，不支持HTML块内的Markdown格式。

解析器的一些功能可以通过 features 参数启用或禁用：

  • Markdown无HTML

  • Markdown 文本中的任何 HTML 标签都将被丢弃

默认是 MarkdownDialectGitHub。

另请参阅

plainText html setMarkdown()

Access functions:
property overwriteModeᅟ: bool

此属性决定用户输入的文本是否会覆盖现有文本。

与许多文本编辑器一样，文本编辑器小部件可以配置为插入或覆盖现有文本，使用户输入的新文本。

如果此属性为true，则现有文本将被新文本逐字符覆盖；否则，文本将插入到光标位置，替换现有文本。

默认情况下，此属性为 false（新文本不会覆盖现有文本）。

Access functions:
property placeholderTextᅟ: str

此属性保存编辑器占位符文本。

设置此属性会使编辑器在document()为空时显示灰色的占位符文本。

默认情况下，此属性包含一个空字符串。

另请参阅

document()

Access functions:
property plainTextᅟ: str

此属性以纯文本形式保存文本编辑器的内容。

当属性被设置时，之前的内容将被移除，并且撤销/重做历史将被重置。currentCharFormat() 也会被重置，除非 textCursor() 已经在文档的开头。

如果文本编辑具有其他内容类型，调用toPlainText()时，它不会被纯文本替换。唯一的例外是不间断空格，nbsp;，它将被转换为标准空格。

默认情况下，对于没有内容的编辑器，此属性包含一个空字符串。

另请参阅

html

Access functions:
property readOnlyᅟ: bool

此属性表示文本编辑是否为只读。

在只读文本编辑中，用户只能浏览文本并选择文本；无法修改文本。

此属性的默认值为 false。

Access functions:
property tabChangesFocusᅟ: bool

此属性决定Tab键是用于改变焦点还是作为输入接受。

在某些情况下，文本编辑不应允许用户输入制表符或使用Tab键更改缩进，因为这会破坏焦点链。默认值为false。

Access functions:
property tabStopDistanceᅟ: float

此属性以像素为单位保存制表位距离。

默认情况下，此属性包含80像素的值。

不要设置小于QChar::VisualTabCharacter字符的horizontalAdvance()的值，否则制表符将无法完整绘制。

另请参阅

defaultTextOption

Access functions:
property textInteractionFlagsᅟ: Combination of Qt.TextInteractionFlag

指定小部件应如何与用户输入交互。

默认值取决于QTextEdit是只读还是可编辑的，以及它是否是QTextBrowser。

Access functions:
property undoRedoEnabledᅟ: bool

此属性用于确定是否启用撤销和重做功能。

只有当此属性为true，并且存在可以撤销（或重做）的操作时，用户才能撤销或重做操作。

Access functions:
__init__([parent=None])
Parameters:

父级 – QWidget

构造一个带有父级 parent 的空 QTextEdit。

__init__(text[, parent=None])
Parameters:

  • 文本 – str

  • parent – QWidget

使用父对象 parent 构造一个 QTextEdit。文本编辑器将显示文本 text。该文本被解释为 html。

acceptRichText()
Return type:

布尔

另请参阅

setAcceptRichText()

属性 acceptRichTextᅟ 的获取器。

alignment()
Return type:

AlignmentFlag 的组合

返回当前段落的对齐方式。

另请参阅

setAlignment()

anchorAt(pos)
Parameters:

pos – QPoint

Return type:

字符串

返回位置 pos 处的锚点引用，如果该位置没有锚点，则返回空字符串。

append(text)
Parameters:

文本 – str

在文本编辑器的末尾追加一个带有text的新段落。

注意

新添加的段落将具有与当前段落相同的字符格式和块格式，这由光标的位置决定。

另请参阅

currentCharFormat() blockFormat()

autoFormatting()
Return type:

AutoFormattingFlag 的组合

另请参阅

setAutoFormatting()

属性 autoFormattingᅟ 的获取器。

canInsertFromMimeData(source)
Parameters:

来源 – QMimeData

Return type:

布尔

如果由source指定的MIME数据对象的内容可以被解码并插入到文档中，此函数将返回true。例如，在拖放操作期间，当鼠标进入此小部件时，会调用此函数以确定是否可以接受拖放操作。

重新实现此函数以启用对额外MIME类型的拖放支持。

canPaste()
Return type:

布尔

返回是否可以从剪贴板粘贴文本到文本编辑器中。

clear()

删除文本编辑中的所有文本。

备注：

另请参阅

cut() setPlainText() setHtml()

copy()

将任何选定的文本复制到剪贴板。

另请参阅

copyAvailable()

copyAvailable(b)
Parameters:

b – 布尔值

当在文本编辑中选择或取消选择文本时，会发出此信号。

当文本被选中时，此信号将发出，yes 设置为 true。如果没有文本被选中或选中的文本被取消选中，此信号将发出，yes 设置为 false。

如果 yes 为真，则可以使用 copy() 将选择内容复制到剪贴板。如果 yes 为假，则 copy() 不执行任何操作。

另请参阅

selectionChanged()

createMimeDataFromSelection()
Return type:

QMimeData

此函数返回一个新的MIME数据对象，以表示文本编辑当前选择的内容。当需要将选择封装到新的QMimeData对象时调用此函数；例如，当开始拖放操作或将数据复制到剪贴板时。

如果你重新实现这个函数，请注意返回的QMimeData对象的所有权将传递给调用者。可以通过使用textCursor()函数来检索选择。

createStandardContextMenu()
Return type:

QMenu

此函数创建标准上下文菜单，当用户右键单击文本编辑时显示。它从默认的contextMenuEvent()处理程序调用。弹出菜单的所有权转移给调用者。

我们建议您使用createStandardContextMenu(QPoint)版本，该版本将启用对用户点击位置敏感的操作。

createStandardContextMenu(position)
Parameters:

位置 – QPoint

Return type:

QMenu

此函数创建标准上下文菜单，当用户右键单击文本编辑时显示。它从默认的contextMenuEvent()处理程序调用，并接受文档坐标中的position，即鼠标点击的位置。这可以启用对用户点击位置敏感的操作。弹出菜单的所有权转移给调用者。

currentCharFormat()
Return type:

QTextCharFormat

返回插入新文本时使用的字符格式。

另请参阅

setCurrentCharFormat()

currentCharFormatChanged(format)
Parameters:

format – QTextCharFormat

如果当前字符格式发生变化，例如由于光标位置的改变，则会发出此信号。

新格式是f。

另请参阅

setCurrentCharFormat()

currentFont()
Return type:

QFont

返回当前格式的字体。

cursorForPosition(pos)
Parameters:

pos – QPoint

Return type:

QTextCursor

返回位于位置 pos（视口坐标）的 QTextCursor。

cursorPositionChanged()

每当光标位置发生变化时，都会发出此信号。

cursorRect()
Return type:

QRect

返回一个矩形（在视口坐标中），该矩形包括文本编辑的光标。

cursorRect(cursor)
Parameters:

光标 – QTextCursor

Return type:

QRect

返回一个包含cursor的矩形（在视口坐标中）。

cursorWidth()
Return type:

整数

另请参阅

setCursorWidth()

属性 cursorWidthᅟ 的获取器。

cut()

将选中的文本复制到剪贴板并从文本编辑中删除。

如果没有选中的文本，则不会发生任何事。

另请参阅

copy() paste()

doSetTextCursor(cursor)
Parameters:

光标 – QTextCursor

document()
Return type:

QTextDocument

另请参阅

setDocument()

属性 documentᅟ 的获取器。

documentTitle()
Return type:

字符串

另请参阅

setDocumentTitle()

属性 documentTitleᅟ 的获取器。

ensureCursorVisible()

通过滚动文本编辑（如有必要）确保光标可见。

extraSelections()
Return type:

QTextEdit.ExtraSelection的列表

返回之前设置的额外选择。

另请参阅

setExtraSelections()

find(exp[, options=QTextDocument.FindFlags()])
Parameters:
Return type:

布尔

这是一个重载函数。

查找下一个匹配正则表达式 exp 的出现，使用给定的 options。

如果找到匹配项并将光标更改为选择匹配项，则返回true；否则返回false。

警告

由于历史原因，设置在exp上的大小写敏感选项被忽略。相反，使用options来确定搜索是否区分大小写。

find(exp[, options=QTextDocument.FindFlags()])
Parameters:

  • exp – 字符串

  • options – FindFlag 的组合

Return type:

布尔

查找字符串 exp 的下一个出现位置，使用给定的 options。如果找到 exp 并更改光标以选择匹配项，则返回 true；否则返回 false。

fontFamily()
Return type:

字符串

返回当前格式的字体家族。

fontItalic()
Return type:

布尔

如果当前格式的字体是斜体，则返回true；否则返回false。

另请参阅

setFontItalic()

fontPointSize()
Return type:

浮点数

返回当前格式的字体大小。

fontUnderline()
Return type:

布尔

如果当前格式的字体带有下划线，则返回 true；否则返回 false。

另请参阅

setFontUnderline()

fontWeight()
Return type:

整数

返回当前格式的字体粗细。

inputMethodQuery(query, argument)
Parameters:
Return type:

对象

insertFromMimeData(source)
Parameters:

来源 – QMimeData

此函数将MIME数据对象的内容插入到文本编辑的当前光标位置，该对象由source指定。每当文本作为剪贴板粘贴操作的结果插入时，或者当文本编辑接受来自拖放操作的数据时，都会调用此函数。

重新实现此函数以启用对额外MIME类型的拖放支持。

insertHtml(text)
Parameters:

文本 – str

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

方便插槽，在当前光标位置插入text，假定其为html格式。

它等同于：

edit.textCursor().insertHtml(fragment)

注意

当将此函数与样式表一起使用时，样式表将仅应用于文档中的当前块。为了在整个文档中应用样式表，请改用QTextDocument::setDefaultStyleSheet()。

insertPlainText(text)
Parameters:

文本 – str

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

在当前光标位置插入text的便捷插槽。

它等同于

edit.textCursor().insertText(text)
isReadOnly()
Return type:

布尔

属性 readOnlyᅟ 的获取器。

isUndoRedoEnabled()
Return type:

布尔

属性 undoRedoEnabledᅟ 的获取器。

lineWrapColumnOrWidth()
Return type:

整数

另请参阅

setLineWrapColumnOrWidth()

属性 lineWrapColumnOrWidthᅟ 的获取器。

lineWrapMode()
Return type:

LineWrapMode

另请参阅

setLineWrapMode()

属性 lineWrapModeᅟ 的获取器。

loadResource(type, name)
Parameters:

  • type – int

  • name – QUrl

Return type:

对象

加载由给定的type和name指定的资源。

此函数是QTextDocument::loadResource()的扩展。

另请参阅

loadResource()

mergeCurrentCharFormat(modifier)
Parameters:

modifier – QTextCharFormat

通过调用编辑器光标上的QTextCursor::mergeCharFormat，将modifier中指定的属性合并到当前字符格式中。如果编辑器有选择内容，则modifier的属性将直接应用于所选内容。

另请参阅

mergeCharFormat()

moveCursor(operation[, mode=QTextCursor.MoveAnchor])
Parameters:

通过执行给定的operation来移动光标。

如果 mode 是 QTextCursor::KeepAnchor，光标会选择它移动过的文本。这与用户按住 Shift 键并使用光标键移动光标时的效果相同。

另请参阅

movePosition()

overwriteMode()
Return type:

布尔

另请参阅

setOverwriteMode()

属性 overwriteModeᅟ 的获取器。

paste()

将剪贴板中的文本粘贴到当前光标位置的文本编辑器中。

如果剪贴板中没有文本，则不会发生任何操作。

要更改此函数的行为，即修改QTextEdit可以粘贴的内容以及粘贴方式，请重新实现虚拟函数canInsertFromMimeData()和insertFromMimeData()。

另请参阅

cut() copy()

placeholderText()
Return type:

字符串

另请参阅

setPlaceholderText()

属性 placeholderTextᅟ 的获取器。

print_(printer)
Parameters:

打印机 – QPagedPaintDevice

redo()

重做最后一次操作。

如果没有操作可以重做，即在撤销/重做历史中没有重做步骤，则不会发生任何事情。

另请参阅

undo()

redoAvailable(b)
Parameters:

b – 布尔值

每当重做操作变为可用（available 为 true）或不可用（available 为 false）时，会发出此信号。

scrollToAnchor(name)
Parameters:

name – str

滚动文本编辑，使具有给定name的锚点可见；如果name为空、已经可见或未找到，则不执行任何操作。

selectAll()

选择所有文本。

另请参阅

copy() cut() textCursor()

selectionChanged()

每当选择发生变化时，都会发出此信号。

另请参阅

copyAvailable()

setAcceptRichText(accept)
Parameters:

accept – 布尔值

另请参阅

acceptRichText()

属性 acceptRichTextᅟ 的设置器。

setAlignment(a)
Parameters:

a – AlignmentFlag 的组合

将当前段落的对齐方式设置为a。有效的对齐方式有Qt::AlignLeft、Qt::AlignRight、Qt::AlignJustify和Qt::AlignCenter（水平居中）。

另请参阅

alignment()

setAutoFormatting(features)
Parameters:

特性 – AutoFormattingFlag 的组合

另请参阅

autoFormatting()

属性 autoFormattingᅟ 的设置器。

setCurrentCharFormat(format)
Parameters:

format – QTextCharFormat

设置插入新文本时使用的字符格式为format，通过在编辑器的光标上调用QTextCursor::setCharFormat()。如果编辑器有选择内容，则字符格式直接应用于选择内容。

另请参阅

currentCharFormat()

setCurrentFont(f)
Parameters:

f – QFont

将当前格式的字体设置为 f。

setCursorWidth(width)
Parameters:

width – 整数

另请参阅

cursorWidth()

属性 cursorWidthᅟ 的设置器。

setDocument(document)
Parameters:

文档 – QTextDocument

另请参阅

document()

属性 documentᅟ 的设置器。

setDocumentTitle(title)
Parameters:

标题 – str

另请参阅

documentTitle()

属性 documentTitleᅟ 的设置器。

setExtraSelections(selections)
Parameters:

selections – QTextEdit.ExtraSelection 的列表

此函数允许使用指定的颜色临时标记文档中的某些区域，指定为selections。例如，在编程编辑器中，这可以用于用给定的背景颜色标记整行文本，以指示存在断点。

另请参阅

ExtraSelection extraSelections()

setFontFamily(fontFamily)
Parameters:

fontFamily – str

将当前格式的字体设置为 fontFamily。

setFontItalic(b)
Parameters:

b – 布尔值

如果 italic 为 true，则将当前格式设置为斜体；否则将当前格式设置为非斜体。

另请参阅

fontItalic()

setFontPointSize(s)
Parameters:

s – 浮点数

将当前格式的点大小设置为 s。

请注意，如果 s 为零或负数，此函数的行为未定义。

setFontUnderline(b)
Parameters:

b – 布尔值

如果 underline 为 true，则将当前格式设置为下划线；否则将当前格式设置为非下划线。

另请参阅

fontUnderline()

setFontWeight(w)
Parameters:

w – 整数

将当前格式的字体粗细设置为给定的weight，其中使用的值在QFont::Weight枚举定义的范围内。

setHtml(text)
Parameters:

文本 – str

属性 htmlᅟ 的设置器。

setLineWrapColumnOrWidth(w)
Parameters:

w – 整数

另请参阅

lineWrapColumnOrWidth()

属性 lineWrapColumnOrWidthᅟ 的设置器。

setLineWrapMode(mode)
Parameters:

mode – LineWrapMode

另请参阅

lineWrapMode()

属性 lineWrapModeᅟ 的设置器。

setMarkdown(markdown)
Parameters:

markdown – str

属性 markdownᅟ 的设置器。

setOverwriteMode(overwrite)
Parameters:

overwrite – 布尔值

另请参阅

overwriteMode()

属性 overwriteModeᅟ 的设置器。

setPlaceholderText(placeholderText)
Parameters:

placeholderText – str

另请参阅

placeholderText()

属性 placeholderTextᅟ 的设置器。

setPlainText(text)
Parameters:

文本 – str

将文本编辑的文本更改为字符串 text。任何先前的文本都将被移除。

备注：

  • text 被解释为纯文本。

  • 撤销/重做历史记录也会被清除。

  • currentCharFormat() 被重置，除非 textCursor() 已经在文档的开头。

另请参阅

toPlainText()

属性 plainTextᅟ 的设置器。

setReadOnly(ro)
Parameters:

ro – 布尔值

另请参阅

isReadOnly()

属性 readOnlyᅟ 的设置器。

setTabChangesFocus(b)
Parameters:

b – 布尔值

另请参阅

tabChangesFocus()

属性 tabChangesFocusᅟ 的设置器。

setTabStopDistance(distance)
Parameters:

距离 – 浮点数

另请参阅

tabStopDistance()

属性 tabStopDistanceᅟ 的设置器。

setText(text)
Parameters:

文本 – str

设置文本编辑器的text。文本可以是纯文本或HTML，文本编辑器将尝试猜测正确的格式。

直接使用setHtml()或setPlainText()以避免文本编辑的猜测。

另请参阅

toPlainText() toHtml()

setTextBackgroundColor(c)
Parameters:

c – QColor

将当前格式的文本背景颜色设置为c。

另请参阅

textBackgroundColor()

setTextColor(c)
Parameters:

c – QColor

将当前格式的文本颜色设置为c。

另请参阅

textColor()

setTextCursor(cursor)
Parameters:

光标 – QTextCursor

设置可见的cursor。

另请参阅

textCursor()

setTextInteractionFlags(flags)
Parameters:

flags – TextInteractionFlag 的组合

另请参阅

textInteractionFlags()

属性 textInteractionFlagsᅟ 的设置器。

setUndoRedoEnabled(enable)
Parameters:

enable – 布尔值

另请参阅

isUndoRedoEnabled()

属性 undoRedoEnabledᅟ 的设置器。

setWordWrapMode(policy)
Parameters:

策略 – WrapMode

另请参阅

wordWrapMode()

tabChangesFocus()
Return type:

布尔

另请参阅

setTabChangesFocus()

属性 tabChangesFocusᅟ 的获取器。

tabStopDistance()
Return type:

浮点数

另请参阅

setTabStopDistance()

属性 tabStopDistanceᅟ 的获取器。

textBackgroundColor()
Return type:

QColor

返回当前格式的文本背景颜色。

textChanged()

每当文档内容发生变化时，就会发出此信号；例如，当插入或删除文本时，或者应用格式时。

属性 markdownᅟ 的通知信号。

textColor()
Return type:

QColor

返回当前格式的文本颜色。

另请参阅

setTextColor()

textCursor()
Return type:

QTextCursor

返回表示当前可见光标的QTextCursor的副本。请注意，返回的光标的更改不会影响QTextEdit的光标；使用setTextCursor()来更新可见光标。

另请参阅

setTextCursor()

textInteractionFlags()
Return type:

TextInteractionFlag 的组合

另请参阅

setTextInteractionFlags()

属性 textInteractionFlagsᅟ 的获取器。

toHtml()
Return type:

字符串

属性 htmlᅟ 的获取器。

toMarkdown([features=QTextDocument.MarkdownDialectGitHub])
Parameters:

特性 – MarkdownFeature 的组合

Return type:

字符串

toPlainText()
Return type:

字符串

QString QTextEdit::toPlainText() const

返回文本编辑器的文本为纯文本。

另请参阅

setPlainText()

属性 plainTextᅟ 的获取器。

undo()

撤销最后一次操作。

如果没有操作可以撤销，即在撤销/重做历史中没有撤销步骤，则不会发生任何事情。

另请参阅

redo()

undoAvailable(b)
Parameters:

b – 布尔值

每当撤销操作变为可用（available 为 true）或不可用（available 为 false）时，会发出此信号。

wordWrapMode()
Return type:

WrapMode

另请参阅

setWordWrapMode()

zoomIn([range=1])
Parameters:

范围 – 整数

通过使基本字体大小range点更大并重新计算所有字体大小为新大小来放大文本。这不会改变任何图像的大小。

另请参阅

zoomOut()

zoomInF(range)
Parameters:

范围 – 浮点数

zoomOut([range=1])
Parameters:

范围 – 整数

通过使基础字体大小range点变小并重新计算所有字体大小为新大小来缩小文本。这不会改变任何图像的大小。

另请参阅

zoomIn()

class ExtraSelection

注意

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

详细描述

PySide6.QtWidgets.QTextEdit.ExtraSelection.cursor
PySide6.QtWidgets.QTextEdit.ExtraSelection.format