桌面应用 / 系统课时
创建和配置 QWidget 窗口
创建和配置 QWidget 窗口
本篇解决 Qt 桌面程序中基础窗口如何创建和调整的问题。通过配置 QWidget 的尺寸、标题、图标和窗口属性,可以掌握最常用的窗口接口,并理解这些设置如何影响用户看到的界面。
学习目标
- 掌握 QWidget 创建窗口和显示窗口的基本方法
- 理解窗口尺寸、标题和属性配置接口的作用
- 能够完成一个基础 Qt 窗口的初始化配置
QWidget 作为基础窗口对象
QWidget 是 Qt Widgets 模块中最基础的界面对象。它既可以作为独立窗口显示,也可以作为其他控件的父对象。
当 QWidget 没有父对象时,Qt 会把它作为顶层窗口处理。开发者可以通过设置尺寸、标题和窗口属性控制它的表现形式。
配置窗口基本信息
常见窗口配置通常在显示前完成。下面示例创建一个窗口,并设置标题、大小以及最小尺寸限制。
cpp
#include <QApplication>
#include <QWidget>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QWidget window;
// 设置初始大小和最小允许尺寸
window.resize(800, 600);
window.setMinimumSize(400, 300);
// 设置窗口标题
window.setWindowTitle("Qt 6 Demo Window");
window.show();
return app.exec();
}预期结果
text
启动程序后显示一个标题为 Qt 6 Demo Window 的窗口。
窗口初始大小约为 800x600,并且无法缩小到 400x300 以下。resize() 设置当前窗口大小,setMinimumSize() 限制用户调整窗口时的最小范围。实际显示大小还可能受到操作系统窗口管理策略影响。
设置窗口图标和属性
Qt 允许通过 setWindowIcon() 设置窗口图标,通过窗口属性控制特殊行为。例如某些工具窗口可能不希望显示在任务栏中,可以使用对应属性调整。
设置图标通常需要引入资源文件,而不是直接依赖磁盘路径。Qt 项目中常使用 .qrc 资源系统管理图片等文件。
片段示例:
cpp
#include <QIcon>
window.setWindowIcon(QIcon(":/icons/app.png"));预期结果
text
窗口标题栏显示资源中的应用图标。其中 :/icons/app.png 是 Qt 资源系统路径,需要提前在项目资源文件中注册。
常用窗口接口对比
| 接口 | 作用 | 使用场景 |
|---|---|---|
resize() |
设置当前窗口大小 | 初始化窗口尺寸 |
setMinimumSize() |
设置最小尺寸限制 | 防止界面缩放过小 |
setMaximumSize() |
设置最大尺寸限制 | 固定窗口范围 |
setWindowTitle() |
设置标题文字 | 标识当前窗口 |
show() |
显示窗口 | 完成初始化后展示 |
配置窗口时的注意事项
窗口属性应尽量在 show() 之前设置。窗口显示后再修改部分属性虽然可以生效,但可能导致界面重新布局或产生短暂刷新。
对于复杂应用,不建议直接在 main 函数中堆积大量窗口配置。通常会创建继承自 QWidget 的窗口类,把初始化逻辑放入构造函数中,让界面代码更容易维护。
例如主窗口、设置窗口、对话框等都可以通过继承 QWidget 或其子类实现,而窗口创建流程仍然遵循 Qt 对象模型和事件循环机制。
按自己的节奏,确认真正理解。