PySide6.QtWidgets.QPlainTextEdit

class QPlainTextEdit

QPlainTextEdit 类提供了一个用于编辑和显示纯文本的小部件。更多…

PySide6.QtWidgets.QPlainTextEdit 的继承图

概要

属性

方法

虚拟方法

插槽

信号

注意

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

详细描述

介绍与概念

QPlainTextEdit 是一个支持纯文本的高级查看器/编辑器。它经过优化，可以处理大型文档并快速响应用户输入。

QPlainText 使用了与 QTextEdit 非常相似的技术和概念，但针对纯文本处理进行了优化。

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

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

使用 QPlainTextEdit 作为显示部件

文本是通过setPlainText()设置或替换的，它会删除现有文本并将其替换为传递给setPlainText()的文本。

可以使用QTextCursor类或使用便捷函数insertPlainText()、appendPlainText()或paste()插入文本。

默认情况下，文本编辑器会在空白处换行以适应文本编辑小部件。setLineWrapMode() 函数用于指定你想要的换行方式，WidgetWidth 或 NoWrap 如果你不希望任何换行。如果你使用小部件宽度的自动换行 WidgetWidth ，你可以指定是否在空白处或任意位置换行，使用 setWordWrapMode() 。

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

如果你想限制QPlainTextEdit中的段落总数，例如在日志查看器中非常有用，那么你可以使用maximumBlockCount属性。setMaximumBlockCount()和appendPlainText()的结合将QPlainTextEdit变成一个高效的日志文本查看器。通过centerOnScroll()属性可以减少滚动，使日志查看器更快。文本可以以有限的方式进行格式化，可以使用语法高亮器（见下文），或者通过appendHtml()附加HTML格式的文本。虽然QPlainTextEdit不支持带有表格和浮动的复杂富文本渲染，但它支持有限的基于段落的格式化，这在日志查看器中可能是需要的。

只读键绑定

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

按键

操作

Qt::UpArrow

向上移动一行。

Qt::DownArrow

向下移动一行。

Qt::LeftArrow

向左移动一个字符。

Qt::RightArrow

向右移动一个字符。

PageUp

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

PageDown

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

首页

移动到文本的开头。

结束

移动到文本的末尾。

Alt+滚轮

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

Ctrl+滚轮

缩放文本。

Ctrl+A

选择所有文本。

使用 QPlainTextEdit 作为编辑器

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

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

QPlainTextEdit 持有一个 QTextDocument 对象，可以使用 document() 方法获取。你也可以使用 setDocument() 设置你自己的文档对象。如果文本发生变化，QTextDocument 会发出一个 textChanged() 信号，并且它还提供了一个 isModified() 函数，如果文本自加载以来或自上次调用 setModified 并将 false 作为参数以来已被修改，则该函数将返回 true。此外，它还提供了撤销和重做的方法。

语法高亮

就像 QTextEdit 一样，QPlainTextEdit 也与 QSyntaxHighlighter 一起工作。

编辑键绑定

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

按键

操作

退格键

删除光标左侧的字符。

删除

删除光标右侧的字符。

Ctrl+C

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

Ctrl+Insert

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

Ctrl+K

删除到行尾。

Ctrl+V

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

Shift+Insert

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

Ctrl+X

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

Shift+Delete

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

Ctrl+Z

撤销上一次操作。

Ctrl+Y

重做上一个操作。

LeftArrow

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

Ctrl+左箭头

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

RightArrow

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

Ctrl+右箭头

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

UpArrow

将光标向上移动一行。

Ctrl+UpArrow

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

DownArrow

将光标向下移动一行。

Ctrl+向下箭头

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

PageUp

将光标向上移动一页。

PageDown

将光标向下移动一页。

首页

将光标移动到行的开头。

Ctrl+Home

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

结束

将光标移动到行尾。

Ctrl+End

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

Alt+滚轮

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

Ctrl+滚轮

缩放文本。

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

与QTextEdit的差异

QPlainTextEdit 是一个轻量级的类，主要通过使用 QTextEdit 和 QTextDocument 背后的技术来实现。它相对于 QTextEdit 的性能优势主要来自于在文本文档上使用了一种不同且简化的文本布局，称为 QPlainTextDocumentLayout（参见 QTextDocument::setDocumentLayout()）。纯文本文档布局不支持表格或嵌入式框架，并且用逐行或逐段滚动的方法替代了像素精确的高度计算。这使得处理更大的文档成为可能，并且仍然可以在启用自动换行的情况下实时调整编辑器的大小。这也使得它成为一个快速的日志查看器（参见 setMaximumBlockCount()）。

{语法高亮示例}, {富文本处理}

另请参阅

QTextDocumentQTextCursor

class LineWrapMode

常量

描述

QPlainTextEdit.NoWrap

QPlainTextEdit.WidgetWidth

注意

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

property backgroundVisibleᅟ: bool

此属性控制调色板背景是否在文档区域外可见。

如果设置为true，纯文本编辑将在未被文本文档覆盖的视口区域绘制调色板背景。否则，如果设置为false，则不会绘制。此功能使用户能够直观地区分文档区域（使用调色板的基础颜色绘制）和未被任何文档覆盖的空区域。

默认值为 false。

Access functions:
property blockCountᅟ: int

此属性保存文档中的文本块数量。

默认情况下，在空文档中，此属性的值为1。

Access functions:
property centerOnScrollᅟ: bool

此属性决定光标是否应在屏幕上居中。

如果设置为true，纯文本编辑将垂直滚动文档以使光标在视口中心可见。这也允许文本编辑滚动到文档末尾以下。否则，如果设置为false，纯文本编辑将尽可能少地滚动以确保光标可见。相同的算法适用于通过appendPlainText()追加的任何新行。

默认值为 false。

Access functions:
property cursorWidthᅟ: int

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

Access functions:
property documentTitleᅟ: str

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

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

Access functions:
property lineWrapModeᅟ: QPlainTextEdit.LineWrapMode

此属性保存行换行模式。

默认模式是WidgetWidth，这会导致文本在文本编辑的右边缘换行。换行发生在空白处，保持整个单词的完整性。如果您希望在单词内换行，请使用setWordWrapMode()。

Access functions:
property maximumBlockCountᅟ: int

此属性保存文档中块的限制。

指定文档可能具有的最大块数。如果文档中的块数超过此属性指定的数量，将从文档的开头移除多余的块。

负值或零值表示文档可能包含无限数量的块。

默认值为0。

请注意，设置此属性将立即对文档内容应用限制。设置此属性还会禁用撤销重做历史记录。

Access functions:
property overwriteModeᅟ: bool

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

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

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

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

Access functions:
property placeholderTextᅟ: str

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

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

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

另请参阅

document()

Access functions:
property plainTextᅟ: str

此属性用于获取和设置纯文本编辑器的内容。设置此属性时，之前的内容将被移除，并且撤销/重做历史将被重置。除非textCursor()已经在文档的开头，否则currentCharFormat()也会被重置。

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

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

指定标签在显示文本时应如何与用户输入交互。

如果标志包含Qt::LinksAccessibleByKeyboard或Qt::TextSelectableByKeyboard，则焦点策略也会自动设置为Qt::ClickFocus。

默认值取决于QPlainTextEdit是只读还是可编辑的。

Access functions:
property undoRedoEnabledᅟ: bool

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

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

默认情况下，此属性为 true。

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

父级 – QWidget

构造一个空的QPlainTextEdit，其父对象为parent。

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

  • 文本 – str

  • parent – QWidget

使用父级 parent 构造一个 QPlainTextEdit。文本编辑框将显示纯文本 text。

anchorAt(pos)
Parameters:

pos – QPoint

Return type:

字符串

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

appendHtml(html)
Parameters:

html – 字符串

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

appendPlainText()

appendPlainText(text)
Parameters:

文本 – str

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

另请参阅

appendHtml()

backgroundVisible()
Return type:

布尔

另请参阅

setBackgroundVisible()

属性 backgroundVisibleᅟ 的获取器。

blockBoundingGeometry(block)
Parameters:

块 – QTextBlock

Return type:

QRectF

返回文本block在内容坐标中的边界矩形。使用contentOffset()转换矩形以获取视口上的视觉坐标。

blockBoundingRect(block)
Parameters:

块 – QTextBlock

Return type:

QRectF

返回文本block在块自身坐标中的边界矩形。

blockCount()
Return type:

整数

属性 blockCountᅟ 的获取器。

blockCountChanged(newBlockCount)
Parameters:

newBlockCount – int

每当块计数发生变化时，都会发出此信号。新的块计数在newBlockCount中传递。

canInsertFromMimeData(source)
Parameters:

来源 – QMimeData

Return type:

布尔

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

canPaste()
Return type:

布尔

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

centerCursor()

滚动文档以使光标垂直居中。

centerOnScroll()
Return type:

布尔

另请参阅

setCenterOnScroll()

属性 centerOnScrollᅟ 的获取器。

clear()

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

备注：

另请参阅

cut() setPlainText()

contentOffset()
Return type:

QPointF

返回内容在视口坐标中的原点。

纯文本编辑内容的原点始终是第一个可见文本块的左上角。当文本水平滚动时，或者当第一个可见块部分滚动到屏幕外时，即可见文本不是从第一个可见块的第一行开始，或者当第一个可见块是第一个块且编辑器显示边距时，内容偏移量不同于(0,0)。

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()

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()

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。

firstVisibleBlock()
Return type:

QTextBlock

返回第一个可见的块。

另请参阅

blockBoundingRect()

getPaintContext()
Return type:

PaintContext

返回viewport()的绘制上下文，仅在重新实现paintEvent()时有用。

inputMethodQuery(query, argument)
Parameters:
Return type:

对象

insertFromMimeData(source)
Parameters:

来源 – QMimeData

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

insertPlainText(text)
Parameters:

文本 – str

警告

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

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

它等同于

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

布尔

属性 readOnlyᅟ 的获取器。

isUndoRedoEnabled()
Return type:

布尔

属性 undoRedoEnabledᅟ 的获取器。

lineWrapMode()
Return type:

LineWrapMode

另请参阅

setLineWrapMode()

属性 lineWrapModeᅟ 的获取器。

loadResource(type, name)
Parameters:

  • type – int

  • name – QUrl

Return type:

对象

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

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

另请参阅

loadResource()

maximumBlockCount()
Return type:

整数

另请参阅

setMaximumBlockCount()

属性 maximumBlockCountᅟ 的获取器。

mergeCurrentCharFormat(modifier)
Parameters:

modifier – QTextCharFormat

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

另请参阅

mergeCharFormat()

modificationChanged(changed)
Parameters:

changed – bool

每当文档内容以影响修改状态的方式发生变化时，都会发出此信号。如果changed为true，则表示文档已被修改；否则为false。

例如，在文档上调用 setModified(false) 然后插入文本会导致信号被发出。如果您撤销该操作，使文档返回到其原始的未修改状态，信号将再次被发出。

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

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

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

另请参阅

movePosition()

overwriteMode()
Return type:

布尔

另请参阅

setOverwriteMode()

属性 overwriteModeᅟ 的获取器。

paste()

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

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

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

另请参阅

cut() copy()

placeholderText()
Return type:

字符串

另请参阅

setPlaceholderText()

属性 placeholderTextᅟ 的获取器。

print_(printer)
Parameters:

打印机 – QPagedPaintDevice

redo()

重做最后一次操作。

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

另请参阅

undo()

redoAvailable(b)
Parameters:

b – 布尔值

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

selectAll()

选择所有文本。

另请参阅

copy() cut() textCursor()

selectionChanged()

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

另请参阅

copyAvailable()

setBackgroundVisible(visible)
Parameters:

visible – 布尔值

另请参阅

backgroundVisible()

属性 backgroundVisibleᅟ 的设置器。

setCenterOnScroll(enabled)
Parameters:

enabled – 布尔值

另请参阅

centerOnScroll()

属性 centerOnScrollᅟ 的设置器。

setCurrentCharFormat(format)
Parameters:

format – QTextCharFormat

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

另请参阅

currentCharFormat()

setCursorWidth(width)
Parameters:

width – 整数

另请参阅

cursorWidth()

属性 cursorWidthᅟ 的设置器。

setDocument(document)
Parameters:

文档 – QTextDocument

使 document 成为文本编辑器的新文档。

提供的文档的父QObject仍然是该对象的所有者。如果当前文档是文本编辑器的子文档，则它将被删除。

文档必须具有继承自QPlainTextDocumentLayout的文档布局（参见QTextDocument::setDocumentLayout()）。

另请参阅

document()

setDocumentTitle(title)
Parameters:

标题 – str

另请参阅

documentTitle()

属性 documentTitleᅟ 的设置器。

setExtraSelections(selections)
Parameters:

selections – QTextEdit.ExtraSelection 的列表

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

setLineWrapMode(mode)
Parameters:

mode – LineWrapMode

另请参阅

lineWrapMode()

属性 lineWrapModeᅟ 的设置器。

setMaximumBlockCount(maximum)
Parameters:

最大值 – int

另请参阅

maximumBlockCount()

属性 maximumBlockCountᅟ 的设置器。

setOverwriteMode(overwrite)
Parameters:

overwrite – 布尔值

另请参阅

overwriteMode()

属性 overwriteModeᅟ 的设置器。

setPlaceholderText(placeholderText)
Parameters:

placeholderText – str

另请参阅

placeholderText()

属性 placeholderTextᅟ 的设置器。

setPlainText(text)
Parameters:

文本 – str

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

text 被解释为纯文本。

备注：

另请参阅

toPlainText()

属性 plainTextᅟ 的设置器。

setReadOnly(ro)
Parameters:

ro – 布尔值

另请参阅

isReadOnly()

属性 readOnlyᅟ 的设置器。

setTabChangesFocus(b)
Parameters:

b – 布尔值

另请参阅

tabChangesFocus()

属性 tabChangesFocusᅟ 的设置器。

setTabStopDistance(distance)
Parameters:

距离 – 浮点数

另请参阅

tabStopDistance()

属性 tabStopDistanceᅟ 的设置器。

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ᅟ 的获取器。

textChanged()

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

属性 plainTextᅟ 的通知信号。

textCursor()
Return type:

QTextCursor

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

另请参阅

setTextCursor()

textInteractionFlags()
Return type:

TextInteractionFlag 的组合

另请参阅

setTextInteractionFlags()

属性 textInteractionFlagsᅟ 的获取器。

toPlainText()
Return type:

字符串

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

另请参阅

setPlainText()

属性 plainTextᅟ 的获取器。

undo()

撤销最后一次操作。

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

另请参阅

redo()

undoAvailable(b)
Parameters:

b – 布尔值

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

updateRequest(rect, dy)
Parameters:

  • rect – QRect

  • dy – 整数

当文本文档需要更新指定的rect时，会发出此信号。如果文本被滚动，rect将覆盖整个视口区域。如果文本垂直滚动，dy将携带视口滚动的像素量。

信号的目的是支持在纯文本编辑子类中的额外小部件，例如显示行号、断点或其他额外信息。

wordWrapMode()
Return type:

WrapMode

另请参阅

setWordWrapMode()

zoomIn([range=1])
Parameters:

范围 – 整数

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

另请参阅

zoomOut()

zoomInF(range)
Parameters:

范围 – 浮点数

zoomOut([range=1])
Parameters:

范围 – 整数

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

另请参阅

zoomIn()