Qt——升级系列(Level Two):Hello Qt 程序实现、项目文件解析、Qt 编程注意事项

目录

[Hello Qt 程序实现](#Hello Qt 程序实现)

使用"按钮"实现

[使用 "标签" 实现](#使用 "标签" 实现)

项目文件解析

[解释 .pro](#解释 .pro)

解释widget.h

[解释 main.cpp](#解释 main.cpp)

解释widget.cpp

解释widget.ui

[Qt 编程注意事项](#Qt 编程注意事项)

[Qt 中的命名规范](#Qt 中的命名规范)

[Qt Creator 中的快捷键](#Qt Creator 中的快捷键)

使用帮助文档

认识对象模型(对象树)

[Qt 窗口坐标体系](#Qt 窗口坐标体系)

Hello Qt 程序实现

使用"按钮"实现

纯代码方式实现:

cpp 复制代码
// Widget构造函数的实现
Widget::Widget(QWidget *parent)
    : QWidget(parent)  // 使用父类构造函数初始化QWidget,传入父窗口指针
    , ui(new Ui::Widget)  // 创建Ui::Widget类的实例,并用new动态分配内存
{
    // 调用ui的setupUi函数来初始化界面,传入this指针,即将当前Widget实例与设计的UI绑定
    ui->setupUi(this);
    
    // 创建一个QPushButton对象指针btn
    QPushButton *btn = new QPushButton;
    
    // 设置按钮的文本为"Hello_Qt"
    btn->setText("Hello_Qt");
    
    // 设置按钮的父窗口为当前Widget,这样按钮会自动被管理(包括销毁)
    btn->setParent(this);
}

// Widget析构函数的实现
Widget::~Widget()
{
    // 释放ui指针所指向的内存,防止内存泄漏
    delete ui;
}

代码结果:

可视化操作实现:

(1)双击:" widget.ui " ⽂件;

(2)拖拽控件⾄ ui 界⾯窗⼝并修改内容;

(3)构建并运⾏,效果如下所⽰:

使用 "标签" 实现

纯代码方式实现:

cpp 复制代码
#include "widget.h"      // 包含自定义Widget类的头文件
#include "ui_widget.h"   // 包含由Qt Designer生成的用户界面类头文件
#include <QLabel>         // 包含QLabel控件的头文件,用于显示文本
#include <QFont>          // 包含QFont类,用于设置字体样式

// Widget类的构造函数
Widget::Widget(QWidget *parent)
    : QWidget(parent)     // 调用基类QWidget的构造函数,传入父窗口指针
    , ui(new Ui::Widget)  // 使用new动态创建Ui::Widget实例
{
    // 初始化由Qt Designer设计的界面
    ui->setupUi(this);

    // 创建一个新的QLabel对象,并将其父窗口设为当前Widget
    QLabel *lab = new QLabel(this);
    
    // 设置QLabel的显示文本为"Hello Qt"
    lab->setText("Hello Qt");

    // 设置窗口固定大小为800x600像素
    setFixedSize(800, 600);

    // 创建QFont对象,设置字体为"华文行楷",字号为64
    QFont font("华文行楷", 64);
    
    // 将创建的字体应用到QLabel上
    lab->setFont(font);

    // 移动QLabel的位置到屏幕上的(0, 300)
    lab->move(0, 300);

    // 设置QLabel的文字颜色为蓝色
    lab->setStyleSheet("color:blue");
}

// Widget类的析构函数
Widget::~Widget()
{
    // 清理由new分配的ui对象,防止内存泄漏
    delete ui;
}

代码结果:

可视化操作实现:

(1)双击:" widget.ui " ⽂件;

(2)拖拽 "标签" ⾄ UI 设计界⾯中,并双击修改标签内容;

(3)实现效果如下图所⽰:

项目文件解析

在我们创建完一个项目后,Qt Creator 会默认给我们生成以下文件:

解释 .pro

cpp 复制代码
# Qt项目配置文件 (.pro) 示例

# 添加必需的Qt模块:core和gui。core模块包含基础运行时功能,而gui模块用于构建图形用户界面。
QT       += core gui

# 如果当前使用的Qt版本主版本号大于4,则额外添加widgets模块,因为从Qt5开始,widgets被分离出来作为一个独立模块。
greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

# 配置项目以使用C++11标准。这对于利用现代C++特性如auto、lambda表达式等是必要的。
CONFIG += c++11

# 定义宏QT_DEPRECATED_WARNINGS,使得编译器在遇到Qt中已标记为过时的功能时发出警告。
# 这有助于开发者及时迁移代码,避免使用即将不支持的API。
DEFINES += QT_DEPRECATED_WARNINGS

# 注释掉的行展示了如何禁止使用指定版本之前的所有过时API。
# 解除注释并设置期望的版本(如QT_DISABLE_DEPRECATED_BEFORE=0x060000禁用Qt6.0.0前的过时API),
# 可强制编译失败而不是警告,确保代码完全不含旧API。
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # 禁用所有在Qt 6.0.0之前废弃的API

# 指定源文件,项目将从这些文件编译生成可执行代码。
SOURCES += \
    main.cpp \
    widget.cpp

# 指定头文件,这些是源文件中可能引用的声明文件。
HEADERS += \
    widget.h

# 指定UI表单文件,这些是通过Qt Designer设计的界面文件,将被编译为C++代码。
FORMS += \
    widget.ui

# 部署规则设定:
# - 对于QNX系统,目标路径设置为/tmp/${TARGET}/bin
# - 对于其他Unix系统(非Android),目标路径设置为/opt/${TARGET}/bin
# 如果target.path被设置了(即不为空),那么会自动添加一个安装步骤(INSTALLS += target)来安装生成的可执行文件到指定路径。
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

.pro ⽂件的写法如下:

  1. 注释:从 "#" 开始,到这⼀⾏结束。

  2. QT += core gui // Qt 包含的模块 Qt5 包含的模块如下图所⽰:

  1. greaterThan(QT_MAJOR_VERSION, 4): QT += widgets 这条语句的含义是,如果QT_MAJOR_VERSION ⼤于 4 也就是当前使⽤的 Qt5 及更⾼版本) 需要增加 widgets 模块。如果项⽬仅需⽀持 Qt5 , 也可以直接添加 "QT += widgets" ⼀句。不过为了保持代码兼容 ,最好还是按照 QtCreator ⽣成的语句编写。

  2. 指定⽣成的应⽤程序名:TARGET = QtDemo

  3. TEMPLATE = app //模板。告诉 qmake 为这个应⽤程序⽣成哪种 makefile。下⾯是可供选择的模板:

⚫ app:建⽴⼀个应⽤程序的 makefile。这是默认值,所以如果模板没有被指定,这个将被使⽤。

⚫ lib :建⽴⼀个库的 makefile。

⚫ vcapp:建⽴⼀个应⽤程序的 VisualStudio 项⽬⽂件。

⚫ vclib: 建⽴⼀个库的 VisualStudio 项⽬⽂件。

⚫ subdirs:这是⼀个特殊的模板,它可以创建⼀个能够进⼊特定⽬录的 makefile 并且为它调⽤make 的 makefile。

  1. ⼯程中包含的源⽂件:SOURCES += main.cpp/widget.cpp

  2. ⼯程中包含的头⽂件:HEADERS += widget.h

  3. ⼯程中包含的资源⽂件:RESOURCES += painter.qrc

  4. ⼯程中包含的 "ui" 设计⽂件:FORMS += widget.ui

  5. 配置信息:CONFIG += c++11 (使⽤ c++11 的特性) CONFIG ⽤来告诉 qmake 关于应⽤程序的配置信息。

解释widget.h

cpp 复制代码
// widget.h 文件头部使用预处理器指令防止多次包含
#ifndef WIDGET_H
#define WIDGET_H

// 包含基类 QWidget 的头文件,以便继承
#include <QWidget>

// 使用QT_BEGIN_NAMESPACE和QT_END_NAMESPACE包裹Ui命名空间的声明,
// 以符合Qt的编码规范,避免命名冲突。
QT_BEGIN_NAMESPACE
namespace Ui {
    // 前向声明Ui::Widget类,该类由uic自动生成并用于界面管理
    class Widget;
}
QT_END_NAMESPACE

// 类Widget的声明,它公有继承自QWidget
class Widget : public QWidget
{
    // Q_OBJECT 宏是必须的,用于Qt的信号与槽机制以及国际化支持
    Q_OBJECT

public:
    // 构造函数,接受一个指向父组件的指针,默认为nullptr
    explicit Widget(QWidget *parent = nullptr);
    // 析构函数,清理资源
    ~Widget();

private:
    // 私有成员变量,指向由Qt设计师生成的界面类实例
    Ui::Widget *ui; // 实例化Ui::Widget用于界面控制
};

// 结束条件编译,确保WIDGET_H只被定义一次
#endif // WIDGET_H

在Qt中,如果要使⽤信号与槽(signal 和 slot)的机制 就必须加⼊ Q_OBJECT 宏;

Ui::Widget *ui; 这个指针是⽤前⾯声明的 namespace Ui ⾥的 Widget 类定义的,所以指针 ui 是指向可视化设计的界⾯,后⾯要访问界⾯上的组件,都需要通过这个指针 ui 去访问。

解释 main.cpp

cpp 复制代码
// 包含自定义窗口部件类(Widget)的实现文件
#include "widget.h"

// 引入QApplication类,用于管理整个GUI应用程序的控制流程
#include <QApplication>

// 应用程序的主函数
int main(int argc, char *argv[])
{
    // 创建QApplication对象,argc和argv是从命令行传入的参数,
    // 这一行是Qt GUI应用的起点,管理事件循环和提供系统级别的功能
    QApplication a(argc, argv);
    
    // 实例化自定义窗口部件Widget类
    Widget w;
    
    // 调用窗口部件的show()方法,使窗口在屏幕上显示出来
    w.show();
    
    // 启动Qt的事件循环,a.exec()会一直运行直到事件循环结束,
    // 通常当所有窗口关闭时事件循环结束,然后返回 exitCode 给操作系统
    return a.exec();
}

解释:

  1. Qt 系统提供的标准类名 声明头⽂件没有 .h 后缀;

  2. Qt ⼀个类对应⼀个头⽂件,类名 就是 头⽂件名;

  3. QApplication 为应⽤程序类;QApplication a;(a为应⽤程序对象,有且仅有⼀个。)

⚫ QApplication 管理图形⽤⼾界⾯应⽤程序的控制流和主要设置。

⚫ QApplication 是 Qt 的整个后台管理的命脉。它包含主事件循环,在其中来⾃窗⼝系统和其它资源的所有事件处理和调度。它也处理应⽤程序的初始化和结束,并且提供对话管理。

⚫ 对于任何⼀个使⽤ Qt 的图形⽤⼾界⾯应⽤程序,都正好存在⼀个 QApplication 对象,⽽不论这个应⽤程序在同⼀时间内是不是有 0、1、2 或更多个窗⼝。

  1. myWidget w; //实例化窗⼝对象

  2. w.show(); //调⽤show函数显⽰窗⼝

  3. a.exec() :程序进⼊消息循环,等待对⽤⼾输⼊进⾏响应。这⾥ main()把控制权转交给Qt,Qt 完成事件处理⼯作,当应⽤程序退出的时候 exec() 的值就会返回。在 exec() 中,Qt 接受并处理⽤⼾和系统的事件并且把它们传递给适当的窗⼝部件。

解释widget.cpp

widget.cpp ⽂件是类 Widget 的实现代码,所有在窗体上要实现的功能添加在此⽂件中;

cpp 复制代码
// 包含自定义窗口部件类的头文件
#include "widget.h" 

// 包含由Qt Designer生成的用户界面类头文件,用于界面布局和控件
#include "ui_widget.h"

// Widget类构造函数
Widget::Widget(QWidget *parent)
    : QWidget(parent)  // 使用基类QWidget的构造函数初始化,传入父窗口指针
    , ui(new Ui::Widget)  // 创建Ui::Widget类的实例,并用new动态分配内存
{
    // 调用ui->setupUi(this)来初始化界面,this指针指向当前Widget实例,
    // 这一步会根据.ui文件设置窗口的布局和控件
    ui->setupUi(this);
}

// Widget类析构函数
Widget::~Widget()
{
    // 当Widget实例被销毁时,释放之前动态分配的ui对象的内存
    delete ui;
}

解释widget.ui

widget.ui 是窗体界⾯定义⽂件,是⼀个 XML ⽂件,定义了窗⼝上的所有组件的属性设置、布局,及其信号与槽函数的关联等。⽤ UI 设计器可视化设计的界⾯都由 Qt ⾃动解析,并以 XML ⽂件的形式保存下来。在设计界⾯时,只需在 UI 设计器⾥进⾏可视化设计即可,⽽不⽤管 widget.ui ⽂件是怎么⽣成的。

cpp 复制代码
<!-- XML声明部分,定义了文档的版本为1.0,字符编码为UTF-8 -->
<?xml version="1.0" encoding="UTF-8"?>

<!-- 开始定义Qt用户界面文件,版本号为4.0 -->
<ui version="4.0">

  <!-- 定义用户界面的主类名为Widget -->
  <class>Widget</class>

  <!-- 实际的窗口部件配置开始,这是一个QWidget类型的窗口部件 -->
  <widget class="QWidget" name="Widget">

    <!-- 设置窗口部件的初始几何属性 -->
    <property name="geometry">
      <!-- 使用矩形(rect)来具体定义位置和大小 -->
      <rect>
        <x>0</x> <!-- X轴坐标起始于0 -->
        <y>0</y> <!-- Y轴坐标起始于0 -->
        <width>800</width> <!-- 窗口宽度为800像素 -->
        <height>600</height> <!-- 窗口高度为600像素 -->
      </rect>
    </property>

    <!-- 设置窗口的标题 -->
    <property name="windowTitle">
      <string>Widget</string> <!-- 窗口标题为"Widget" -->
    </property>

  </widget> <!-- QWidget配置结束 -->

  <!-- 资源部分,目前没有定义任何额外资源 -->
  <resources/>

  <!-- 连接部分,目前没有定义任何信号与槽的连接 -->
  <connections/>

</ui> <!-- 用户界面定义结束 -->

Qt 编程注意事项

Qt 中的命名规范

  • 类名:⾸字⺟⼤写,单词和单词之间⾸字⺟⼤写;
  • 函数名及变量名:⾸字⺟⼩写,单词和单词之间⾸字⺟⼤写;

Qt Creator 中的快捷键

  • 注释:ctrl + /
  • 运⾏:ctrl + R
  • 编译:ctrl + B
  • 字体缩放:ctrl + ⿏标滑轮
  • 查找:ctrl + F
  • 整⾏移动:ctrl + shift + ⬆/⬇
  • 帮助⽂档:F1
  • ⾃动对⻬:ctrl + i;
  • 同名之间的 .h 和 .cpp 的切换:F4
  • ⽣成函数声明的对应定义: alt + enter

使用帮助文档

打开帮助⽂档有三种⽅式. 实际编程中使⽤哪种都可以.

1、光标放到要查询的类名/⽅法名上, 直接按 F1。

2、Qt Creator 左侧边栏中直接⽤⿏标单击 "帮助" 按钮:


3、找到 Qt Creator 的安装路径,在 "bin" ⽂件夹下找到 assistant.exe,双击打开;

认识对象模型(对象树)

在 Qt 中创建很多对象的时候会提供⼀个 Parent 对象指针,下⾯来解释这个 parent 到底是⼲什么的。
QObject 是以对象树的形式组织起来的。

  • 当创建⼀个 QObject 对象时,会看到 QObject 的构造函数接收⼀个 QObject 指针作为参数,这 个参数就是 parent,也就是⽗对象指针。
  • 这相当于,在创建 QObject 对象时,可以提供⼀个其⽗对象,我们创建的这个 QObject 对象 会⾃动添加到其⽗对象的 children() 列表。
  • 当⽗对象析构的时候,这个列表中的所有对象也会被析构。(注意,这⾥的⽗对象并不是继承意义上的⽗类!)

这种机制在 GUI 程序设计中相当有⽤。例如,⼀个按钮有⼀个 QShortcut(快捷键)对象作为其⼦对象。当删除按钮的时候,这个快捷键理应被删除。这是合理的。

QWidget 是能够在屏幕上显⽰的⼀切组件的⽗类。

  • QWidget 继承⾃ QObject ,因此也继承了这种对象树关系。⼀个孩⼦⾃动地成为⽗组件的⼀个⼦组件。因此,它会显⽰在⽗组件的坐标系统中,被⽗组件的边界剪裁。例如,当⽤⼾关闭⼀个对话框的时候,应⽤程序将其删除,那么,我们希望属于这个对话框的按钮、图标等应该⼀起被删除。事实就是如此,因为这些都是对话框的⼦组件。

  • 当然,我们也可以⾃⼰删除⼦对象,它们会⾃动从其⽗对象列表中删除。⽐如,当我们删除了⼀个⼯具栏时,其所在的主窗⼝会⾃动将该⼯具栏从其⼦对象列表中删除,并且⾃动调整屏幕显⽰。
    Qt 引⼊对象树的概念,在⼀定程度上解决了内存问题。

  • 当⼀个 QObject 对象在堆上创建的时候,Qt 会同时为其创建⼀个对象树。不过,对象树中对象的顺序是没有定义的。这意味着,销毁这些对象的顺序也是未定义的。

  • 任何对象树中的 QObject 对象 delete 的时候,如果这个对象有 parent,则⾃动将其从 parent 的children() 列表中删除;如果有孩⼦,则⾃动 delete 每⼀个孩⼦。Qt 保证没有 QObject 会被delete 两次,这是由析构顺序决定的。

如果 QObject 在栈上创建,Qt 保持同样的⾏为。正常情况下,这也不会发⽣什么问题。来看下⾯的代码⽚段:

作为⽗组件的 window 和作为⼦组件的 quit 都是 QObject 的⼦类(事实上,它们都是QWidget的⼦类,⽽QWidget 是 QObject 的⼦类)。这段代码是正确的,quit 的析构函数不会被调⽤两次,因为标准 C++ 要求,局部对象的析构顺序应该按照其创建顺序的相反过程。因此,这段代码在超出作⽤域时,会先调⽤ quit 的析构函数,将其从⽗对象 window 的⼦对象列表中删除,然后才会再调⽤window 的析构函数。

但是,如果我们使⽤下⾯的代码:

情况⼜有所不同,析构顺序就有了问题。我们看到,在上⾯的代码中,作为⽗对象的 window 会⾸先被析构,因为它是最后⼀个创建的对象。在析构过程中,它会调⽤⼦对象列表中每⼀个对象的析构函数,也就是说, quit 此时就被析构了。然后,代码继续执⾏,在 window 析构之后,quit 也会被析构,因为 quit 也是⼀个局部变量,在超出作⽤域的时候当然也需要析构。但是,这时候已经是第⼆次调⽤ quit 的析构函数了,C++ 不允许调⽤两次析构函数,因此,程序崩溃了。

由此我们看到,Qt 的对象树机制虽然在⼀定程度上解决了内存问题,但是也引⼊了⼀些值得注意的事情。这些细节在今后的开发过程中很可能时不时跳出来烦扰⼀下,所以,我们最好从开始就养成良好习惯。

总结:在 Qt 中,尽量在构造的时候就指定 parent 对象,并且⼤胆在堆上创建。

Qt对象树如图:

Qt 窗口坐标体系

坐标体系:以左上⻆为原点(0,0),X向右增加,Y向下增加。

对于嵌套窗⼝,其坐标是相对于⽗窗⼝来说的。

⽰例:使⽤Qt中的坐标系设置控件的位置;

代码结果:

相关推荐
学习前端的小z1 分钟前
【前端】深入理解 JavaScript 逻辑运算符的优先级与短路求值机制
开发语言·前端·javascript
神仙别闹9 分钟前
基于C#和Sql Server 2008实现的(WinForm)订单生成系统
开发语言·c#
XINGTECODE10 分钟前
海盗王集成网关和商城服务端功能golang版
开发语言·后端·golang
zwjapple26 分钟前
typescript里面正则的使用
开发语言·javascript·正则表达式
小五Five28 分钟前
TypeScript项目中Axios的封装
开发语言·前端·javascript
前端每日三省29 分钟前
面试题-TS(八):什么是装饰器(decorators)?如何在 TypeScript 中使用它们?
开发语言·前端·javascript
凡人的AI工具箱42 分钟前
15分钟学 Go 第 60 天 :综合项目展示 - 构建微服务电商平台(完整示例25000字)
开发语言·后端·微服务·架构·golang
chnming19871 小时前
STL关联式容器之map
开发语言·c++
进击的六角龙1 小时前
深入浅出:使用Python调用API实现智能天气预报
开发语言·python
檀越剑指大厂1 小时前
【Python系列】浅析 Python 中的字典更新与应用场景
开发语言·python