深入浅出Linux平台下Qt图形界面编程从入门到精通的完整学习路径掌握核心技能打造专业级桌面应用实战案例分析解决常见开发难题

威震华夏关云长

引言

Qt是一个跨平台的C++图形用户界面应用程序开发框架，它不仅提供了创建图形界面所需的各种组件，还包括了数据库、网络、多线程、XML、OpenGL等众多功能模块。在Linux平台上，Qt是开发桌面应用程序的首选框架之一，KDE桌面环境就是基于Qt构建的。本文将带你从零开始，系统学习Linux平台下的Qt图形界面编程，逐步掌握核心技能，最终能够开发出专业级的桌面应用程序。

一、Qt入门基础

1.1 环境搭建

在Linux系统中安装Qt开发环境非常简单。以Ubuntu为例，你可以通过以下命令安装Qt5开发工具：

2. sudo apt update
3. sudo apt install qt5-default qtcreator qtdeclarative5-dev qtbase5-dev-tools

复制代码

安装完成后，你可以从应用程序菜单中启动Qt Creator，这是Qt官方提供的集成开发环境(IDE)，集成了代码编辑器、可视化界面设计器、调试器和构建工具。

1.2 Qt基本概念

在开始编写Qt程序之前，需要了解几个基本概念：

• QObject：所有Qt对象的基类，提供了对象树、信号槽等核心功能。
• QWidget：所有用户界面对象的基类，是Qt窗口系统的基础。
• QApplication：管理GUI应用程序的控制流和主要设置。
• 信号与槽(Signals & Slots)：Qt的核心机制，用于对象之间的通信。
• 布局管理(Layout Management)：自动排列和管理界面上的控件。

1.3 第一个Qt程序

让我们创建一个简单的”Hello World”程序，体验Qt的基本开发流程。

在Qt Creator中创建一个新的Qt Widgets Application项目，然后修改main.cpp文件：

2. #include <QApplication>
3. #include <QLabel>
4. #include <QWidget>
5. #include <QVBoxLayout>
7. int main(int argc, char *argv[])
8. {
9.     QApplication app(argc, argv);
10.    
11.     // 创建主窗口
12.     QWidget window;
13.     window.setWindowTitle("Hello Qt");
14.     window.resize(300, 200);
15.    
16.     // 创建标签控件
17.     QLabel *label = new QLabel("Hello, World!");
18.     label->setAlignment(Qt::AlignCenter);
19.    
20.     // 创建布局并添加标签
21.     QVBoxLayout *layout = new QVBoxLayout;
22.     layout->addWidget(label);
23.    
24.     // 设置窗口的布局
25.     window.setLayout(layout);
26.    
27.     // 显示窗口
28.     window.show();
29.    
30.     return app.exec();
31. }

复制代码

这个程序创建了一个简单的窗口，其中包含一个居中显示的”Hello, World!“标签。编译并运行这个程序，你将看到一个基本的GUI窗口。

二、Qt核心技能

2.1 信号与槽机制

信号与槽是Qt的核心特性，它允许对象之间的通信，是实现事件驱动编程的基础。当一个对象的状态发生变化时，它会发出一个信号；其他对象可以连接到这个信号，并通过槽函数来响应这个变化。

让我们通过一个简单的例子来理解信号与槽：

2. #include <QApplication>
3. #include <QPushButton>
4. #include <QMessageBox>
5. #include <QVBoxLayout>
6. #include <QWidget>
8. int main(int argc, char *argv[])
9. {
10.     QApplication app(argc, argv);
11.    
12.     QWidget window;
13.     window.setWindowTitle("信号与槽示例");
14.     window.resize(300, 200);
15.    
16.     QPushButton *button = new QPushButton("点击我");
17.    
18.     // 连接按钮的clicked信号到QMessageBox的静态槽函数
19.     QObject::connect(button, &QPushButton::clicked, []() {
20.         QMessageBox::information(nullptr, "消息", "按钮被点击了！");
21.     });
22.    
23.     QVBoxLayout *layout = new QVBoxLayout;
24.     layout->addWidget(button);
25.    
26.     window.setLayout(layout);
27.     window.show();
28.    
29.     return app.exec();
30. }

复制代码

在这个例子中，当用户点击按钮时，按钮会发出clicked信号，我们连接到一个lambda表达式（作为槽函数），该函数会显示一个消息框。

2.2 布局管理

Qt提供了多种布局管理器，帮助开发者自动排列和管理界面上的控件。常用的布局管理器包括：

• QHBoxLayout：水平布局，将控件从左到右排列。
• QVBoxLayout：垂直布局，将控件从上到下排列。
• QGridLayout：网格布局，将控件排列在网格中。
• QFormLayout：表单布局，适用于标签和字段的排列。

下面是一个使用多种布局的示例：

2. #include <QApplication>
3. #include <QWidget>
4. #include <QPushButton>
5. #include <QLineEdit>
6. #include <QLabel>
7. #include <QVBoxLayout>
8. #include <QHBoxLayout>
9. #include <QGridLayout>
10. #include <QGroupBox>
12. int main(int argc, char *argv[])
13. {
14.     QApplication app(argc, argv);
15.    
16.     QWidget window;
17.     window.setWindowTitle("布局管理示例");
18.     window.resize(400, 300);
19.    
20.     // 主垂直布局
21.     QVBoxLayout *mainLayout = new QVBoxLayout;
22.    
23.     // 第一组：水平布局
24.     QGroupBox *horizontalGroup = new QGroupBox("水平布局");
25.     QHBoxLayout *hLayout = new QHBoxLayout;
26.    
27.     for (int i = 1; i <= 3; ++i) {
28.         QPushButton *button = new QPushButton(QString("按钮 %1").arg(i));
29.         hLayout->addWidget(button);
30.     }
31.    
32.     horizontalGroup->setLayout(hLayout);
33.     mainLayout->addWidget(horizontalGroup);
34.    
35.     // 第二组：网格布局
36.     QGroupBox *gridGroup = new QGroupBox("网格布局");
37.     QGridLayout *gLayout = new QGridLayout;
38.    
39.     gLayout->addWidget(new QLabel("用户名:"), 0, 0);
40.     gLayout->addWidget(new QLineEdit(), 0, 1);
41.     gLayout->addWidget(new QLabel("密码:"), 1, 0);
42.     gLayout->addWidget(new QLineEdit(), 1, 1);
43.    
44.     QPushButton *loginButton = new QPushButton("登录");
45.     gLayout->addWidget(loginButton, 2, 0, 1, 2);
46.    
47.     gridGroup->setLayout(gLayout);
48.     mainLayout->addWidget(gridGroup);
49.    
50.     window.setLayout(mainLayout);
51.     window.show();
52.    
53.     return app.exec();
54. }

复制代码

这个示例展示了如何在窗口中使用水平布局和网格布局来组织控件。

2.3 常用控件

Qt提供了丰富的标准控件，下面介绍一些常用的控件及其基本用法：

2. #include <QApplication>
3. #include <QWidget>
4. #include <QPushButton>
5. #include <QCheckBox>
6. #include <QRadioButton>
7. #include <QButtonGroup>
8. #include <QVBoxLayout>
9. #include <QDebug>
11. int main(int argc, char *argv[])
12. {
13.     QApplication app(argc, argv);
14.    
15.     QWidget window;
16.     window.setWindowTitle("按钮控件示例");
17.    
18.     QVBoxLayout *layout = new QVBoxLayout;
19.    
20.     // 普通按钮
21.     QPushButton *pushButton = new QPushButton("普通按钮");
22.     QObject::connect(pushButton, &QPushButton::clicked, []() {
23.         qDebug() << "普通按钮被点击";
24.     });
25.     layout->addWidget(pushButton);
26.    
27.     // 复选框
28.     QCheckBox *checkBox = new QCheckBox("复选框");
29.     QObject::connect(checkBox, &QCheckBox::stateChanged, [](int state) {
30.         qDebug() << "复选框状态改变:" << (state == Qt::Checked ? "选中" : "未选中");
31.     });
32.     layout->addWidget(checkBox);
33.    
34.     // 单选按钮
35.     QButtonGroup *radioGroup = new QButtonGroup;
36.     QRadioButton *radio1 = new QRadioButton("选项1");
37.     QRadioButton *radio2 = new QRadioButton("选项2");
38.     radioGroup->addButton(radio1);
39.     radioGroup->addButton(radio2);
40.    
41.     QObject::connect(radioGroup, QOverload<QAbstractButton*>::of(&QButtonGroup::buttonClicked), [](QAbstractButton *button) {
42.         qDebug() << "单选按钮被点击:" << button->text();
43.     });
44.    
45.     layout->addWidget(radio1);
46.     layout->addWidget(radio2);
47.    
48.     window.setLayout(layout);
49.     window.show();
50.    
51.     return app.exec();
52. }

复制代码

2. #include <QApplication>
3. #include <QWidget>
4. #include <QLineEdit>
5. #include <QTextEdit>
6. #include <QSpinBox>
7. #include <QComboBox>
8. #include <QSlider>
9. #include <QLabel>
10. #include <QVBoxLayout>
11. #include <QDebug>
13. int main(int argc, char *argv[])
14. {
15.     QApplication app(argc, argv);
16.    
17.     QWidget window;
18.     window.setWindowTitle("输入控件示例");
19.    
20.     QVBoxLayout *layout = new QVBoxLayout;
21.    
22.     // 单行文本输入
23.     QLineEdit *lineEdit = new QLineEdit;
24.     lineEdit->setPlaceholderText("请输入文本");
25.     QObject::connect(lineEdit, &QLineEdit::textChanged, [](const QString &text) {
26.         qDebug() << "文本改变:" << text;
27.     });
28.     layout->addWidget(new QLabel("单行文本输入:"));
29.     layout->addWidget(lineEdit);
30.    
31.     // 多行文本输入
32.     QTextEdit *textEdit = new QTextEdit;
33.     textEdit->setPlaceholderText("请输入多行文本");
34.     layout->addWidget(new QLabel("多行文本输入:"));
35.     layout->addWidget(textEdit);
36.    
37.     // 数字输入
38.     QSpinBox *spinBox = new QSpinBox;
39.     spinBox->setRange(0, 100);
40.     spinBox->setValue(50);
41.     layout->addWidget(new QLabel("数字输入:"));
42.     layout->addWidget(spinBox);
43.    
44.     // 下拉框
45.     QComboBox *comboBox = new QComboBox;
46.     comboBox->addItem("选项1");
47.     comboBox->addItem("选项2");
48.     comboBox->addItem("选项3");
49.     layout->addWidget(new QLabel("下拉框:"));
50.     layout->addWidget(comboBox);
51.    
52.     // 滑块
53.     QSlider *slider = new QSlider(Qt::Horizontal);
54.     slider->setRange(0, 100);
55.     slider->setValue(50);
56.     layout->addWidget(new QLabel("滑块:"));
57.     layout->addWidget(slider);
58.    
59.     window.setLayout(layout);
60.     window.show();
61.    
62.     return app.exec();
63. }

复制代码

2. #include <QApplication>
3. #include <QWidget>
4. #include <QLabel>
5. #include <QProgressBar>
6. #include <QLCDNumber>
7. #include <QPixmap>
8. #include <QVBoxLayout>
9. #include <QTimer>
11. int main(int argc, char *argv[])
12. {
13.     QApplication app(argc, argv);
14.    
15.     QWidget window;
16.     window.setWindowTitle("显示控件示例");
17.    
18.     QVBoxLayout *layout = new QVBoxLayout;
19.    
20.     // 标签
21.     QLabel *label = new QLabel("这是一个标签");
22.     label->setAlignment(Qt::AlignCenter);
23.     layout->addWidget(label);
24.    
25.     // 进度条
26.     QProgressBar *progressBar = new QProgressBar;
27.     progressBar->setRange(0, 100);
28.     progressBar->setValue(0);
29.     layout->addWidget(new QLabel("进度条:"));
30.     layout->addWidget(progressBar);
31.    
32.     // LCD数字显示
33.     QLCDNumber *lcdNumber = new QLCDNumber;
34.     lcdNumber->setSegmentStyle(QLCDNumber::Flat);
35.     lcdNumber->display(0);
36.     layout->addWidget(new QLabel("LCD数字:"));
37.     layout->addWidget(lcdNumber);
38.    
39.     // 图片显示
40.     QLabel *imageLabel = new QLabel;
41.     QPixmap pixmap(":/images/sample.png"); // 假设有一个资源文件
42.     if (!pixmap.isNull()) {
43.         imageLabel->setPixmap(pixmap.scaled(200, 200, Qt::KeepAspectRatio));
44.         imageLabel->setAlignment(Qt::AlignCenter);
45.     } else {
46.         imageLabel->setText("无法加载图片");
47.         imageLabel->setAlignment(Qt::AlignCenter);
48.     }
49.     layout->addWidget(new QLabel("图片显示:"));
50.     layout->addWidget(imageLabel);
51.    
52.     // 设置定时器更新进度条和LCD数字
53.     QTimer timer;
54.     int value = 0;
55.     QObject::connect(&timer, &QTimer::timeout, [&]() {
56.         value = (value + 1) % 101;
57.         progressBar->setValue(value);
58.         lcdNumber->display(value);
59.     });
60.     timer.start(100);
61.    
62.     window.setLayout(layout);
63.     window.show();
64.    
65.     return app.exec();
66. }

复制代码

三、Qt进阶主题

3.1 自定义控件

虽然Qt提供了丰富的标准控件，但有时我们需要创建自定义控件来满足特定需求。自定义控件通常通过继承现有的Qt控件或直接继承QWidget来实现。

下面是一个自定义圆形进度条的例子：

2. // circularprogressbar.h
3. #ifndef CIRCULARPROGRESSBAR_H
4. #define CIRCULARPROGRESSBAR_H
6. #include <QWidget>
7. #include <QPainter>
9. class CircularProgressBar : public QWidget
10. {
11.     Q_OBJECT
12.     Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)
13.     Q_PROPERTY(int minimum READ minimum WRITE setMinimum)
14.     Q_PROPERTY(int maximum READ maximum WRITE setMaximum)
16. public:
17.     explicit CircularProgressBar(QWidget *parent = nullptr);
18.    
19.     int value() const;
20.     int minimum() const;
21.     int maximum() const;
22.    
23. public slots:
24.     void setValue(int value);
25.     void setMinimum(int min);
26.     void setMaximum(int max);
27.    
28. signals:
29.     void valueChanged(int value);
30.    
31. protected:
32.     void paintEvent(QPaintEvent *event) override;
33.    
34. private:
35.     int m_value;
36.     int m_minimum;
37.     int m_maximum;
38. };
40. #endif // CIRCULARPROGRESSBAR_H

复制代码

2. // circularprogressbar.cpp
3. #include "circularprogressbar.h"
4. #include <QPainter>
5. #include <QTimer>
7. CircularProgressBar::CircularProgressBar(QWidget *parent) : QWidget(parent),
8.     m_value(0),
9.     m_minimum(0),
10.     m_maximum(100)
11. {
12.     setMinimumSize(100, 100);
13. }
15. int CircularProgressBar::value() const
16. {
17.     return m_value;
18. }
20. int CircularProgressBar::minimum() const
21. {
22.     return m_minimum;
23. }
25. int CircularProgressBar::maximum() const
26. {
27.     return m_maximum;
28. }
30. void CircularProgressBar::setValue(int value)
31. {
32.     if (m_value != value) {
33.         m_value = qBound(m_minimum, value, m_maximum);
34.         update(); // 触发重绘
35.         emit valueChanged(m_value);
36.     }
37. }
39. void CircularProgressBar::setMinimum(int min)
40. {
41.     if (m_minimum != min) {
42.         m_minimum = min;
43.         if (m_value < m_minimum) {
44.             setValue(m_minimum);
45.         }
46.         update();
47.     }
48. }
50. void CircularProgressBar::setMaximum(int max)
51. {
52.     if (m_maximum != max) {
53.         m_maximum = max;
54.         if (m_value > m_maximum) {
55.             setValue(m_maximum);
56.         }
57.         update();
58.     }
59. }
61. void CircularProgressBar::paintEvent(QPaintEvent *event)
62. {
63.     Q_UNUSED(event);
64.    
65.     QPainter painter(this);
66.     painter.setRenderHint(QPainter::Antialiasing);
67.    
68.     // 计算绘制区域
69.     int side = qMin(width(), height());
70.     painter.setViewport((width() - side) / 2, (height() - side) / 2, side, side);
71.     painter.setWindow(0, 0, 100, 100);
72.    
73.     // 绘制背景圆环
74.     painter.setPen(QPen(Qt::lightGray, 5, Qt::SolidLine, Qt::RoundCap));
75.     painter.drawArc(10, 10, 80, 80, 30 * 16, 390 * 16);
76.    
77.     // 计算进度角度
78.     double percentage = static_cast<double>(m_value - m_minimum) / (m_maximum - m_minimum);
79.     int progressAngle = static_cast<int>(percentage * 390);
80.    
81.     // 绘制进度圆环
82.     painter.setPen(QPen(Qt::blue, 5, Qt::SolidLine, Qt::RoundCap));
83.     painter.drawArc(10, 10, 80, 80, 30 * 16, progressAngle * 16);
84.    
85.     // 绘制进度文本
86.     painter.setPen(Qt::black);
87.     QFont font = painter.font();
88.     font.setBold(true);
89.     font.setPointSize(10);
90.     painter.setFont(font);
91.     painter.drawText(0, 0, 100, 100, Qt::AlignCenter,
92.                    QString("%1%").arg(static_cast<int>(percentage * 100)));
93. }

复制代码

使用自定义控件的示例：

2. #include <QApplication>
3. #include <QWidget>
4. #include <QVBoxLayout>
5. #include <QPushButton>
6. #include "circularprogressbar.h"
8. int main(int argc, char *argv[])
9. {
10.     QApplication app(argc, argv);
11.    
12.     QWidget window;
13.     window.setWindowTitle("自定义控件示例");
14.     window.resize(300, 400);
15.    
16.     QVBoxLayout *layout = new QVBoxLayout;
17.    
18.     // 创建自定义圆形进度条
19.     CircularProgressBar *progressBar = new CircularProgressBar;
20.     progressBar->setMinimum(0);
21.     progressBar->setMaximum(100);
22.     progressBar->setValue(30);
23.     layout->addWidget(progressBar);
24.    
25.     // 添加按钮来改变进度
26.     QPushButton *button = new QPushButton("增加进度");
27.     layout->addWidget(button);
28.    
29.     // 连接按钮点击信号到进度条
30.     QObject::connect(button, &QPushButton::clicked, [progressBar]() {
31.         int newValue = progressBar->value() + 10;
32.         if (newValue > progressBar->maximum()) {
33.             newValue = progressBar->minimum();
34.         }
35.         progressBar->setValue(newValue);
36.     });
37.    
38.     window.setLayout(layout);
39.     window.show();
40.    
41.     return app.exec();
42. }

复制代码

3.2 模型视图编程

Qt的模型/视图架构是一种用于显示和编辑数据的方式，它将数据存储（模型）和数据表示（视图）分离。这种架构使得同一份数据可以用不同的方式显示，并且不需要修改数据源代码。

下面是一个使用模型/视图架构显示表格数据的例子：

2. #include <QApplication>
3. #include <QTableView>
4. #include <QStandardItemModel>
5. #include <QHeaderView>
6. #include <QVBoxLayout>
7. #include <QWidget>
9. int main(int argc, char *argv[])
10. {
11.     QApplication app(argc, argv);
12.    
13.     QWidget window;
14.     window.setWindowTitle("模型视图编程示例");
15.     window.resize(600, 400);
16.    
17.     QVBoxLayout *layout = new QVBoxLayout;
18.    
19.     // 创建标准项模型
20.     QStandardItemModel *model = new QStandardItemModel(&window);
21.     model->setColumnCount(3);
22.     model->setRowCount(5);
23.    
24.     // 设置表头
25.     model->setHorizontalHeaderLabels({"姓名", "年龄", "职业"});
26.    
27.     // 填充数据
28.     QList<QString> names = {"张三", "李四", "王五", "赵六", "钱七"};
29.     QList<int> ages = {25, 30, 35, 28, 32};
30.     QList<QString> jobs = {"工程师", "医生", "教师", "律师", "设计师"};
31.    
32.     for (int row = 0; row < 5; ++row) {
33.         QStandardItem *nameItem = new QStandardItem(names[row]);
34.         QStandardItem *ageItem = new QStandardItem(QString::number(ages[row]));
35.         QStandardItem *jobItem = new QStandardItem(jobs[row]);
36.         
37.         model->setItem(row, 0, nameItem);
38.         model->setItem(row, 1, ageItem);
39.         model->setItem(row, 2, jobItem);
40.     }
41.    
42.     // 创建表格视图并设置模型
43.     QTableView *tableView = new QTableView;
44.     tableView->setModel(model);
45.    
46.     // 设置表头属性
47.     tableView->horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);
48.     tableView->verticalHeader()->setVisible(false);
49.    
50.     // 设置选择行为
51.     tableView->setSelectionBehavior(QAbstractItemView::SelectRows);
52.     tableView->setSelectionMode(QAbstractItemView::SingleSelection);
53.    
54.     layout->addWidget(tableView);
55.     window.setLayout(layout);
56.     window.show();
57.    
58.     return app.exec();
59. }

复制代码

3.3 多线程编程

在GUI应用程序中，耗时的操作（如文件读写、网络请求、复杂计算等）如果在主线程中执行，会导致界面冻结，影响用户体验。Qt提供了QThread类和相关的类来支持多线程编程。

下面是一个使用多线程执行耗时任务的例子：

2. // worker.h
3. #ifndef WORKER_H
4. #define WORKER_H
6. #include <QObject>
7. #include <QRunnable>
9. class Worker : public QObject, public QRunnable
10. {
11.     Q_OBJECT
12. public:
13.     explicit Worker(QObject *parent = nullptr);
14.    
15.     void run() override;
16.    
17. signals:
18.     void progressChanged(int value);
19.     void finished(const QString &result);
20.    
21. public slots:
22.     void cancel();
23.    
24. private:
25.     bool m_cancelled;
26. };
28. #endif // WORKER_H

复制代码

2. // worker.cpp
3. #include "worker.h"
4. #include <QThread>
5. #include <QDebug>
7. Worker::Worker(QObject *parent) : QObject(parent), m_cancelled(false)
8. {
9.     setAutoDelete(true); // 任务完成后自动删除
10. }
12. void Worker::run()
13. {
14.     QString result;
15.    
16.     for (int i = 0; i <= 100; ++i) {
17.         if (m_cancelled) {
18.             result = "任务被取消";
19.             break;
20.         }
21.         
22.         // 模拟耗时操作
23.         QThread::msleep(50);
24.         
25.         // 发送进度信号
26.         emit progressChanged(i);
27.         
28.         // 构建结果字符串
29.         if (i == 100) {
30.             result = "任务完成";
31.         }
32.     }
33.    
34.     // 发送完成信号
35.     emit finished(result);
36. }
38. void Worker::cancel()
39. {
40.     m_cancelled = true;
41. }

复制代码

2. // main.cpp
3. #include <QApplication>
4. #include <QWidget>
5. #include <QVBoxLayout>
6. #include <QPushButton>
7. #include <QProgressBar>
8. #include <QLabel>
9. #include <QThreadPool>
10. #include "worker.h"
12. int main(int argc, char *argv[])
13. {
14.     QApplication app(argc, argv);
15.    
16.     QWidget window;
17.     window.setWindowTitle("多线程编程示例");
18.     window.resize(400, 200);
19.    
20.     QVBoxLayout *layout = new QVBoxLayout;
21.    
22.     QProgressBar *progressBar = new QProgressBar;
23.     progressBar->setRange(0, 100);
24.     progressBar->setValue(0);
25.    
26.     QLabel *statusLabel = new QLabel("准备就绪");
27.    
28.     QPushButton *startButton = new QPushButton("开始任务");
29.     QPushButton *cancelButton = new QPushButton("取消任务");
30.     cancelButton->setEnabled(false);
31.    
32.     Worker *worker = nullptr;
33.    
34.     QObject::connect(startButton, &QPushButton::clicked, [&]() {
35.         // 创建工作线程
36.         worker = new Worker;
37.         
38.         // 连接信号槽
39.         QObject::connect(worker, &Worker::progressChanged, progressBar, &QProgressBar::setValue);
40.         QObject::connect(worker, &Worker::finished, [=](const QString &result) {
41.             statusLabel->setText(result);
42.             startButton->setEnabled(true);
43.             cancelButton->setEnabled(false);
44.         });
45.         
46.         // 启动线程
47.         QThreadPool::globalInstance()->start(worker);
48.         
49.         // 更新UI状态
50.         startButton->setEnabled(false);
51.         cancelButton->setEnabled(true);
52.         statusLabel->setText("任务进行中...");
53.     });
54.    
55.     QObject::connect(cancelButton, &QPushButton::clicked, [&]() {
56.         if (worker) {
57.             worker->cancel();
58.         }
59.     });
60.    
61.     layout->addWidget(progressBar);
62.     layout->addWidget(statusLabel);
63.     layout->addWidget(startButton);
64.     layout->addWidget(cancelButton);
65.    
66.     window.setLayout(layout);
67.     window.show();
68.    
69.     return app.exec();
70. }

复制代码

这个例子中，我们在工作线程中执行一个模拟的耗时任务，并通过信号槽机制与主线程的UI进行通信，避免了界面冻结的问题。

四、实战案例：文本编辑器

现在，让我们综合运用前面所学的知识，开发一个简单的文本编辑器应用程序。这个文本编辑器将具有以下功能：

1. 新建、打开、保存文件
2. 基本的文本编辑功能
3. 查找和替换文本
4. 字体设置
5. 状态栏显示信息

4.1 项目结构

首先，创建一个Qt Widgets Application项目，然后添加以下文件：

• mainwindow.h：主窗口类的头文件
• mainwindow.cpp：主窗口类的实现文件
• textedit.h：自定义文本编辑类的头文件
• textedit.cpp：自定义文本编辑类的实现文件
• finddialog.h：查找对话框的头文件
• finddialog.cpp：查找对话框的实现文件
• replacedialog.h：替换对话框的头文件
• replacedialog.cpp：替换对话框的实现文件

4.2 自定义文本编辑类

2. // textedit.h
3. #ifndef TEXTEDIT_H
4. #define TEXTEDIT_H
6. #include <QTextEdit>
8. class TextEdit : public QTextEdit
9. {
10.     Q_OBJECT
12. public:
13.     explicit TextEdit(QWidget *parent = nullptr);
14.    
15.     bool loadFile(const QString &fileName);
16.     bool saveFile(const QString &fileName);
17.     QString currentFile() const;
18.    
19. protected:
20.     void closeEvent(QCloseEvent *event) override;
21.    
22. private slots:
23.     void documentWasModified();
24.    
25. private:
26.     void setCurrentFile(const QString &fileName);
27.     bool maybeSave();
28.    
29.     QString curFile;
30. };
32. #endif // TEXTEDIT_H

复制代码

2. // textedit.cpp
3. #include "textedit.h"
4. #include <QCloseEvent>
5. #include <QFile>
6. #include <QTextStream>
7. #include <QMessageBox>
8. #include <QApplication>
10. TextEdit::TextEdit(QWidget *parent) : QTextEdit(parent)
11. {
12.     connect(document(), &QTextDocument::contentsChanged,
13.             this, &TextEdit::documentWasModified);
14.     setWindowModified(false);
15. }
17. bool TextEdit::loadFile(const QString &fileName)
18. {
19.     QFile file(fileName);
20.     if (!file.open(QFile::ReadOnly | QFile::Text)) {
21.         QMessageBox::warning(this, tr("文本编辑器"),
22.                              tr("无法读取文件 %1:\n%2.")
23.                              .arg(QDir::toNativeSeparators(fileName),
24.                                   file.errorString()));
25.         return false;
26.     }
28.     QTextStream in(&file);
29.     QApplication::setOverrideCursor(Qt::WaitCursor);
30.     setPlainText(in.readAll());
31.     QApplication::restoreOverrideCursor();
33.     setCurrentFile(fileName);
34.     return true;
35. }
37. bool TextEdit::saveFile(const QString &fileName)
38. {
39.     QFile file(fileName);
40.     if (!file.open(QFile::WriteOnly | QFile::Text)) {
41.         QMessageBox::warning(this, tr("文本编辑器"),
42.                              tr("无法写入文件 %1:\n%2.")
43.                              .arg(QDir::toNativeSeparators(fileName),
44.                                   file.errorString()));
45.         return false;
46.     }
48.     QTextStream out(&file);
49.     QApplication::setOverrideCursor(Qt::WaitCursor);
50.     out << toPlainText();
51.     QApplication::restoreOverrideCursor();
53.     setCurrentFile(fileName);
54.     return true;
55. }
57. QString TextEdit::currentFile() const
58. {
59.     return curFile;
60. }
62. void TextEdit::closeEvent(QCloseEvent *event)
63. {
64.     if (maybeSave()) {
65.         event->accept();
66.     } else {
67.         event->ignore();
68.     }
69. }
71. void TextEdit::documentWasModified()
72. {
73.     setWindowModified(document()->isModified());
74. }
76. void TextEdit::setCurrentFile(const QString &fileName)
77. {
78.     curFile = fileName;
79.     document()->setModified(false);
80.     setWindowModified(false);
82.     QString shownName;
83.     if (curFile.isEmpty())
84.         shownName = "untitled.txt";
85.     else
86.         shownName = QFileInfo(curFile).fileName();
88.     setWindowTitle(tr("%1[*] - %2").arg(shownName, QCoreApplication::applicationName()));
89. }
91. bool TextEdit::maybeSave()
92. {
93.     if (!document()->isModified())
94.         return true;
96.     const QMessageBox::StandardButton ret
97.         = QMessageBox::warning(this, tr("文本编辑器"),
98.                              tr("文档已被修改.\n"
99.                                 "是否保存修改?"),
100.                              QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
101.     switch (ret) {
102.     case QMessageBox::Save:
103.         return true;
104.     case QMessageBox::Cancel:
105.         return false;
106.     default:
107.         break;
108.     }
109.     return true;
110. }

复制代码

4.3 查找对话框

2. // finddialog.h
3. #ifndef FINDDIALOG_H
4. #define FINDDIALOG_H
6. #include <QDialog>
8. class QCheckBox;
9. class QLabel;
10. class QLineEdit;
11. class QPushButton;
13. class FindDialog : public QDialog
14. {
15.     Q_OBJECT
17. public:
18.     explicit FindDialog(QWidget *parent = nullptr);
19.    
20.     QString getFindText() const;
21.     bool caseSensitive() const;
22.     bool wholeWords() const;
23.     bool backward() const;
24.    
25. signals:
26.     void findNext(const QString &str, Qt::CaseSensitivity cs);
27.     void findPrevious(const QString &str, Qt::CaseSensitivity cs);
29. private slots:
30.     void findClicked();
31.     void enableFindButton(const QString &text);
33. private:
34.     QLineEdit *lineEdit;
35.     QCheckBox *caseCheckBox;
36.     QCheckBox *wholeWordsCheckBox;
37.     QCheckBox *backwardCheckBox;
38.     QPushButton *findButton;
39.     QPushButton *closeButton;
40. };
42. #endif // FINDDIALOG_H

复制代码

2. // finddialog.cpp
3. #include "finddialog.h"
4. #include <QLabel>
5. #include <QLineEdit>
6. #include <QCheckBox>
7. #include <QPushButton>
8. #include <QHBoxLayout>
9. #include <QVBoxLayout>
11. FindDialog::FindDialog(QWidget *parent) : QDialog(parent)
12. {
13.     QLabel *label = new QLabel(tr("查找内容:"));
14.     lineEdit = new QLineEdit;
15.     label->setBuddy(lineEdit);
16.    
17.     caseCheckBox = new QCheckBox(tr("区分大小写"));
18.     wholeWordsCheckBox = new QCheckBox(tr("全词匹配"));
19.     backwardCheckBox = new QCheckBox(tr("向上查找"));
20.    
21.     findButton = new QPushButton(tr("查找"));
22.     findButton->setDefault(true);
23.     findButton->setEnabled(false);
24.    
25.     closeButton = new QPushButton(tr("关闭"));
26.    
27.     connect(lineEdit, &QLineEdit::textChanged, this, &FindDialog::enableFindButton);
28.     connect(findButton, &QPushButton::clicked, this, &FindDialog::findClicked);
29.     connect(closeButton, &QPushButton::clicked, this, &FindDialog::close);
30.    
31.     QHBoxLayout *topLeftLayout = new QHBoxLayout;
32.     topLeftLayout->addWidget(label);
33.     topLeftLayout->addWidget(lineEdit);
34.    
35.     QVBoxLayout *leftLayout = new QVBoxLayout;
36.     leftLayout->addLayout(topLeftLayout);
37.     leftLayout->addWidget(caseCheckBox);
38.     leftLayout->addWidget(wholeWordsCheckBox);
39.     leftLayout->addWidget(backwardCheckBox);
40.    
41.     QVBoxLayout *rightLayout = new QVBoxLayout;
42.     rightLayout->addWidget(findButton);
43.     rightLayout->addWidget(closeButton);
44.     rightLayout->addStretch();
45.    
46.     QHBoxLayout *mainLayout = new QHBoxLayout;
47.     mainLayout->addLayout(leftLayout);
48.     mainLayout->addLayout(rightLayout);
49.     setLayout(mainLayout);
50.    
51.     setWindowTitle(tr("查找"));
52.     setFixedHeight(sizeHint().height());
53. }
55. QString FindDialog::getFindText() const
56. {
57.     return lineEdit->text();
58. }
60. bool FindDialog::caseSensitive() const
61. {
62.     return caseCheckBox->isChecked();
63. }
65. bool FindDialog::wholeWords() const
66. {
67.     return wholeWordsCheckBox->isChecked();
68. }
70. bool FindDialog::backward() const
71. {
72.     return backwardCheckBox->isChecked();
73. }
75. void FindDialog::findClicked()
76. {
77.     Qt::CaseSensitivity cs = caseSensitive() ? Qt::CaseSensitive : Qt::CaseInsensitive;
78.    
79.     if (backward()) {
80.         emit findPrevious(getFindText(), cs);
81.     } else {
82.         emit findNext(getFindText(), cs);
83.     }
84. }
86. void FindDialog::enableFindButton(const QString &text)
87. {
88.     findButton->setEnabled(!text.isEmpty());
89. }

复制代码

4.4 替换对话框

2. // replacedialog.h
3. #ifndef REPLACEDIALOG_H
4. #define REPLACEDIALOG_H
6. #include <QDialog>
8. class QCheckBox;
9. class QLabel;
10. class QLineEdit;
11. class QPushButton;
13. class ReplaceDialog : public QDialog
14. {
15.     Q_OBJECT
17. public:
18.     explicit ReplaceDialog(QWidget *parent = nullptr);
19.    
20.     QString getFindText() const;
21.     QString getReplaceText() const;
22.     bool caseSensitive() const;
23.     bool wholeWords() const;
24.    
25. signals:
26.     void findNext(const QString &str, Qt::CaseSensitivity cs);
27.     void replace(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs);
28.     void replaceAll(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs);
30. private slots:
31.     void findClicked();
32.     void replaceClicked();
33.     void replaceAllClicked();
34.     void enableFindButton(const QString &text);
36. private:
37.     QLineEdit *findLineEdit;
38.     QLineEdit *replaceLineEdit;
39.     QCheckBox *caseCheckBox;
40.     QCheckBox *wholeWordsCheckBox;
41.     QPushButton *findButton;
42.     QPushButton *replaceButton;
43.     QPushButton *replaceAllButton;
44.     QPushButton *closeButton;
45. };
47. #endif // REPLACEDIALOG_H

复制代码

2. // replacedialog.cpp
3. #include "replacedialog.h"
4. #include <QLabel>
5. #include <QLineEdit>
6. #include <QCheckBox>
7. #include <QPushButton>
8. #include <QHBoxLayout>
9. #include <QVBoxLayout>
11. ReplaceDialog::ReplaceDialog(QWidget *parent) : QDialog(parent)
12. {
13.     QLabel *findLabel = new QLabel(tr("查找内容:"));
14.     findLineEdit = new QLineEdit;
15.     findLabel->setBuddy(findLineEdit);
16.    
17.     QLabel *replaceLabel = new QLabel(tr("替换为:"));
18.     replaceLineEdit = new QLineEdit;
19.     replaceLabel->setBuddy(replaceLineEdit);
20.    
21.     caseCheckBox = new QCheckBox(tr("区分大小写"));
22.     wholeWordsCheckBox = new QCheckBox(tr("全词匹配"));
23.    
24.     findButton = new QPushButton(tr("查找"));
25.     findButton->setDefault(true);
26.     findButton->setEnabled(false);
27.    
28.     replaceButton = new QPushButton(tr("替换"));
29.     replaceButton->setEnabled(false);
30.    
31.     replaceAllButton = new QPushButton(tr("全部替换"));
32.     replaceAllButton->setEnabled(false);
33.    
34.     closeButton = new QPushButton(tr("关闭"));
35.    
36.     connect(findLineEdit, &QLineEdit::textChanged, this, &ReplaceDialog::enableFindButton);
37.     connect(findButton, &QPushButton::clicked, this, &ReplaceDialog::findClicked);
38.     connect(replaceButton, &QPushButton::clicked, this, &ReplaceDialog::replaceClicked);
39.     connect(replaceAllButton, &QPushButton::clicked, this, &ReplaceDialog::replaceAllClicked);
40.     connect(closeButton, &QPushButton::clicked, this, &ReplaceDialog::close);
41.    
42.     QHBoxLayout *findLayout = new QHBoxLayout;
43.     findLayout->addWidget(findLabel);
44.     findLayout->addWidget(findLineEdit);
45.    
46.     QHBoxLayout *replaceLayout = new QHBoxLayout;
47.     replaceLayout->addWidget(replaceLabel);
48.     replaceLayout->addWidget(replaceLineEdit);
49.    
50.     QVBoxLayout *leftLayout = new QVBoxLayout;
51.     leftLayout->addLayout(findLayout);
52.     leftLayout->addLayout(replaceLayout);
53.     leftLayout->addWidget(caseCheckBox);
54.     leftLayout->addWidget(wholeWordsCheckBox);
55.    
56.     QVBoxLayout *rightLayout = new QVBoxLayout;
57.     rightLayout->addWidget(findButton);
58.     rightLayout->addWidget(replaceButton);
59.     rightLayout->addWidget(replaceAllButton);
60.     rightLayout->addWidget(closeButton);
61.     rightLayout->addStretch();
62.    
63.     QHBoxLayout *mainLayout = new QHBoxLayout;
64.     mainLayout->addLayout(leftLayout);
65.     mainLayout->addLayout(rightLayout);
66.     setLayout(mainLayout);
67.    
68.     setWindowTitle(tr("替换"));
69.     setFixedHeight(sizeHint().height());
70. }
72. QString ReplaceDialog::getFindText() const
73. {
74.     return findLineEdit->text();
75. }
77. QString ReplaceDialog::getReplaceText() const
78. {
79.     return replaceLineEdit->text();
80. }
82. bool ReplaceDialog::caseSensitive() const
83. {
84.     return caseCheckBox->isChecked();
85. }
87. bool ReplaceDialog::wholeWords() const
88. {
89.     return wholeWordsCheckBox->isChecked();
90. }
92. void ReplaceDialog::findClicked()
93. {
94.     Qt::CaseSensitivity cs = caseSensitive() ? Qt::CaseSensitive : Qt::CaseInsensitive;
95.     emit findNext(getFindText(), cs);
96. }
98. void ReplaceDialog::replaceClicked()
99. {
100.     Qt::CaseSensitivity cs = caseSensitive() ? Qt::CaseSensitive : Qt::CaseInsensitive;
101.     emit replace(getFindText(), getReplaceText(), cs);
102. }
104. void ReplaceDialog::replaceAllClicked()
105. {
106.     Qt::CaseSensitivity cs = caseSensitive() ? Qt::CaseSensitive : Qt::CaseInsensitive;
107.     emit replaceAll(getFindText(), getReplaceText(), cs);
108. }
110. void ReplaceDialog::enableFindButton(const QString &text)
111. {
112.     findButton->setEnabled(!text.isEmpty());
113.     replaceButton->setEnabled(!text.isEmpty());
114.     replaceAllButton->setEnabled(!text.isEmpty());
115. }

复制代码

4.5 主窗口

2. // mainwindow.h
3. #ifndef MAINWINDOW_H
4. #define MAINWINDOW_H
6. #include <QMainWindow>
7. #include "textedit.h"
9. class QAction;
10. class QMenu;
11. class QStatusBar;
12. class FindDialog;
13. class ReplaceDialog;
15. class MainWindow : public QMainWindow
16. {
17.     Q_OBJECT
19. public:
20.     MainWindow();
22. protected:
23.     void closeEvent(QCloseEvent *event) override;
25. private slots:
26.     void newFile();
27.     void open();
28.     bool save();
29.     bool saveAs();
30.     void about();
31.     void documentWasModified();
32.     void find();
33.     void replace();
34.     void findNext(const QString &str, Qt::CaseSensitivity cs);
35.     void findPrevious(const QString &str, Qt::CaseSensitivity cs);
36.     void replaceText(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs);
37.     void replaceAllText(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs);
38.     void fontDialog();
40. private:
41.     void createActions();
42.     void createMenus();
43.     void createStatusBar();
44.     void readSettings();
45.     void writeSettings();
46.     bool maybeSave();
47.     void loadFile(const QString &fileName);
48.     bool saveFile(const QString &fileName);
49.     void setCurrentFile(const QString &fileName);
50.     QString strippedName(const QString &fullFileName);
52.     TextEdit *textEdit;
53.     FindDialog *findDialog;
54.     ReplaceDialog *replaceDialog;
55.    
56.     QMenu *fileMenu;
57.     QMenu *editMenu;
58.     QMenu *formatMenu;
59.     QMenu *helpMenu;
60.    
61.     QAction *newAct;
62.     QAction *openAct;
63.     QAction *saveAct;
64.     QAction *saveAsAct;
65.     QAction *exitAct;
66.     QAction *undoAct;
67.     QAction *redoAct;
68.     QAction *cutAct;
69.     QAction *copyAct;
70.     QAction *pasteAct;
71.     QAction *findAct;
72.     QAction *replaceAct;
73.     QAction *fontAct;
74.     QAction *aboutAct;
75.     QAction *aboutQtAct;
76.    
77.     QString curFile;
78. };
80. #endif // MAINWINDOW_H

复制代码

2. // mainwindow.cpp
3. #include "mainwindow.h"
4. #include "finddialog.h"
5. #include "replacedialog.h"
6. #include <QApplication>
7. #include <QFileDialog>
8. #include <QMessageBox>
9. #include <QTextStream>
10. #include <QFontDialog>
11. #include <QStatusBar>
12. #include <QCloseEvent>
14. MainWindow::MainWindow()
15. {
16.     textEdit = new TextEdit;
17.     setCentralWidget(textEdit);
18.    
19.     findDialog = nullptr;
20.     replaceDialog = nullptr;
21.    
22.     createActions();
23.     createMenus();
24.     createStatusBar();
25.    
26.     readSettings();
27.    
28.     setUnifiedTitleAndToolBarOnMac(true);
29. }
31. void MainWindow::closeEvent(QCloseEvent *event)
32. {
33.     if (textEdit->maybeSave()) {
34.         writeSettings();
35.         event->accept();
36.     } else {
37.         event->ignore();
38.     }
39. }
41. void MainWindow::newFile()
42. {
43.     if (textEdit->maybeSave()) {
44.         textEdit->clear();
45.         setCurrentFile(QString());
46.     }
47. }
49. void MainWindow::open()
50. {
51.     if (textEdit->maybeSave()) {
52.         QString fileName = QFileDialog::getOpenFileName(this);
53.         if (!fileName.isEmpty())
54.             loadFile(fileName);
55.     }
56. }
58. bool MainWindow::save()
59. {
60.     if (curFile.isEmpty()) {
61.         return saveAs();
62.     } else {
63.         return saveFile(curFile);
64.     }
65. }
67. bool MainWindow::saveAs()
68. {
69.     QString fileName = QFileDialog::getSaveFileName(this);
70.     if (fileName.isEmpty())
71.         return false;
73.     return saveFile(fileName);
74. }
76. void MainWindow::about()
77. {
78.    QMessageBox::about(this, tr("关于文本编辑器"),
79.             tr("<b>文本编辑器</b> 是一个使用Qt开发的基本文本编辑应用程序。"
80.                "它可以用来编辑和保存纯文本文件。"));
81. }
83. void MainWindow::documentWasModified()
84. {
85.     setWindowModified(textEdit->document()->isModified());
86. }
88. void MainWindow::find()
89. {
90.     if (!findDialog) {
91.         findDialog = new FindDialog(this);
92.         connect(findDialog, &FindDialog::findNext, this, &MainWindow::findNext);
93.         connect(findDialog, &FindDialog::findPrevious, this, &MainWindow::findPrevious);
94.     }
95.    
96.     findDialog->show();
97.     findDialog->raise();
98.     findDialog->activateWindow();
99. }
101. void MainWindow::replace()
102. {
103.     if (!replaceDialog) {
104.         replaceDialog = new ReplaceDialog(this);
105.         connect(replaceDialog, &ReplaceDialog::findNext, this, &MainWindow::findNext);
106.         connect(replaceDialog, &ReplaceDialog::replace, this, &MainWindow::replaceText);
107.         connect(replaceDialog, &ReplaceDialog::replaceAll, this, &MainWindow::replaceAllText);
108.     }
109.    
110.     replaceDialog->show();
111.     replaceDialog->raise();
112.     replaceDialog->activateWindow();
113. }
115. void MainWindow::findNext(const QString &str, Qt::CaseSensitivity cs)
116. {
117.     if (!textEdit->find(str, QTextDocument::FindFlag(0) | (cs == Qt::CaseSensitive ? QTextDocument::FindCaseSensitively : QTextDocument::FindFlag(0)))) {
118.         QMessageBox::information(this, tr("查找"), tr("找不到 "%1"").arg(str));
119.     }
120. }
122. void MainWindow::findPrevious(const QString &str, Qt::CaseSensitivity cs)
123. {
124.     if (!textEdit->find(str, QTextDocument::FindBackward | (cs == Qt::CaseSensitive ? QTextDocument::FindCaseSensitively : QTextDocument::FindFlag(0)))) {
125.         QMessageBox::information(this, tr("查找"), tr("找不到 "%1"").arg(str));
126.     }
127. }
129. void MainWindow::replaceText(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs)
130. {
131.     QTextCursor cursor = textEdit->textCursor();
132.     if (!cursor.hasSelection() || cursor.selectedText() != findText) {
133.         if (!textEdit->find(findText, QTextDocument::FindFlag(0) | (cs == Qt::CaseSensitive ? QTextDocument::FindCaseSensitively : QTextDocument::FindFlag(0)))) {
134.             QMessageBox::information(this, tr("替换"), tr("找不到 "%1"").arg(findText));
135.             return;
136.         }
137.     }
138.    
139.     textEdit->textCursor().insertText(replaceText);
140. }
142. void MainWindow::replaceAllText(const QString &findText, const QString &replaceText, Qt::CaseSensitivity cs)
143. {
144.     QTextDocument::FindFlags flags;
145.     if (cs == Qt::CaseSensitive)
146.         flags |= QTextDocument::FindCaseSensitively;
147.    
148.     int count = 0;
149.     QTextCursor cursor = textEdit->textCursor();
150.     cursor.movePosition(QTextCursor::Start);
151.     textEdit->setTextCursor(cursor);
152.    
153.     while (textEdit->find(findText, flags)) {
154.         textEdit->textCursor().insertText(replaceText);
155.         count++;
156.     }
157.    
158.     QMessageBox::information(this, tr("替换"), tr("已替换 %1 处").arg(count));
159. }
161. void MainWindow::fontDialog()
162. {
163.     bool ok;
164.     QFont font = QFontDialog::getFont(&ok, textEdit->font(), this);
165.     if (ok) {
166.         textEdit->setFont(font);
167.     }
168. }
170. void MainWindow::createActions()
171. {
172.     newAct = new QAction(tr("新建"), this);
173.     newAct->setShortcuts(QKeySequence::New);
174.     newAct->setStatusTip(tr("创建新文件"));
175.     connect(newAct, &QAction::triggered, this, &MainWindow::newFile);
177.     openAct = new QAction(tr("打开..."), this);
178.     openAct->setShortcuts(QKeySequence::Open);
179.     openAct->setStatusTip(tr("打开已有文件"));
180.     connect(openAct, &QAction::triggered, this, &MainWindow::open);
182.     saveAct = new QAction(tr("保存"), this);
183.     saveAct->setShortcuts(QKeySequence::Save);
184.     saveAct->setStatusTip(tr("保存当前文档"));
185.     connect(saveAct, &QAction::triggered, this, &MainWindow::save);
187.     saveAsAct = new QAction(tr("另存为..."), this);
188.     saveAsAct->setShortcuts(QKeySequence::SaveAs);
189.     saveAsAct->setStatusTip(tr("以新名称保存文档"));
190.     connect(saveAsAct, &QAction::triggered, this, &MainWindow::saveAs);
192.     exitAct = new QAction(tr("退出"), this);
193.     exitAct->setShortcuts(QKeySequence::Quit);
194.     exitAct->setStatusTip(tr("退出应用程序"));
195.     connect(exitAct, &QAction::triggered, this, &QWidget::close);
197.     undoAct = new QAction(tr("撤销"), this);
198.     undoAct->setShortcuts(QKeySequence::Undo);
199.     connect(undoAct, &QAction::triggered, textEdit, &TextEdit::undo);
201.     redoAct = new QAction(tr("重做"), this);
202.     redoAct->setShortcuts(QKeySequence::Redo);
203.     connect(redoAct, &QAction::triggered, textEdit, &TextEdit::redo);
205.     cutAct = new QAction(tr("剪切"), this);
206.     cutAct->setShortcuts(QKeySequence::Cut);
207.     connect(cutAct, &QAction::triggered, textEdit, &TextEdit::cut);
209.     copyAct = new QAction(tr("复制"), this);
210.     copyAct->setShortcuts(QKeySequence::Copy);
211.     connect(copyAct, &QAction::triggered, textEdit, &TextEdit::copy);
213.     pasteAct = new QAction(tr("粘贴"), this);
214.     pasteAct->setShortcuts(QKeySequence::Paste);
215.     connect(pasteAct, &QAction::triggered, textEdit, &TextEdit::paste);
217.     findAct = new QAction(tr("查找..."), this);
218.     findAct->setShortcuts(QKeySequence::Find);
219.     connect(findAct, &QAction::triggered, this, &MainWindow::find);
221.     replaceAct = new QAction(tr("替换..."), this);
222.     replaceAct->setShortcuts(QKeySequence::Replace);
223.     connect(replaceAct, &QAction::triggered, this, &MainWindow::replace);
225.     fontAct = new QAction(tr("字体..."), this);
226.     connect(fontAct, &QAction::triggered, this, &MainWindow::fontDialog);
228.     aboutAct = new QAction(tr("关于"), this);
229.     aboutAct->setStatusTip(tr("显示应用程序的关于框"));
230.     connect(aboutAct, &QAction::triggered, this, &MainWindow::about);
232.     aboutQtAct = new QAction(tr("关于 Qt"), this);
233.     aboutQtAct->setStatusTip(tr("显示Qt库的关于框"));
234.     connect(aboutQtAct, &QAction::triggered, qApp, &QApplication::aboutQt);
235. }
237. void MainWindow::createMenus()
238. {
239.     fileMenu = menuBar()->addMenu(tr("文件"));
240.     fileMenu->addAction(newAct);
241.     fileMenu->addAction(openAct);
242.     fileMenu->addAction(saveAct);
243.     fileMenu->addAction(saveAsAct);
244.     fileMenu->addSeparator();
245.     fileMenu->addAction(exitAct);
247.     editMenu = menuBar()->addMenu(tr("编辑"));
248.     editMenu->addAction(undoAct);
249.     editMenu->addAction(redoAct);
250.     editMenu->addSeparator();
251.     editMenu->addAction(cutAct);
252.     editMenu->addAction(copyAct);
253.     editMenu->addAction(pasteAct);
254.     editMenu->addSeparator();
255.     editMenu->addAction(findAct);
256.     editMenu->addAction(replaceAct);
258.     formatMenu = menuBar()->addMenu(tr("格式"));
259.     formatMenu->addAction(fontAct);
261.     helpMenu = menuBar()->addMenu(tr("帮助"));
262.     helpMenu->addAction(aboutAct);
263.     helpMenu->addAction(aboutQtAct);
264. }
266. void MainWindow::createStatusBar()
267. {
268.     statusBar()->showMessage(tr("就绪"));
269. }
271. void MainWindow::readSettings()
272. {
273.     QSettings settings("MyCompany", "TextEditor");
274.     QPoint pos = settings.value("pos", QPoint(200, 200)).toPoint();
275.     QSize size = settings.value("size", QSize(400, 400)).toSize();
276.     resize(size);
277.     move(pos);
278. }
280. void MainWindow::writeSettings()
281. {
282.     QSettings settings("MyCompany", "TextEditor");
283.     settings.setValue("pos", pos());
284.     settings.setValue("size", size());
285. }
287. bool MainWindow::maybeSave()
288. {
289.     if (!textEdit->document()->isModified())
290.         return true;
292.     const QMessageBox::StandardButton ret
293.         = QMessageBox::warning(this, tr("文本编辑器"),
294.                              tr("文档已被修改.\n"
295.                                 "是否保存修改?"),
296.                              QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
297.     switch (ret) {
298.     case QMessageBox::Save:
299.         return save();
300.     case QMessageBox::Cancel:
301.         return false;
302.     default:
303.         break;
304.     }
305.     return true;
306. }
308. void MainWindow::loadFile(const QString &fileName)
309. {
310.     if (!textEdit->loadFile(fileName)) {
311.         statusBar()->showMessage(tr("加载失败"), 2000);
312.         return;
313.     }
315.     setCurrentFile(fileName);
316.     statusBar()->showMessage(tr("文件已加载"), 2000);
317. }
319. bool MainWindow::saveFile(const QString &fileName)
320. {
321.     if (!textEdit->saveFile(fileName)) {
322.         statusBar()->showMessage(tr("保存失败"), 2000);
323.         return false;
324.     }
326.     setCurrentFile(fileName);
327.     statusBar()->showMessage(tr("文件已保存"), 2000);
328.     return true;
329. }
331. void MainWindow::setCurrentFile(const QString &fileName)
332. {
333.     curFile = fileName;
334.     textEdit->document()->setModified(false);
335.     setWindowModified(false);
337.     QString shownName;
338.     if (curFile.isEmpty())
339.         shownName = "untitled.txt";
340.     else
341.         shownName = QFileInfo(curFile).fileName();
343.     setWindowTitle(tr("%1[*] - %2").arg(shownName, QCoreApplication::applicationName()));
344. }
346. QString MainWindow::strippedName(const QString &fullFileName)
347. {
348.     return QFileInfo(fullFileName).fileName();
349. }

复制代码

4.6 主函数

2. // main.cpp
3. #include "mainwindow.h"
4. #include <QApplication>
6. int main(int argc, char *argv[])
7. {
8.     QApplication app(argc, argv);
9.     app.setApplicationName("文本编辑器");
10.     app.setOrganizationName("MyCompany");
11.    
12.     MainWindow window;
13.     window.show();
14.    
15.     return app.exec();
16. }

复制代码

4.7 项目文件

2. # TextEditor.pro
3. QT       += core gui
5. greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
7. CONFIG += c++17
9. # You can make your code fail to compile if it uses deprecated APIs.
10. # In order to do so, uncomment the following line.
11. #DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
13. SOURCES += \
14.     main.cpp \
15.     mainwindow.cpp \
16.     textedit.cpp \
17.     finddialog.cpp \
18.     replacedialog.cpp
20. HEADERS += \
21.     mainwindow.h \
22.     textedit.h \
23.     finddialog.h \
24.     replacedialog.h
26. # Default rules for deployment.
27. qnx: target.path = /tmp/$${TARGET}/bin
28. else: unix:!android: target.path = /opt/$${TARGET}/bin
29. !isEmpty(target.path): INSTALLS += target

复制代码

这个文本编辑器应用程序具有完整的文件操作功能（新建、打开、保存、另存为）、基本的文本编辑功能（撤销、重做、剪切、复制、粘贴）、查找和替换功能以及字体设置功能。通过这个实战案例，我们综合运用了前面所学的Qt核心技能，包括信号槽机制、布局管理、常用控件、对话框、文件操作等。

五、常见问题与解决方案

5.1 中文显示乱码问题

在Linux平台下，Qt应用程序中显示中文时可能会出现乱码问题。这通常是由于编码不一致导致的。解决方法如下：

2. #include <QApplication>
3. #include <QTextCodec>
4. #include <QLabel>
6. int main(int argc, char *argv[])
7. {
8.     QApplication app(argc, argv);
9.    
10.     // 设置编码为UTF-8
11.     QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
12.    
13.     QLabel label("你好，世界！");
14.     label.show();
15.    
16.     return app.exec();
17. }

复制代码

另外，在Qt Creator中，确保源代码文件以UTF-8编码保存。可以在”工具” -> “选项” -> “文本编辑器” -> “行为”中设置默认编码为UTF-8。

5.2 程序打包与发布

在Linux平台下，Qt应用程序的打包与发布通常有以下几种方式：

静态编译将Qt库直接链接到可执行文件中，使得程序可以在没有安装Qt库的系统上运行。但是，静态编译需要自己编译Qt库，并且会增加可执行文件的大小。

2. # 在.pro文件中添加以下配置
3. CONFIG += static

复制代码

linuxdeployqt是一个用于打包Qt应用程序的工具，它会收集所有依赖的库并创建一个AppDir或AppImage。

2. # 安装linuxdeployqt
3. wget -c "https://github.com/probonopd/linuxdeployqt/releases/download/continuous/linuxdeployqt-continuous-x86_64.AppImage"
4. chmod a+x linuxdeployqt-continuous-x86_64.AppImage
6. # 打包应用程序
7. ./linuxdeployqt-continuous-x86_64.AppImage /path/to/your/app -appimage

复制代码

如果你的目标系统是基于Debian的（如Ubuntu），可以创建Debian包来分发应用程序。

2. # 安装打包工具
3. sudo apt install dh-make devscripts
5. # 创建Debian包结构
6. dh_make --createorig --single --yes
8. # 构建包
9. debuild -us -uc

复制代码

5.3 性能优化

Qt应用程序的性能优化是一个重要的话题，以下是一些常见的优化技巧：

2. // 在自定义控件中，只有当内容真正改变时才调用update()
3. void MyWidget::setData(const Data &data)
4. {
5.     if (m_data != data) {
6.         m_data = data;
7.         update(); // 触发重绘
8.     }
9. }

复制代码

当需要显示大量数据时，使用模型/视图架构比直接使用控件更高效：

2. // 使用QTableView和自定义模型而不是QTableWidget
3. QTableView *tableView = new QTableView;
4. MyCustomModel *model = new MyCustomModel(this);
5. tableView->setModel(model);

复制代码

2. // 将耗时操作放在工作线程中
3. class Worker : public QObject
4. {
5.     Q_OBJECT
6. public:
7.     explicit Worker(QObject *parent = nullptr) : QObject(parent) {}
8.    
9. public slots:
10.     void doWork()
11.     {
12.         // 执行耗时操作
13.         emit resultReady(result);
14.     }
15.    
16. signals:
17.     void resultReady(const Result &result);
18. };
20. // 在主线程中
21. QThread *thread = new QThread;
22. Worker *worker = new Worker;
23. worker->moveToThread(thread);
25. connect(thread, &QThread::started, worker, &Worker::doWork);
26. connect(worker, &Worker::resultReady, this, &MyClass::handleResult);
27. connect(worker, &Worker::resultReady, thread, &QThread::quit);
28. connect(worker, &Worker::resultReady, worker, &Worker::deleteLater);
29. connect(thread, &QThread::finished, thread, &QThread::deleteLater);
31. thread->start();

复制代码

5.4 内存管理

Qt的父子对象机制简化了内存管理，但在某些情况下仍需特别注意：

2. // 错误示例：没有设置父对象，可能导致内存泄漏
3. void MyClass::createWidgets()
4. {
5.     QPushButton *button = new QPushButton("Click me");
6.     // 没有设置父对象，也没有手动删除
7. }
9. // 正确示例：设置父对象
10. void MyClass::createWidgets()
11. {
12.     QPushButton *button = new QPushButton("Click me", this); // 设置父对象
13.     // 父对象被删除时，会自动删除子对象
14. }

复制代码

2. #include <QSharedPointer>
3. #include <QWeakPointer>
5. // 使用QSharedPointer管理对象
6. QSharedPointer<MyClass> sharedObj(new MyClass);
8. // 使用QWeakPointer避免循环引用
9. class ClassA : public QObject
10. {
11.     Q_OBJECT
12. public:
13.     void setClassB(QWeakPointer<ClassB> b) { m_b = b; }
14. private:
15.     QWeakPointer<ClassB> m_b;
16. };
18. class ClassB : public QObject
19. {
20.     Q_OBJECT
21. public:
22.     void setClassA(QSharedPointer<ClassA> a) { m_a = a; }
23. private:
24.     QSharedPointer<ClassA> m_a;
25. };

复制代码

六、学习路径与资源推荐

6.1 学习路径

对于初学者，建议按照以下路径学习Qt编程：

1. 基础阶段：学习C++基础知识了解Qt的基本概念和架构掌握信号槽机制学习常用控件的使用理解布局管理
2. 学习C++基础知识
3. 了解Qt的基本概念和架构
4. 掌握信号槽机制
5. 学习常用控件的使用
6. 理解布局管理
7. 进阶阶段：学习自定义控件的创建掌握模型/视图编程了解Qt的多线程编程学习文件操作和数据处理掌握Qt的绘图系统
8. 学习自定义控件的创建
9. 掌握模型/视图编程
10. 了解Qt的多线程编程
11. 学习文件操作和数据处理
12. 掌握Qt的绘图系统
13. 高级阶段：学习Qt的网络编程掌握Qt的数据库操作了解Qt的国际化支持学习Qt的单元测试掌握应用程序的打包与发布
14. 学习Qt的网络编程
15. 掌握Qt的数据库操作
16. 了解Qt的国际化支持
17. 学习Qt的单元测试
18. 掌握应用程序的打包与发布

基础阶段：

• 学习C++基础知识
• 了解Qt的基本概念和架构
• 掌握信号槽机制
• 学习常用控件的使用
• 理解布局管理

进阶阶段：

• 学习自定义控件的创建
• 掌握模型/视图编程
• 了解Qt的多线程编程
• 学习文件操作和数据处理
• 掌握Qt的绘图系统

高级阶段：

• 学习Qt的网络编程
• 掌握Qt的数据库操作
• 了解Qt的国际化支持
• 学习Qt的单元测试
• 掌握应用程序的打包与发布

6.2 推荐资源

• Qt官方文档：最权威的Qt参考资料，包含详细的类说明和示例代码。
• Qt Wiki：包含各种教程、技巧和最佳实践。
• Qt示例代码：官方提供的示例代码，涵盖各种功能和使用场景。

• 《C++ GUI Programming with Qt 4》：经典的Qt编程书籍，虽然基于Qt 4，但大部分内容仍然适用。
• 《Qt 5开发实战》：详细介绍Qt 5的各种功能和编程技巧。
• 《Qt Creator快速入门》：专注于Qt Creator IDE的使用和Qt编程基础。

• Qt中文社区：国内最大的Qt开发者社区，有丰富的教程和讨论。
• Stack Overflow：全球最大的编程问答网站，有大量Qt相关的问题和解答。
• GitHub上的Qt项目：可以学习其他开发者的代码和项目。

• Qt官方YouTube频道：官方发布的各种教程和演示视频。
• Bilibili上的Qt教程：国内视频网站上有许多Qt相关的中文教程。

结语

Qt是一个功能强大、灵活且跨平台的GUI开发框架，特别适合在Linux平台上开发桌面应用程序。通过本文的学习，你已经从入门到精通掌握了Qt图形界面编程的核心技能，包括基本概念、常用控件、信号槽机制、布局管理、自定义控件、模型视图编程、多线程编程等内容。通过实战案例的开发，你了解了如何综合运用这些技能来构建一个完整的桌面应用程序。同时，我们还讨论了常见问题的解决方案和学习资源推荐，帮助你进一步提高Qt编程能力。

Qt的学习是一个持续的过程，随着Qt版本的更新和新功能的加入，你需要不断学习和探索。希望本文能够成为你Qt编程之路上的指南，帮助你开发出更加专业、高效的桌面应用程序。

mai2

感謝分享