桌面应用 / 系统课时

创建和配置 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 对象模型和事件循环机制。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建和配置 QWidget 窗口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通