Qt多文本编辑器项目实战

0x00 引言

本文将详细讲解如何使用Qt实现一个多文本编辑器。涉及的话题包括：Qt框架基础、窗体布局、文本编辑、拓展功能等等。

在阅读本文之前，你需要掌握基本的C++编程知识和Qt框架的使用方法。

0x01 新建Qt项目

在Qt Creator中，新建一个Qt Widgets Application，选取项目名称和路径后直接点击下一步。

在下一个页面，根据自己的需要选取要使用的Qt版本，建议选取较新的版本以兼容更多的功能。接下来勾选要使用的模块，这个项目中需要用到Qt Widgets和Qt Gui两个模块。

最后，点击生成按钮完成新建项目的过程。

0x02 窗口布局

在Qt中，可以使用设计师来定制各种控件的布局，但这里我们将采用手动编写代码的方式实现窗口布局。

在代码中，创建一个继承自QWidget的MyWidget类。在这个类中实现窗口的各种控件，例如菜单栏、文本框、标签、按钮等等。

示例代码：

class MyWidget : public QWidget
{
    Q_OBJECT

public:
    MyWidget(QWidget *parent = nullptr);
    ~MyWidget();

private:
    QLabel *label;
    QTextEdit *text_edit;
    QPushButton *button;

    void init();
    void init_layout();
    void init_connections();
};

对于界面的布局和控件的设置，我们可以在init()函数中进行操作。具体实现如下：

老舅推荐：C++Qt项目教程（视频+代码）：Qt实战-word文档编辑器软件

Qt-MP3音乐播放器搜索引擎项目

如果你正在挑战Qt开发岗位

这里的每一个项目都能征服你的面试leader，斩获满意offer。

void MyWidget::init()
{
    label = new QLabel("文本编辑器", this);
    text_edit = new QTextEdit(this);
    button = new QPushButton("保存", this);

    init_layout();
    init_connections();
}

void MyWidget::init_layout()
{
    QVBoxLayout *main_layout = new QVBoxLayout(this);

    main_layout->addWidget(label);
    main_layout->addWidget(text_edit);
    main_layout->addWidget(button);
}

在这里，我们使用QVBoxLayout、QHBoxLayout等布局管理器来实现控件的布局和排列。

0x03 文本编辑

在多文本编辑器中，文本编辑是重中之重。使用Qt可以非常简单地实现文本编辑功能。在MyWidget类的init()函数中，通过new关键字创建一个QTextEdit对象以实现文本编辑。

text_edit = new QTextEdit(this);

在文本编辑的使用过程中，我们需要掌握QTextEdit对象的各种方法。

例如，设置文本内容：

text_edit->setText("hello world.");

设置文本样式：

QFont font("Times", 16, QFont::Bold);
text_edit->setFont(font);

获取文本内容：

QString text = text_edit->toPlainText();

保存文本内容：

QString filename = QFileDialog::getSaveFileName(this, tr("保存文件"), "", tr("文本文件 (*.txt)"));

if (!filename.isNull()) {
    QFile file(filename);
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QMessageBox::warning(this, tr("警告"), tr("无法保存文件：") + filename, QMessageBox::Ok);
    }
    QTextStream out(&file);
    out << text_edit->toPlainText();
}

更多QTextEdit的方法可以在Qt的官方文档中查看。

0x04 拓展功能

在多文本编辑器中，除了基本的文本编辑功能，还需要拓展一些常用的功能，如新建、打开、保存、撤销、重做等等。

我们在MyWidget类的init()函数中创建QPushButton对象，并在init_connections()中实现各种按钮的操作。

例如，打开文件：

void MyWidget::on_open_button_clicked()
{
    QString filename = QFileDialog::getOpenFileName(this, tr("打开文件"), "", tr("文本文件 (*.txt)"));

    if (!filename.isNull()) {
        QFile file(filename);
        if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
            QMessageBox::warning(this, tr("警告"), tr("无法打开文件：") + filename, QMessageBox::Ok);
        }
        QTextStream in(&file);
        text_edit->setText(in.readAll());
    }
}

更多拓展功能的代码可以在Qt之家的项目源码中查看。

0x05 总结

在本文中，我们通过实例演示了如何使用Qt框架创建一个多文本编辑器。其中，包括了新建Qt项目、窗口布局、文本编辑、拓展功能等多个方面。

在实际开发过程中，我们可以根据需求来拓展自己的功能，例如实现搜索、替换、拷贝、粘贴、恢复、查找等功能，以达到更好的使用体验。

示例1：使用QFileDialog类创建打开、保存文件的功能

void MyWidget::on_open_button_clicked()
{
    QString filename = QFileDialog::getOpenFileName(this, tr("打开文件"), "", tr("文本文件 (*.txt)"));

    if (!filename.isNull()) {
        QFile file(filename);
        if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
            QMessageBox::warning(this, tr("警告"), tr("无法打开文件：") + filename, QMessageBox::Ok);
        }
        QTextStream in(&file);
        text_edit->setText(in.readAll());
    }
}

void MyWidget::on_save_button_clicked()
{
    QString filename = QFileDialog::getSaveFileName(this, tr("保存文件"), "", tr("文本文件 (*.txt)"));

    if (!filename.isNull()) {
        QFile file(filename);
        if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
            QMessageBox::warning(this, tr("警告"), tr("无法保存文件：") + filename, QMessageBox::Ok);
        }
        QTextStream out(&file);
        out << text_edit->toPlainText();
    }
}

示例2：设置快捷键，使用Ctrl+S保存文件

void MyWidget::init_connections()
{
    connect(button, &QPushButton::clicked, this, &MyWidget::on_save_button_clicked);
    connect(text_edit, &QTextEdit::textChanged, this, &MyWidget::on_text_changed);
}

void MyWidget::on_save_button_clicked()
{
    QString filename = QFileDialog::getSaveFileName(this, tr("保存文件"), "", tr("文本文件 (*.txt)"));

    if (!filename.isNull()) {
        QFile file(filename);
        if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
            QMessageBox::warning(this, tr("警告"), tr("无法保存文件：") + filename, QMessageBox::Ok);
        }
        QTextStream out(&file);
        out << text_edit->toPlainText();
    }
}

void MyWidget::keyPressEvent(QKeyEvent *event)
{
    if (event->modifiers() == Qt::ControlModifier && event->key() == Qt::Key_S) {
        on_save_button_clicked();
    }
}

这里我们实现了一个快捷键，即使用Ctrl+S键保存文件。在keyPressEvent()函数中，我们捕捉用户的按键操作并执行自定义的操作。