当前位置：首页 > news >正文

【QT】1.QT 基础入门 - 实践

news 2026/5/11 23:32:24

【QT】1.QT 基础入门 - 实践

一、新建项目

1. 新建项目

二、生成代码

1. main.cpp

2. widget.h / widget.cpp

3. widget.ui

4. .pro 文件

5. 运行后生成的文件

三、创建控件

1. Label（标签）

2. 编辑框

3. 一个简单的交互程序：点击按钮切换文字

四、乱码问题与文字输出

1. 编码问题

2. qDebug 输出

五、坐标系统

一、新建项目

1. 新建项目

启动：在 QT 的安装文件夹中，找到并运行 QT Creator，然后在左上角的“文件”菜单中点击“新建”。
选择模板：由于 QT 支持 Python 等多种语言开发，QT Quick 是 QT 自己的一套声明式语言和开发方式。我们使用 C++，因此选择默认的 Widgets Application 模板即可。
设置项目路径和名字：路径和名称不能包含中文。
构建系统选择：选择 qmake，这是 QT 的经典构建工具。CMake 也被部分开源项目使用，而 Qbs 已停止维护。
UI 文件（Formfile）：
- 在 QT 中创建图形界面的方式有两种：使用 C++ 代码创建，或使用 Formfile 图形界面创建。
- 我们选用图形化方式快速编辑。
- 基类选择 QWidget。
其他选项：编译器选择等保持默认即可。

二、生成代码

1. `main.cpp`

#include "widget.h"
#include 
int main(int argc, char *argv[]) {QApplication a(argc, argv);Widget w;w.show();return a.exec();
}

创建 QT 项目后，会自动生成这些代码。

main 函数的形参即为命令行参数。
QApplication：是编写 QT 应用程序时必须的类，管理应用程序的控制流和主要设置。
show 方法：
- Widget w;
- w.show();
- Widget 是创建项目时输入的类名。
- .show() 用于显示窗口控件，改为 .hide() 则为隐藏。
exec 方法：与 Linux 的 exec 不同，这是启动应用程序的事件循环，让程序运行起来。

2. `widget.h` / `widget.cpp`

继承关系：class Widget : public QWidget，即继承了创建项目时选择的基类 QWidget。
Q_OBJECT 宏：QT 内置的宏，展开后会生成一些代码，是 QT 信号和槽机制的核心所需。
构造函数和析构函数：
Ui::Widget *ui;：这个指针与 .ui 文件（Formfile）密切相关，用于访问界面上的控件。

3. `widget.ui`

双击该文件会调用 QT Designer，打开图形化编辑器，可以从左侧拖拽控件到界面上。
返回代码编辑区可以看到其格式，本质上是 XML 文件。
这个区域已经被封装好了，我们只需运行程序即可看到界面。

4. `.pro` 文件

这是 QT 的工程文件。

QT += core gui：指定项目需要引入的 QT 模块。
SOURCES， HEADERS， FORMS：这些部分列出了项目中的源文件、头文件和界面文件。通常不需要手动修改，QT Creator 会自动维护。

5. 运行后生成的文件

运行项目后，会生成一个 build- 开头的文件夹。
ui_widget.h 是由 widget.cpp 里的 setupUi 调用（ui->setupUi(this);）所创建的。
它根据 .ui 文件生成了具体的界面设置代码。

三、创建控件

1. Label（标签）

图形化创建：
- 在 widget.ui 中拖拽 Label 到界面上即可。
- 此时，在 widget.ui 文件里就会有一个 QLabel 标签。
代码创建：
- 在 widget.cpp 的构造函数中创建。
- 在 main 函数中有 Widget w; 这一行，创建 Widget 对象时就会调用构造函数，从而创建出画面。
- 添加头文件：#include <QLabel> (QT 历史较早，有 .h 和没有 .h 的头文件都存在，两者都可以)。
- 创建对象并指定父对象：
```
QLabel* q1 = new QLabel(this); // this 就是 Widget w，给这个标签指定父对象
q1->setText("Hello World");
```
- QT 有自己封装的字符串类 QString。开发时 std::string 和 QString 都可以用，但 QString 在处理编码（尤其是中文）时更友好。
- 注意：这里没有 delete 不会造成内存泄露。
  - 原因：QT 使用对象树机制，当父对象（Widget）被销毁时，会自动销毁其所有子对象（如这里的 q1）。
- 如果将 QLabel 对象创建在栈上（如 QLabel q1(this);），在构造函数结束时它就会立即销毁，导致无法显示。

2. 编辑框

单行编辑框：QLineEdit
多行编辑框：QTextEdit
图形化实现：拖拽 Line Edit 控件到界面上即可。

代码实现：

cpp

QLineEdit* q = new QLineEdit(this);
q->setText("hello world");

3. 一个简单的交互程序：点击按钮切换文字

图形界面实现：
- 拖拽一个 Push Button 到界面上。
- 使用 connect 函数连接信号与槽：
  cpp
```
connect(ui->pushButton, &QPushButton::clicked, this, &Widget::changeText);
```
  - ui->pushButton 代表按钮的对象名（可以在界面右侧的属性编辑器中修改）。
  - &QPushButton::clicked 表示接收按钮的“被点击”信号。
  - this 代表接收信号的对象（当前 Widget）。
  - &Widget::changeText 代表接收到信号后要执行的操作（槽函数），需要在 Widget 类中实现。
- 实现槽函数 changeText：
  cpp
```
void Widget::changeText() {if (ui->pushButton->text() == QString("hello world"))ui->pushButton->setText("hello qt");elseui->pushButton->setText("hello world");
}
```

使用 Lambda 表达式一步搞定：

connect(ui->pushButton, &QPushButton::clicked, this, [this]() {if (ui->pushButton->text() == QString("hello world"))ui->pushButton->setText("hello qt");elseui->pushButton->setText("hello world");
});

纯代码实现：
- 首先，在 widget.h 的 Widget 类中添加成员变量：QPushButton* pushButton;
- 在 widget.cpp 的构造函数中创建并连接：
```
pushButton = new QPushButton(this);
connect(pushButton, &QPushButton::clicked, this, &Widget::changeText);
```
- 实现 changeText 槽函数（与图形化实现中的函数体类似，只是将 ui->pushButton 换成 pushButton）。