QT编程(9): QTextEdit

一、QTextEdit核心定义与继承关系

QTextEdit是Qt框架中功能完备的富文本编辑与显示控件，属于Qt Widgets模块的核心组件，专门用于处理多行文本内容，同时支持纯文本与富文本格式，是Qt中处理复杂文本场景的首选控件。

继承体系：QTextEdit 继承自 QAbstractScrollArea，而 QTextBrowser 又继承自 QTextEdit，这意味着它天生自带滚动条功能，无需额外配置即可处理超长文本的滚动显示，适配不同窗口尺寸下的文本展示需求。

核心定位：兼顾编辑与展示双重用途，既可以作为用户可编辑的富文本编辑器，也能设置为只读模式，用于展示带格式的文档、日志、说明内容，经过优化后可高效处理大型文档，响应速度快，不会因文本量过大出现卡顿。

二、核心功能与特性

1. 文本格式全面支持

富文本支持：兼容HTML 4子集与Markdown格式，可直接通过HTML标签设置字体、字号、颜色、加粗、斜体、下划线、段落对齐、列表、表格，也能插入图片、超链接等富文本元素，实现类Word的基础排版效果。
纯文本模式：可通过setAcceptRichText(false)关闭富文本功能，切换为纯文本编辑模式，仅处理无格式普通文本，适配日志输入、代码编辑等无格式场景。
段落与字符级控制：以段落为基本单位（换行符分隔段落），每个字符、每个段落均可独立设置格式，支持精准的文本样式定制。

2. 内置编辑与交互功能

自带完整的编辑操作：复制、剪切、粘贴、撤销、重做、全选、查找替换，支持快捷键操作，无需额外编写代码实现基础编辑逻辑。
强大的光标控制：通过QTextCursor类实现精准的光标定位、文本选中、内容插入与删除，可灵活操作文本任意位置，适配复杂的文本编辑需求。
自动换行与滚动：默认按控件宽度自动换行，支持自定义换行模式（固定像素宽度、固定列数、不换行），超出可视区域自动显示水平/垂直滚动条。
拖拽支持：默认支持文本、HTML、富文本的拖拽插入，可重写相关方法扩展支持图片、文件等更多MIME类型的拖拽。

3. 实用配置属性

只读模式：setReadOnly(true)将控件设为只读，禁止用户编辑，仅用于展示内容，适合文档查看、日志展示场景。
占位文本：支持设置占位提示文字，控件为空时显示，引导用户输入内容。
撤销重做开关：可开启/关闭撤销重做功能，控制编辑历史记录。
文档管理：底层依托QTextDocument存储文本内容与格式，可独立操作文档对象，实现文档的加载、保存、修改状态监测。

三、核心常用API（C++版本）

使用前需引入头文件：#include <QTextEdit>，qmake项目需添加QT += widgets，CMake项目需链接Qt6::Widgets。

1. 文本设置与获取

API函数	功能说明
setPlainText(const QString& text)	设置纯文本内容，清空原有内容，不保留格式
toPlainText()	获取纯文本内容，忽略所有富文本格式
setHtml(const QString& html)	设置HTML格式富文本，清空原有内容与撤销历史
toHtml()	将内容转为HTML格式字符串返回
setMarkdown(const QString& md)	设置Markdown格式文本
append(const QString& text)	在文本末尾追加新段落，保留原有格式
clear()	清空所有文本内容

2. 格式与样式设置

setFontItalic(bool)、setFontUnderline(bool)、setFontWeight(int)：设置字体斜体、下划线、加粗
setFontFamily(const QString&)、setFontPointSize(qreal)：设置字体家族与字号
setTextColor(const QColor&)：设置文本颜色
setAlignment(Qt::Alignment)：设置段落对齐方式（左对齐、居中、右对齐、两端对齐）

3. 编辑与控制函数

undo()、redo()：撤销、重做上一步操作
copy()、cut()、paste()：复制、剪切、粘贴
selectAll()：全选文本
find(const QString&)：查找指定文本，支持查找标志配置（区分大小写、全词匹配）
textCursor()：获取当前光标对象，用于精准文本操作

4. 常用信号

textChanged()：文本内容发生变化时触发，实时监听内容改动
selectionChanged()：选中内容发生变化时触发
cursorPositionChanged()：光标位置改变时触发
currentCharFormatChanged()：当前字符格式改变时触发
undoAvailable(bool)、redoAvailable(bool)：撤销/重做可用状态改变时触发

四、适用场景

富文本编辑场景：笔记软件、邮件客户端正文编辑、文档编辑器、聊天窗口输入框
格式化展示场景：帮助文档查看、日志详情展示、富文本通知、代码注释展示
多行文本输入场景：备注输入、长篇内容编辑、配置文件编辑

五、QTextEdit与同类控件区别

1. QTextEdit vs QLineEdit

QLineEdit是单行纯文本输入框 ，仅支持简单文本输入，无格式、无滚动，适合用户名、密码、搜索词等短文本输入；QTextEdit是多行富文本编辑器，支持格式、滚动、复杂编辑，适合长篇、带格式文本。

2. QTextEdit vs QPlainTextEdit

QPlainTextEdit是纯文本多行编辑器，仅处理无格式文本，性能更优，适合代码编辑、日志查看等纯文本场景，不支持富文本；QTextEdit支持富文本，功能更全面，适合需要排版的文档场景，内存占用略高于QPlainTextEdit。

3. QTextEdit vs QTextBrowser

QTextBrowser是QTextEdit的子类，默认设为只读模式，额外支持超链接点击、锚点跳转，专门用于富文本内容展示，不可编辑；QTextEdit支持编辑，更灵活，可手动设为只读替代QTextBrowser。

六、简单使用示例

cpp 复制代码

// 创建QTextEdit控件
QTextEdit *textEdit = new QTextEdit(this);
// 设置初始富文本内容
textEdit->setHtml("<h3>Qt富文本示例</h3><p style='color:blue;'>这是一段蓝色带格式文本</p><ul><li>列表项1</li><li>列表项2</li></ul>");
// 设置为只读模式
textEdit->setReadOnly(true);
// 调整控件大小
textEdit->setGeometry(10, 10, 400, 300);
// 监听文本变化信号
connect(textEdit, &QTextEdit::textChanged, this, [=](){
    qDebug() << "文本内容已修改";
});

使用小贴士：处理大型纯文本日志时，优先选择QPlainTextEdit；需要富文本排版时用QTextEdit；仅展示富文本且需要链接跳转时，直接用QTextBrowser，可提升程序性能。