Qt6.5类库详解：QTextEdit

01 QTextEdit介绍

QTextEdit是一个文本编辑控件类，用于编辑和显示纯文本和富文本。

• QTextEdit的主要功能和特点：

富文本编辑与显示：QTextEdit支持富文本格式，可以显示和编辑带有各种字体、颜色和文字格式的文本。

处理大型文档：QTextEdit经过优化，可以处理大型文档并快速响应用户输入，适用于编辑长篇文章或大量文本。

HTML和Markdown支持：QTextEdit支持使用HTML风格的标签或Markdown格式的富文本格式化。

段落和字符级别控制：QTextEdit文本是基于段落和字符进行控制的，每个段落和字符都可以有自己的格式属性，如字体和颜色等。

显示图像、列表和表格：QTextEdit还可以显示图像、列表和表格，丰富文本编辑内容。

提供占位文本提示：QTextEdit支持设置占位文本，当编辑框内无内容时，可以显示预设的提示信息。

QTextEdit是一个功能丰富、性能优化的文本编辑控件，适用于各种需要处理文本的场合。

• 如何使用QTextEdit：

头文件：#include <QTextEdit>

cmake：find_package(Qt6 REQUIRED COMPONENTS Widgets)

targetlinklibraries(mytarget PRIVATE Qt6::Widgets)

qmake：QT += widgets

继承于：QAbstractScrollArea

02 QTextEdit默认风格显示例子

#include <QTextEdit>
// 创建 QTextEdit 控件。
m_pTextEdit = new QTextEdit(this);
m_pTextEdit->setGeometry(30, 30, 380, 128);
m_pTextEdit->setPlainText("这是一段 QTextEdit 示例文本。");

03 QTextEdit信号

// 当显示文本改变时，发射该信号。
void textChanged()
// 当允许撤销操作状态改变时，发射该信号；true表示允许撤销。
void undoAvailable(bool b)
// 当允许重做操作状态改变时，发射该信号；true表示允许重做。
void redoAvailable(bool b)
// 当前文本字符格式改变时，发射该信号。
void currentCharFormatChanged(const QTextCharFormat &format)
// 当允许复制操作状态改变时，发射该信号；true表示允许复制。
void copyAvailable(bool b)
// 当选择文本改变时，发射该信号。
void selectionChanged()
// 当前光标位置改变时，发射该信号。
void cursorPositionChanged()

04 QTextEdit属性和状态

• placeholderText占位符文本：

占位符文本一般用于在用户未输入任何内容时显示一些提示信息。

// 访问函数。
QString placeholderText() const
void setPlaceholderText(const QString &placeholderText)

/**** 例子： ****/
m_pTextEdit->setPlaceholderText("请输入备注说明。");

• isReadOnly是否只读模式：

false：编辑模式；文本编辑器。（默认）

true：只读模式；文本查看器。

// 访问函数。
bool isReadOnly