class QTextEdit#

The QTextEdit class provides a widget that is used to edit and display both plain and rich text. More…

Inheritance diagram of PySide6.QtWidgets.QTextEdit

Inherited by: QTextBrowser

Synopsis#

属性#

方法#

虚函数#

槽方法#

信号#

备注

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

详细描述#

警告

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

简介和概念#

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

QTextEdit 在段落和字符上工作。段落是格式化字符串，它根据小部件的宽度进行换行。默认情况下，读取纯文本时，一个换行符表示一个段落。文档由零个或多个段落组成。段落中的单词根据段落的对齐方式对齐。段落由硬回车分隔。段落中的每个字符都有自己的属性，例如字体和颜色。

QtWidgets.QTextEditQTextEdit可以显示图片、列表和表格。如果文本超出文本编辑器视口的显示范围，会出现滚动条。文本编辑器可以加载纯文本和富文本文件。富文本可以使用HTML 4标记语言的一个子集进行描述；有关更多信息，请参阅“支持的HTML子集”页面。

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

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

默认情况下，QTextEdit上鼠标光标的形状是Qt::IBeamCursor。可以通过viewport()的cursor属性进行更改。

使用QTextEdit作为显示小部件

QtWidgets.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，或使用setLineWrapColumnOrWidth()指定的像素或列数设置字符列宽（例如80列宽的FixedColumnWidth）。如果您使用到组件宽度的自动换行WidgetWidth，可以通过setWordWrapMode()指定是在空白处或任何地方进行换行。

可以使用find()函数在文本中查找和选择特定的字符串。

如果您想要限制QTextEdit 中的段落总数，例如在日志查看器中通常很有用，则可以使用QTextDocument的maximumBlockCount属性。

只读快捷键#

当QTextEdit 以只读方式使用时，快捷键仅限于导航，并且文本只能用鼠标选择。

按键操作

动作

上

向上移动一行。

下

向下移动一行。

左

向左移动一个字符。

右

向右移动一个字符。

PageUp

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

PageDown

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

Home

移动到文本的开始位置。

End

移动到文本的末尾。

Alt+Wheel

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

Ctrl+滚轮

缩放文本。

Ctrl+A

选择所有文本。

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

备注

只有当字体大小未设置为固定大小时，对 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和富文本插入到文档中，当用户将数据以这些MIME类型之一拖放到文档时。通过重新实现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+Left

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

右

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

Ctrl+Right

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

上

将光标向上移动一行。

下

将光标向下移动一行。

PageUp

将光标向上移动一页。

PageDown

将光标向下移动一页。

Home

将光标移动到行首。

Ctrl+Home

将光标移动到文本开头。

End

将光标移动到行末。

Ctrl+End

将光标移动到文本末尾。

Alt+Wheel

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

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

另请参阅

语法高亮示例 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。

访问函数
property autoFormattingᅟ: Combination of QTextEdit.AutoFormattingFlag#

该属性表示启用的自动格式化功能集。

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

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

访问函数
属性 cursorWidthării: int#

此属性指定光标在像素中的宽度。默认值为1。

访问函数
属性 documentᅟ: QTextDocument#

此属性包含文本编辑器的底层文档。

备注

除非它是文档的父对象，否则编辑器不会保留对文档的所有权。提供的文档的父对象继续保持对对象的所有权。如果先前分配的文档是编辑器的子对象，则它将被删除。

访问函数
属性 documentTitleᅟ: str#

此属性包含从文本中解析出的文档标题。

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

访问函数
属性 htmlᅟ: str#

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

toHtml()返回文本编辑器的文本作为HTML。

setHtml()更改文本编辑器的文本。任何以前的文本都将被删除，撤销/重做历史记录将被清除。输入文本被解释为HTML格式的富文本。currentCharFormat()也将重置，除非textCursor()已经在文档的起始位置。

备注

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

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

另请参阅

plainText

访问函数
属性 lineWrapColumnOrWidthᅟ: int#

此属性包含文本将被换行的像素或列位置（根据换行模式而定）。

如果换行模式是 FixedPixelWidth ，则该值表示文本编辑左边框开始的像素数位置，文本应该在这里换行。如果换行模式是 FixedColumnWidth ，则该值表示文本编辑左边框开始的字符列号位置，文本应该在这里换行。

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

另请参阅

lineWrapMode

访问函数
属性 lineWrapModeᅟ: QTextEdit.LineWrapMode#

此属性存储换行模式。

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

另请参阅

lineWrapColumnOrWidth

访问函数
属性 markdownᅟ: str#

该属性提供了文本编辑文本的Markdown接口。

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

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

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

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

  • MarkdownNoHTML

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

默认值为 MarkdownDialectGitHub。

另请参阅

plainText html setMarkdown()

访问函数
属性overwriteMode: bool#

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

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

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

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

访问函数
属性placeholderText: str#

此属性表示编辑器的占位符文本。

设置此属性会使得在文档内容为空时，编辑器显示灰色占位符文本。

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

另请参阅

document()

访问函数
属性plainText: str#

此属性表示文本编辑器内容作为纯文本。

设置属性时，之前的内部内容将被删除，并且撤销/重做历史会被重置。如果textCursor() 已位于文档的起始位置，则恢复格式也会被重置。

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

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

另请参阅

html

访问函数
属性readOnly: bool#

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

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

此属性的默认值为false。

访问函数
属性 tabChangesFocus: bool#

该属性用于控制Tab键是否改变焦点或被接受作为输入。

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

访问函数
属性 tabStopDistance: float#

该属性存储以像素为单位的制表位距离。

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

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

另请参阅

defaultTextOption

访问函数
属性 textInteractionFlags: Qt.TextInteractionFlag的组合#

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

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

访问函数
属性 undoRedoEnabled: bool#

该属性用于控制撤销和重做功能是否启用。

如果此属性为真，并且存在可以撤销（或重做）的操作，则用户才能撤销或重做操作。

访问函数
__init__(text[, parent=None])#
参数：

  • text – 字符串

  • parent – QWidget

构造一个具有父级parent的QTextEdit。文本编辑将显示文本text。文本将被解析为html。

__init__([parent=None])
参数：

parent – QWidget

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

acceptRichText()#
返回类型:

bool

另请参阅

setAcceptRichText()

属性acceptRichText的获取器。

alignment()#
返回类型:

AlignmentFlag的组合

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

另请参阅

setAlignment()#

anchorAt(pos)#
参数：

pos – QPoint

返回类型:

str

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

append(text)#
参数：

text – 字符串

将包含text的新段落追加到文本编辑器的末尾。

备注

追加的新段落将与当前游标位置所处的段落具有相同的字符格式和块格式。

另请参阅

currentCharFormat() blockFormat()

autoFormatting()#
返回类型:

AutoFormattingFlag的组合

另请参阅

setAutoFormatting()

属性autoFormatting的获取器。

canInsertFromMimeData(source)#
参数：

source – QMimeData

返回类型:

bool

如果由source指定的MIME数据对象的内容可以被解码并插入到文档中，则此函数返回true。当我们进行拖动操作时，鼠标进入此小部件，需要确定是否可以接受拖放操作。

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

canPaste()#
返回类型:

bool

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

clear()#

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

注意

另请参阅

cut() setPlainText() setHtml()

copy()#

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

另请参阅

copyAvailable()

copyAvailable(b)#
参数：

b – 布尔型

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

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

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

另请参阅

selectionChanged()

createMimeDataFromSelection()#
返回类型:

QMimeData

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

如果你要重写这个函数，请注意返回的 QMimeData 对象的所有权传递给了调用者。可以通过使用 textCursor() 函数来获取选择。

createStandardContextMenu()#
返回类型:

QMenu

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

我们建议使用 createStandardContextMenu(QPoint) 版本，这将启用与用户点击位置相关的操作。

createStandardContextMenu(position)
参数：

位置 – QPoint

返回类型:

QMenu

此函数创建标准的上下文菜单，当用户用鼠标右键点击文本编辑区域时显示。它从默认的contextMenuEvent()处理程序中调用，并接受鼠标点击的文档坐标中的位置。这可以实现依赖于用户点击位置的动作。弹出菜单的所有权传递给调用者。

currentCharFormat()#
返回类型:

QTextCharFormat

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

另请参阅

setCurrentCharFormat()

currentCharFormatChanged(format)#
参数：

格式 – QTextCharFormat

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

新格式为 f。

另请参阅

setCurrentCharFormat()

currentFont()#
返回类型:

QFont

返回当前格式的字体。

cursorForPosition(pos)#
参数：

pos – QPoint

返回类型:

QTextCursor

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

cursorPositionChanged()#

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

cursorRect()#
返回类型:

QRect

返回包含文本编辑器光标的矩形（视口坐标）。

cursorRect(cursor)
参数：

光标 – QTextCursor

返回类型:

QRect

返回包含光标的矩形（视口坐标）。

cursorWidth()#
返回类型:

int

另请参阅

setCursorWidth()

属性 cursorWidthᅟ 的获取器。

cut()#

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

如果没有选中文本，则不执行任何操作。

另请参阅

copy() paste()

doSetTextCursor(cursor)#
参数：

光标 – QTextCursor

document()#
返回类型:

QTextDocument

另请参阅

setDocument()

属性 document 的 getter。

documentTitle()#
返回类型:

str

另请参阅

setDocumentTitle()

属性 documentTitle 的 getter。

ensureCursorVisible()#

通过必要时滚动文本编辑器来确保光标可见。

extraSelections()#
返回类型:

. QTextEdit.ExtraSelection 列表

返回以前设置的自定义选择。

另请参阅

setExtraSelections()

find(exp[, options=QTextDocument.FindFlags()])#
参数：
返回类型:

bool

这是一个重载函数。

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

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

警告

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

find(exp[, options=QTextDocument.FindFlags()])
参数：

  • exp – str

  • options – FindFlag 的组合

返回类型:

bool

使用给定参数 options，查找字符串 exp 的下一次出现。如果找到 exp，则返回 true 并将光标移动到所选匹配处；否则返回 false。

fontFamily()#
返回类型:

str

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

fontItalic()#
返回类型:

bool

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

另请参阅

setFontItalic()

fontPointSize()#
返回类型:

浮点数

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

fontUnderline()#
返回类型:

bool

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

另请参阅

setFontUnderline()

fontWeight()#
返回类型:

int

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

inputMethodQuery(query, argument)#
参数：
返回类型:

对象

insertFromMimeData(source)#
参数：

source – QMimeData

此函数将指定为 source 的 MIME 数据对象的文本插入到当前位置的文本编辑器中。当文本因为粘贴剪切板内容或者文本编辑器接受拖放操作的数据而被插入时，该函数会被调用。

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

insertHtml(text)#
参数：

text – 字符串

警告

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

这是一个便捷槽函数，将假定格式为 HTML 的 text 插入到当前光标的位置。

它等同于

edit.textCursor().insertHtml(fragment)

备注

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

insertPlainText(text)#
参数：

text – 字符串

警告

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

这是一个便捷槽函数，将 text 插入到当前光标的位置。

它等同于

edit.textCursor().insertText(text)
isReadOnly()#
返回类型:

bool

获取属性 readOnly 的值。

isUndoRedoEnabled()#
返回类型:

bool

获取属性 undoRedoEnabled 的值。

lineWrapColumnOrWidth()#
返回类型:

int

另请参阅

setLineWrapColumnOrWidth()

获取属性 lineWrapColumnOrWidth 的值。

lineWrapMode()#
返回类型:

LineWrapMode

另请参阅

setLineWrapMode()

获取属性 lineWrapMode 的值。

loadResource(type, name)#
参数：

  • type – int

  • name – QUrl

返回类型:

对象

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

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

另请参阅

loadResource()

mergeCurrentCharFormat(modifier)#
参数：

modifier – QTextCharFormat

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

另请参阅

mergeCharFormat()

moveCursor(operation[, mode=QTextCursor.MoveAnchor])#
参数：

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

如果 mode 是 QTextCursor::KeepAnchor，则游标会选中它移动过的文本。这与用户在按下 Shift 键的同时用光标键移动游标时所得的效果相同。

另请参阅

movePosition()

overwriteMode()#
返回类型:

bool

另请参阅

setOverwriteMode()

overwriteMode 属性的获取器。

paste()#

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

如果剪贴板中没有文本，则什么也不会发生。

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

另请参阅

cut() copy()

placeholderText()#
返回类型:

str

另请参阅

setPlaceholderText()

placeholderText 属性的获取器。

print_(printer)#
参数：

printer – QPagedPaintDevice

redo()#

重做上一次操作。

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

另请参阅

undo()

redoAvailable(b)#
参数：

b – 布尔型

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

scrollToAnchor(name)#
参数：

name – 字符串

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

selectAll()#

选择所有文本。

另请参阅

copy() cut() textCursor()

selectionChanged()#

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

另请参阅

copyAvailable()

setAcceptRichText(accept)#
参数：

accept – 布尔值

另请参阅

acceptRichText()

属性 acceptRichText 的设置器。

setAlignment(a)#
参数：

a – AlignmentFlag 的组合

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

另请参阅

alignment()

setAutoFormatting(features)#
参数：

features – AutoFormattingFlag 的组合

另请参阅

autoFormatting()

属性 autoFormatting 的设置器。

setCurrentCharFormat(format)#
参数：

格式 – QTextCharFormat

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

另请参阅

currentCharFormat()

setCurrentFont(f)#
参数：

f – QFont

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

setCursorWidth(width)#
参数：

width – int

另请参阅

cursorWidth()

属性cursorWidthᅟ的设置者。

setDocument(document)#
参数：

document – QTextDocument

另请参阅

document()

属性documentᅟ的设置者。

setDocumentTitle(title)#
参数：

title – str

另请参阅

documentTitle()

属性documentTitleᅟ的设置者。

setExtraSelections(selections)#
参数：

selections – .list of QTextEdit.ExtraSelection

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

另请参阅

ExtraSelection extraSelections()

setFontFamily(fontFamily)#
参数：

fontFamily – str

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

setFontItalic(b)#
参数：

b – 布尔型

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

另请参阅

fontItalic()

setFontPointSize(s)#
参数：

s – float

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

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

setFontUnderline(b)#
参数：

b – 布尔型

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

另请参阅

fontUnderline()

setFontWeight(w)#
参数：

w – int

将当前格式的字体重量设置为给定的 重量，所使用的值在 QFont::Weight 枚举定义的范围内。

setHtml(text)#
参数：

text – 字符串

属性 html 的设置器。

setLineWrapColumnOrWidth(w)#
参数：

w – int

另请参阅

lineWrapColumnOrWidth()

属性 lineWrapColumnOrWidth 的设置器。

setLineWrapMode(mode)#
参数：

mode - LineWrapMode

另请参阅

lineWrapMode()

属性 lineWrapMode 的设置器。

setMarkdown(markdown)#
参数：

markdown - 字符串

属性 markdown 的设置器。

setOverwriteMode(overwrite)#
参数：

overwrite - 布尔值

另请参阅

overwriteMode()

属性 overwriteMode 的设置器。

setPlaceholderText(placeholderText)#
参数：

placeholderText - 字符串

另请参阅

placeholderText()

属性 placeholderText 的设置器。

setPlainText(text)#
参数：

text – 字符串

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

注意

  • text 作为纯文本解释。

  • 取消/重做历史记录也将被清除。

  • currentCharFormat() 将被重置，除非 textCursor() 已经位于文档的开始处。

另请参阅

toPlainText()

属性 plainText 的设置器。

setReadOnly(ro)#
参数：

ro - 布尔值

另请参阅

isReadOnly()

属性 readOnly 的设置器。

setTabChangesFocus(b)#
参数：

b – 布尔型

另请参阅

tabChangesFocus()

属性 tabChangesFocus 的设置器。

setTabStopDistance(distance)#
参数：

distance - 浮点数

另请参阅

tabStopDistance()

属性 tabStopDistance 的设置器。

setText(text)#
参数：

text – 字符串

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

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

另请参阅

toPlainText() toHtml()

setTextBackgroundColor(c)#
参数：

c – QColor

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

另请参阅

textBackgroundColor()

setTextColor(c)#
参数：

c – QColor

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

另请参阅

textColor()

setTextCursor(cursor)#
参数：

光标 – QTextCursor

设置可见的 cursor。

另请参阅

textCursor()

setTextInteractionFlags(flags)#
参数：

flags – TextInteractionFlag 组合

另请参阅

textInteractionFlags()

属性 textInteractionFlagsᅟ 的设置器。

setUndoRedoEnabled(enable)#
参数：

enable – bool

另请参阅

isUndoRedoEnabled()

属性 undoRedoEnabledᅟ 的设置器。

setWordWrapMode(policy)#
参数：

policy – WrapMode

另请参阅

wordWrapMode()

tabChangesFocus()#
返回类型:

bool

另请参阅

setTabChangesFocus()

属性 tabChangesFocusᅟ 的获取器。

tabStopDistance()#
返回类型:

浮点数

另请参阅

setTabStopDistance()

属性《tabStopDistance》的获取器。

textBackgroundColor()#
返回类型:

QColor

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

textChanged()#

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

属性《markdown》的变化通知信号。

textColor()#
返回类型:

QColor

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

另请参阅

setTextColor()

textCursor()#
返回类型:

QTextCursor

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

另请参阅

setTextCursor()

textInteractionFlags()#
返回类型:

TextInteractionFlag 的组合

另请参阅

setTextInteractionFlags()

属性《textInteractionFlags》的获取器。

toHtml()#
返回类型:

str

属性《html》的获取器。

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

features - MarkdownFeature 的组合

返回类型:

str

toPlainText()#
返回类型:

str

QString QTextEdit::toPlainText() const

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

另请参阅

setPlainText()

属性《plainText》的获取器。

undo()#

撤销上一次操作。

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

另请参阅

redo()

undoAvailable(b)#
参数：

b – 布尔型

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

wordWrapMode()#
返回类型:

WrapMode

另请参阅

setWordWrapMode()

zoomIn([range=1])#
参数：

range – int

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

另请参阅

zoomOut()

zoomInF(range)#
参数：

range – float

zoomOut([range=1])#
参数：

range – int

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

另请参阅

zoomIn()