QTextEdit Class

成员函数文档

[explicit] QTextEdit::QTextEdit(QWidget *parent = nullptr)

使用父parent 构建一个空的 QTextEdit。

[explicit] QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

构造一个 QTextEdit，其父节点为parent 。文本编辑器将显示文本text 。文本被解释为 html 格式。

[virtual noexcept] QTextEdit::~QTextEdit()

毁灭者

Qt::Alignment QTextEdit::alignment() const

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

另请参见 setAlignment()。

QString QTextEdit::anchorAt(const QPoint &pos) const

返回位于pos 位置的锚点的引用，如果该位置不存在锚点，则返回空字符串。

[slot] void QTextEdit::append(const QString &text)

在文本编辑末尾添加一个新段落，text 。

另请参阅 currentCharFormat() 和QTextCursor::blockFormat()。

[virtual protected] bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

如果source 所指定的 MIME 数据对象的内容可以解码并插入到文档中，该函数将返回true 。例如，在拖动操作过程中，鼠标进入该 widget 时，需要确定是否可以接受拖放操作，这时就会调用该函数。

重新实现该函数可为其他 MIME 类型提供拖放支持。

bool QTextEdit::canPaste() const

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

[override virtual protected] void QTextEdit::changeEvent(QEvent *e)

重实现：QFrame::changeEvent(QEvent *ev)。

[slot] void QTextEdit::clear()

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

备注

• 撤销/重做历史记录也会被清除。
• currentCharFormat除非textCursor() 已经位于文档开头，否则 () 将被重置。

另请参阅 cut()、setPlainText() 和setHtml()。

[override virtual protected] void QTextEdit::contextMenuEvent(QContextMenuEvent *event)

重实现：QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)。

显示用createStandardContextMenu() 创建的标准上下文菜单。

如果不希望文本编辑器有上下文菜单，可以将其contextMenuPolicy 设置为Qt::NoContextMenu 。如果想自定义上下文菜单，请重新实现此函数。如果要扩展标准上下文菜单，请重新实现该函数，调用createStandardContextMenu() 并扩展返回的菜单。

有关事件的信息将在event 对象中传递。

void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QTextEdit::copy()

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

另请参阅 copyAvailable().

[signal] void QTextEdit::copyAvailable(bool yes)

在文本编辑器中选中或取消选中文本时会发出该信号。

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

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

另请参见 selectionChanged()。

[virtual protected] QMimeData *QTextEdit::createMimeDataFromSelection() const

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

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

QMenu *QTextEdit::createStandardContextMenu()

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

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

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

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

QTextCharFormat QTextEdit::currentCharFormat() const

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

另请参阅 setCurrentCharFormat()。

[signal] void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)

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

新格式为f 。

另请参见 setCurrentCharFormat().

QFont QTextEdit::currentFont() const

返回当前格式的字体。

另请参阅 setCurrentFont()、setFontFamily() 和setFontPointSize()。

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

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

[signal] void QTextEdit::cursorPositionChanged()

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

QRect QTextEdit::cursorRect() const

返回一个包含文本编辑光标的矩形（以视口坐标表示）。

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

返回一个包含cursor 的矩形（以视口坐标表示）。

[slot] void QTextEdit::cut()

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

如果没有选定文本，则不会发生任何操作。

另请参阅 copy() 和paste()。

[override virtual protected] void QTextEdit::dragEnterEvent(QDragEnterEvent *e)

重实现：QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)

重实现：QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QTextEdit::dragMoveEvent(QDragMoveEvent *e)

重实现：QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QTextEdit::dropEvent(QDropEvent *e)

重实现：QAbstractScrollArea::dropEvent(QDropEvent *event).

void QTextEdit::ensureCursorVisible()

确保光标可见，必要时滚动文本编辑。

QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const

返回先前设置的额外选项。

另请参阅 setExtraSelections()。

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

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

bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

这是一个重载函数。

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

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

[override virtual protected] void QTextEdit::focusInEvent(QFocusEvent *e)

重实现：QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QTextEdit::focusNextPrevChild(bool next)

重实现：QWidget::focusNextPrevChild(bool next）。

[override virtual protected] void QTextEdit::focusOutEvent(QFocusEvent *e)

重实现：QWidget::focusOutEvent(QFocusEvent *event).

QString QTextEdit::fontFamily() const

返回当前格式的字体族。

另请参阅 setFontFamily()、setCurrentFont() 和setFontPointSize()。

bool QTextEdit::fontItalic() const

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

另请参阅 setFontItalic().

qreal QTextEdit::fontPointSize() const

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

另请参阅 setFontFamily()、setCurrentFont() 和setFontPointSize()。

bool QTextEdit::fontUnderline() const

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

另请参阅 setFontUnderline().

int QTextEdit::fontWeight() const

返回当前格式的字体权重。

另请参阅 setFontWeight()、setCurrentFont()、setFontPointSize() 和QFont::Weight 。

[override virtual protected] void QTextEdit::inputMethodEvent(QInputMethodEvent *e)

重实现：QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const

重实现：QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[virtual protected] void QTextEdit::insertFromMimeData(const QMimeData *source)

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

重新实现此函数可支持其他 MIME 类型的拖放操作。

[slot] void QTextEdit::insertHtml(const QString &text)

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

它等同于

edit->textCursor().insertHtml(fragment);

[slot] void QTextEdit::insertPlainText(const QString &text)

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

它等同于

edit->textCursor().insertText(text);

[override virtual protected] void QTextEdit::keyPressEvent(QKeyEvent *e)

重实现：QAbstractScrollArea::keyPressEvent(QKeyEvent *e)。

[override virtual protected] void QTextEdit::keyReleaseEvent(QKeyEvent *e)

重实现：QWidget::keyReleaseEvent(QKeyEvent *event).

[virtual invokable] QVariant QTextEdit::loadResource(int type, const QUrl &name)

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

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

另请参阅 QTextDocument::loadResource()。

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

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

另请参见 QTextCursor::mergeCharFormat().

[override virtual protected] void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)

重实现：QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)。

[override virtual protected] void QTextEdit::mouseMoveEvent(QMouseEvent *e)

重实现：QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)。

[override virtual protected] void QTextEdit::mousePressEvent(QMouseEvent *e)

重实现：QAbstractScrollArea::mousePressEvent(QMouseEvent *e)。

[override virtual protected] void QTextEdit::mouseReleaseEvent(QMouseEvent *e)

重实现：QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)。

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

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

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

另请参阅 QTextCursor::movePosition() 。

[override virtual protected] void QTextEdit::paintEvent(QPaintEvent *event)

重实现：QAbstractScrollArea::paintEvent(QPaintEvent *event)。

该事件处理程序可在子类中重新实现，以接收event 中传递的绘制事件。通常无需在QTextEdit 的子类中重新实现该函数。

[slot] void QTextEdit::paste()

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

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

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

另请参见 cut() 和copy()。

void QTextEdit::print(QPagedPaintDevice *printer) const

方便函数，用于将文本编辑器的文档打印到给定的printer 。这等同于直接调用文档的打印方法，只是该函数还支持将 QPrinter::Selection 作为打印范围。

另请参阅 QTextDocument::print() 。

[slot] void QTextEdit::redo()

重做最后一个操作。

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

另请参见 undo()。

[signal] void QTextEdit::redoAvailable(bool available)

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

[override virtual protected] void QTextEdit::resizeEvent(QResizeEvent *e)

重实现：QAbstractScrollArea::resizeEvent(QResizeEvent *event).

[override virtual protected] void QTextEdit::scrollContentsBy(int dx, int dy)

重实现：QAbstractScrollArea::scrollContentsBy(int dx, int dy）。

[slot] void QTextEdit::scrollToAnchor(const QString &name)

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

[slot] void QTextEdit::selectAll()

选择所有文本。

另请参阅 copy()、cut() 和textCursor()。

[signal] void QTextEdit::selectionChanged()

每当选择发生变化时，就会发出该信号。

另请参阅 copyAvailable().

[slot] void QTextEdit::setAlignment(Qt::Alignment a)

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

另请参阅 alignment() 。

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

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

另请参阅 currentCharFormat()。

[slot] void QTextEdit::setCurrentFont(const QFont &f)

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

另请参阅 currentFont()、setFontPointSize() 和setFontFamily()。

void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

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

另请参阅 QTextEdit::ExtraSelection 和extraSelections() 。

[slot] void QTextEdit::setFontFamily(const QString &fontFamily)

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

另请参阅 fontFamily() 和setCurrentFont()。

[slot] void QTextEdit::setFontItalic(bool italic)

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

另请参阅 fontItalic().

[slot] void QTextEdit::setFontPointSize(qreal s)

将当前格式的点尺寸设置为s 。

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

另请参阅 fontPointSize()、setCurrentFont() 和setFontFamily()。

[slot] void QTextEdit::setFontUnderline(bool underline)

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

另请参见 fontUnderline().

[slot] void QTextEdit::setFontWeight(int weight)

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

另请参阅 fontWeight()、setCurrentFont() 和setFontFamily()。

[slot] void QTextEdit::setPlainText(const QString &text)

将文本编辑器的文本更改为字符串text 。之前的文本将被删除。

注

• text 被解释为纯文本。
• 撤销/重做历史记录也会被清除。
• currentCharFormat除非textCursor() 已经位于文档开头，否则 () 将被重置。

另请参见 toPlainText()。

[slot] void QTextEdit::setText(const QString &text)

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

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

另请参阅 toPlainText() 和toHtml()。

[slot] void QTextEdit::setTextBackgroundColor(const QColor &c)

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

另请参阅 textBackgroundColor() 。

[slot] void QTextEdit::setTextColor(const QColor &c)

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

另请参阅 textColor() 。

void QTextEdit::setTextCursor(const QTextCursor &cursor)

设置可见cursor 。

另请参阅 textCursor() 。

[override virtual protected] void QTextEdit::showEvent(QShowEvent *)

重实现：QWidget::showEvent(QShowEvent *event).

QColor QTextEdit::textBackgroundColor() const

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

另请参见 setTextBackgroundColor()。

[signal] void QTextEdit::textChanged()

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

QColor QTextEdit::textColor() const

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

另请参阅 setTextColor()。

QTextCursor QTextEdit::textCursor() const

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

另请参阅 setTextCursor() 。

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() 常量

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

另请参阅 QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

撤销最后一次操作。

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

另请参见 redo()。

[signal] void QTextEdit::undoAvailable(bool available)

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

[override virtual protected] void QTextEdit::wheelEvent(QWheelEvent *e)

重实现：QAbstractScrollArea::wheelEvent(QWheelEvent *e)。

[slot] void QTextEdit::zoomIn(int range = 1)

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

另请参见 zoomOut()。

[slot] void QTextEdit::zoomOut(int range = 1)

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

另请参见 zoomIn()。