1. 创建第一个Qt窗口
任务目标
使用 Qt Widgets 模块创建一个最小可运行的图形窗口程序。窗口包含一个文本标签,显示内容为“Hello, Qt!”。通过本案例,验证 Qt 开发环境是否配置正确,并掌握 Qt 项目的基本结构。
环境与依赖
- Qt 5.15 或 Qt 6.x(Widgets 模块)
- 编译器:支持 C++11 或更高版本(如 MSVC、MinGW、Clang)
- 构建工具:qmake 或 CMake(本案例使用 qmake)
完整实现
创建项目目录 first_qt_window,在其中新建以下两个文件:
first_qt_window.pro(qmake 项目文件):
QT += widgets
TARGET = first_qt_window
TEMPLATE = app
SOURCES += main.cpp
main.cpp(程序入口):
#include <QApplication>
#include <QLabel>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QLabel label("Hello, Qt!");
label.resize(240, 80);
label.show();
return app.exec();
}
运行方式
- 在终端进入
first_qt_window目录,执行qmake生成 Makefile; - 执行
make(Windows 下若使用 MinGW 则为mingw32-make)编译项目; - 运行生成的可执行文件
first_qt_window(Windows 下为first_qt_window.exe)。
验证方法
程序启动后,屏幕上应出现一个标题为 first_qt_window 的窗口,窗口中央显示文本 Hello, Qt!。窗口大小约为 240×80 像素,可正常关闭。若窗口正常显示且无编译错误,则说明 Qt Widgets 环境配置正确,案例通过。
上图展示了程序运行后的预期窗口布局:外层为应用主窗口,标题栏显示项目名称,中央区域为 QLabel 控件及其显示的文本内容。