qt QTextEdit用法总结

news/2025/2/20 11:27:49/

1. 基本介绍

QTextEdit 是 Qt 中用于显示和编辑富文本（支持 HTML 子集）和纯文本的控件。
支持文本格式（字体、颜色、对齐）、列表、表格、图片插入等富文本功能。
底层通过 QTextDocument 管理内容，提供强大的文本处理能力。

2. 核心功能

文本操作：插入、删除、修改文本，支持撤销/重做。
格式控制：字体、字号、颜色、粗体/斜体/下划线、对齐方式等。
富文本支持：通过 HTML/CSS 渲染内容（如粗体）。
光标操作：通过 QTextCursor 精细控制文本插入、选择和格式。
滚动与换行：自动换行、滚动条控制。

3. 常用方法

// 文本内容操作
setText("Hello World");      // 设置纯文本
append("New line");          // 追加文本
QString text = toPlainText();// 获取纯文本
QString html = toHtml();     // 获取 HTML 内容// 格式设置
setFontFamily("Arial");               // 设置字体
setFontPointSize(12);                 // 字号
setTextColor(Qt::red);                // 文字颜色
setAlignment(Qt::AlignCenter);        // 居中对齐// 光标操作
QTextCursor cursor = textCursor();
cursor.insertText("Inserted Text");   // 插入文本
cursor.insertImage("image.png");      // 插入图片// 查找与替换
find("searchText");                   // 查找文本

find(“searchText”); // 查找文本

4. 关键信号

textChanged()：文本内容变化时触发。
selectionChanged()：选中文本变化时触发。
cursorPositionChanged()：光标位置变化时触发。

5. 高级功能

语法高亮：继承 QSyntaxHighlighter 实现自定义高亮规则。
插入复杂对象：表格、列表、图片、超链接。

cursor.insertTable(2, 2); // 插入 2x2 表格
cursor.insertHtml("<a href='https://example.com'>Link</a>");

打印支持：通过 QTextDocument 导出为 PDF 或打印。
自定义样式：使用 CSS 样式表修改控件外观

setStyleSheet("QTextEdit { border: 2px solid gray; }");

6. 与 QPlainTextEdit 的区别

特性	QTextEdit	QPlainTextEdit
文本类型	富文本 + 纯文本	纯文本
性能	适合中小规模文本	适合大规模文本（更高效）
王格式支持五	支持字体、颜色、图片等	仅基础格式（如换行）
使用场景	富文本编辑器、邮件客户端	日志显示、代码编辑器

7. 注意事项

性能：处理超长文本时优先考虑 QPlainTextEdit。
HTML 支持限制：并非所有 HTML 标签都有效（如 JavaScript）。
光标操作：通过 QTextCursor 实现复杂编辑（如选中多行）。

8. 简单示例

// 创建 QTextEdit 并设置基础属性
QTextEdit *edit = new QTextEdit;
edit->setPlainText("Initial Text");
edit->setFontUnderline(true);
edit->setLineWrapMode(QTextEdit::WidgetWidth); // 自动换行// 响应文本变化
connect(edit, &QTextEdit::textChanged, []() {qDebug() << "Text changed!";
});