Qt-快速上手-QTextEdit

QTextEdit

头文件：#include <QTextEdit>

QTextEdit：富文本多行编辑框，支持纯文本、HTML 富文本，可换行，支持撤销 / 重做；区别于单行输入框 QLineEdit。

常用成员和方法

/**
 * @file QTextEdit
 * @brief 多行富文本编辑控件，支持纯文本与HTML格式
 * @details QTextEdit 是多行文本输入/显示组件，支持换行、富文本、撤销重做。
 * 既可以作为用户输入编辑器，也可以做只读文本展示。
 * 底层文档模型为 QTextDocument；光标对象 QTextCursor 用来操作文本选区。
 * @note QLineEdit 为单行输入；QTextEdit 多行；QPlainTextEdit 轻量纯文本多行控件。
 * @sa QLineEdit QPlainTextEdit QTextDocument QTextCursor
 */

/**
 * @class QTextEdit
 * @brief 多行富文本编辑器
 *
 * ## 重要概念
 * - 纯文本：普通字符串，get/setText()
 * - 富文本(HTML)：支持颜色、字体、表格，toHtml() / setHtml()
 * - QTextDocument：存储全部文档数据
 * - QTextCursor：光标，用来选中、插入、删除文本
 *
 * ## 常用信号
 * @li textChanged() 文档内容发生改变时触发（输入、粘贴、代码修改文本都会触发）
 * @li selectionChanged() 选中区域发生变化
 * @li cursorPositionChanged() 光标位置移动
 */
class QTextEdit : public QAbstractScrollArea
{
public:
    /**
     * @brief 无参构造
     * @param parent 父窗口
     */
    explicit QTextEdit(QWidget *parent = nullptr);

    /**
     * @brief 构造时设置初始文本
     * @param text 初始文本，可以是纯文本，也可以是html片段
     * @param parent 父窗口
     */
    explicit QTextEdit(const QString &text, QWidget *parent = nullptr);

    /**
     * @brief 设置纯文本内容，会清空原有全部内容
     * @param text 普通字符串，不会解析html标签
     * @note 如果传入html字符串，标签会原样显示出来
     */
    void setPlainText(const QString &text);

    /**
     * @brief 获取编辑器内的纯文本，剥离所有html标记
     * @return QString 纯文本
     */
    QString toPlainText() const;

    /**
     * @brief 设置富文本HTML内容，会解析html标签实现颜色、字体、换行
     * @param html html格式字符串
     */
    void setHtml(const QString &html);

    /**
     * @brief 获取当前文档的HTML富文本
     * @return QString html字符串
     */
    QString toHtml() const;

    /**
     * @brief 追加纯文本到文档末尾，保留原有内容，自动换行
     * @param text 需要追加的普通文本
     */
    void append(const QString &text);

    /**
     * @brief 设置控件只读模式，只读时用户不能编辑，只能查看复制
     * @param true为只读；false可编辑
     */
    void setReadOnly(bool readOnly);

    /**
     * @brief 判断当前是否为只读模式
     * @return bool
     */
    bool isReadOnly() const;

    /**
     * @brief 获取文档对象，底层文本数据载体
     * @return QTextDocument*
     */
    QTextDocument *document() const;

    /**
     * @brief 获取光标对象，用于操作选中、插入文本
     * @return QTextCursor
     */
    QTextCursor textCursor() const;

    /**
     * @brief 设置光标
     * @param cursor QTextCursor对象
     */
    void setTextCursor(const QTextCursor &cursor);

    /**
     * @brief 判断是否有选中文本
     * @return true存在选中区域
     */
    bool hasSelectedText() const;

    /**
     * @brief 获取选中的纯文本
     * @return QString
     */
    QString selectedText() const;

    /**
     * @brief 清空全部内容
     */
    void clear();

    /**
     * @brief 设置文本字体
     * @param font QFont字体对象
     */
    void setFont(const QFont &font);

public Q_SLOTS:
    /**
     * @brief 撤销上一步操作
     */
    void undo();

    /**
     * @brief 重做被撤销的操作
     */
    void redo();

    /**
     * @brief 复制选中内容到剪贴板
     */
    void copy();

    /**
     * @brief 剪切选中内容到剪贴板
     */
    void cut();

    /**
     * @brief 粘贴剪贴板内容
     */
    void paste();

Q_SIGNALS:
    /**
     * @brief 文档内容发生变化触发，用户输入或者代码修改文本都会触发
     * @note setPlainText / append / 用户打字都会触发该信号
     */
    void textChanged();

    /**
     * @brief 光标位置发生改变触发
     */
    void cursorPositionChanged();

    /**
     * @brief 文本选中区域发生变化触发
     */
    void selectionChanged();
};

快速上手

练习 1：基础读写文本

需求：

• 按钮 1：设置纯文本 setPlainText("Hello Qt\nQTextEdit测试")
• 按钮 2：读取编辑框纯文本，用状态栏展示内容（注意内容太长状态栏会截断）
• 按钮 3：清空编辑框 clear()

//按钮1
connect(ui->btnSetText, &QPushButton::clicked, this,[=](){
    ui->textEdit->setPlainText("Hello Qt\nQTextEdit测试");
});
//按钮2
connect(ui->btnGetText, &QPushButton::clicked, this,[=](){
    QString txt = ui->textEdit->toPlainText();
    statusBar()->showMessage(txt,3000);
});
//按钮3
connect(ui->btnClear, &QPushButton::clicked, this,[=](){
    ui->textEdit->clear();
});

练习 2：append 追加日志

需求：

点击按钮，使用append()追加一行日志：2026‑08‑14 用户执行操作，多次点击不断累加，不清旧内容。

connect(ui->btnAppend,&QPushButton::clicked,this,[=](){
    ui->textEdit->append("2026‑08‑14 用户执行操作");
});

练习 3：HTML 富文本

需求：

点击按钮调用setHtml()，设置带颜色的富文本：

<h3>富文本测试</h3><p><font color="red">红色文字</font></p>

connect(ui->btnHtml,&QPushButton::clicked,this,[=](){
    QString html = R"(
        <h3>富文本测试</h3>
        <p><font color="red">红色文字</font></p>
    )";
    ui->textEdit->setHtml(html);
});

练习 4：只读模式

两个按钮：设置只读、取消只读。

• 只读模式用户只能看不能输入修改。

connect(ui->btnSetReadOnly,&QPushButton::clicked,this,[=](){
    ui->textEdit->setReadOnly(true);
    statusBar()->showMessage("设置为只读",2000);
});
connect(ui->btnCancelReadOnly,&QPushButton::clicked,this,[=](){
    ui->textEdit->setReadOnly(false);
    statusBar()->showMessage("取消只读",2000);
});

练习 5：信号 textChanged 监听输入变化

需求：当 QTextEdit 内容发生改变，状态栏显示提示：文本已被修改。

connect(ui->textEdit,&QTextEdit::textChanged,this,[=](){
    statusBar()->showMessage("文本已被修改",2000);
});

练习 6：获取选中文字

需求：鼠标选中一段文字，点击按钮，弹窗弹出选中的文本；没有选中则弹窗提示 “未选中文本”。

connect(ui->btnGetSelect,&QPushButton::clicked,this,[=](){
    if(ui->textEdit->textCursor().hasSelectedText())
    {
        QString sel = ui->textEdit->textCursor().selectedText();
        QMessageBox::information(this,"选中内容",sel);
    }
    else
    {
        QMessageBox::warning(this,"提示","未选中文本");
    }
});