Qt窗口类部件

一、窗口类部件

窗口就是没有父部件的部件，所以又称顶级部件。窗口类主要包括基本窗口类QWidget、对话框类QDialog和主窗口类QMainWindow三种。

QObject是Qt框架中的一个核心基类，它提供了对象模型和信号槽机制。而QPaintDevice及其子类则提供了绘制和显示内容的功能。

Paint = 绘制、涂画

Device = 设备、载体

1、QObject类

QObject类是所有Qt类的基类，它提供了对象模型和信号槽机制。任何对象要实现信号与槽机制，都必须使用Q_OBJECT宏。因此不管是否真正用到信号与槽机制，最好在所有QObject子类中都使用Q_OBJECT宏，避免出现不必要的错误。

#ifndef MYWIDGET_H
#define MYWIDGET_H
#include <QWidget>class MyWidget:public QWidget
{Q_OBJECT
public:explicit MyWidget(QWidget *parent = nullptr);
};#endif // MYWIDGET_H

2、QWidget

Qt 中所有用户界面对象的基类，是最基本的可视元素。可以作为一个独立的窗口（顶级窗口部件）存在，或者作为另一个 QWidget 的子部件（嵌入式窗口部件）。

没有划分菜单、工具栏、状态栏、主窗口 等区域。

3、QMainWindow

是 QWidget的子类，包含菜单栏，工具栏，状态栏，标题栏等，中间部分则为主窗口区域。

4、QDialog

是 QWidget 的子类，用于与用户进行简短交互，如确认操作。

对话框在外观上和基本窗口相似。通常由标题栏、客户区、边框组成，标题栏上有关闭按钮。

二、基本窗口类QWidget

QWidget类是所有用户界面类的基类，也是所有可视组件（窗口部件）的基类，所有的窗口、按钮、标签、文本框等控件都是直接或间接从QWidget派生而来。

• 既可以作为独立窗口存在，也可以作为另一个窗口部件的子部件嵌入其中。
• 通常用于创建不带特定框架结构（如菜单栏、工具栏）的窗口或自定义界面组件。

创建QWidget窗口的代码示例：

#include "widget.h"            // 引入自定义的头文件（通常包含 QWidget 子类，如果没定义可以不需要）
#include <QApplication>        // 引入 QApplication 类，Qt 程序的入口类
#include <QWidget>             // 引入 QWidget 类，Qt 所有控件的基类
#include <QDebug>              // 引入 QDebug，方便调试时打印信息int main(int argc, char *argv[])
{QApplication a(argc, argv); // 创建 Qt 应用程序对象，接收命令行参数，管理整个 Qt 程序的运行环境QWidget w;                  // 创建一个 QWidget 窗口对象（窗口部件实例）w.setWindowTitle("这里是标题"); // 设置窗口的标题栏文字w.resize(300,200);          // 设置窗口的大小（宽 300，高 200），只影响用户区域，不包含标题栏和边框w.move(500,500);            // 将窗口移动到屏幕上的位置（左上角坐标为 x=500, y=500）w.setCursor(Qt::UpArrowCursor); // 设置鼠标指针的形状为“向上箭头”光标// w.setCursor(Qt::PointingHandCursor); // （另一种光标示例：手形光标）w.show();                   // 显示窗口（默认隐藏，必须调用 show() 才能在屏幕显示）return a.exec();            // 启动 Qt 事件循环，等待并处理用户操作（比如鼠标、键盘、窗口事件）
}

• QApplication：整个 Qt GUI 程序必须有且只有一个，用来管理事件循环。
• Cursor:（光标）
• QWidget：最基础的窗口类，可以单独作为窗口，也可以作为控件嵌入其他窗口。
• w.setXXX(...)：调用 QWidget 提供的接口设置窗口属性。
• w.show()：把窗口显示出来。
• a.exec()：进入消息循环，没有它程序会一闪而过。

三、主窗口类QMainWindow

QMainWindow类的实例是一个可以设置菜单栏、工具栏、状态栏的主应用程序窗口。主要组成部分：

1. 菜单栏 (Menu Bar): 位于窗口顶部，通常包含多个菜单。
2. 工具栏 (Toolbars): 可以放置在窗口的顶部、底部或两侧，包含常用的按钮和控件。
3. 状态栏 (Status Bar): 位于窗口底部，显示一些临时信息或状态。
4. 中心窗口部件 (Central Widget): 位于主窗口的中央区域，可以放置任何 QWidget 子类的实例。这个中心窗口部件可以有自己的布局。

int main(int argc, char *argv[])
{QApplication a(argc, argv);     // 创建 Qt 应用程序对象，管理整个应用的事件循环和资源QMainWindow w;                  // 创建一个 QMainWindow 对象（主窗口），适合做应用的框架界面w.setWindowTitle("主窗口");      // 设置窗口标题为“主窗口”QMenuBar *bar = w.menuBar();    // 获取主窗口自带的菜单栏指针（QMainWindow 已经内置了菜单栏）// ====== 创建一个“文件”菜单（含快捷键 Alt+F）======QMenu *fmenu = new QMenu("文件(&F)");  // 创建“文件”菜单，&F 表示按 Alt+F 激活此菜单fmenu->addAction("新建文件");          // 在“文件”菜单里添加一个动作（菜单项）→“新建文件”fmenu->addMenu("访问最近文件");        // 在“文件”菜单里再添加一个子菜单 →“访问最近文件”// ====== 把“文件”菜单加入菜单栏 ======bar->addMenu(fmenu);                   // 将“文件”菜单添加到菜单栏bar->addMenu("编辑(&E)");              // 在菜单栏添加“编辑”菜单，快捷键 Alt+Ebar->addMenu("构建(&B)");              // 在菜单栏添加“构建”菜单，快捷键 Alt+Bbar->addMenu("调试(&D)");              // 在菜单栏添加“调试”菜单，快捷键 Alt+Dw.setMenuBar(bar);                     // 将菜单栏设置到主窗口（可省略，默认已有）// ====== 设置状态栏 ======w.statusBar()->showMessage("状态栏信息");  // 在主窗口底部的状态栏显示提示信息w.show();                              // 显示主窗口return a.exec();                       // 启动事件循环，等待并处理用户操作
}

• QMainWindow 自带菜单栏、工具栏、状态栏等，适合做应用主框架。
• QMenuBar → 菜单栏容器。
• QMenu → 菜单项（可以有子菜单和动作）。
• QStatusBar → 窗口底部的提示信息栏。
• Bar→ 栏、条、横条

四、对话框类QDialog

对话框窗口的基类，用于创建模态或非模态的对话框窗口。对话框是与用户进行简短交互的顶层窗口，通常用于显示消息或执行一些临时性的任务。

• 模态对话框：在模态对话框打开时，它会阻塞其父窗口或整个应用程序，直到用户关闭对话框。这意味着用户必须先处理对话框中的任务，才能继续与应用程序的其他部分交互。
• 非模态对话框：非模态对话框则不会阻止用户与其父窗口或其他窗口的交互，它独立于主窗口运行，允许用户同时操作多个窗口。

int main(int argc, char* argv[])
{QApplication a(argc, argv);   // 创建应用程序对象，管理整个事件循环Widget w;                     // 创建一个自定义窗口部件（Widget 继承自 QWidget）w.show();                     // 显示这个主窗口QDialog d;                    // 创建一个 QDialog 对话框对象d.setWindowTitle("对话框");     // 设置对话框标题为“对话框”d.setModal(true);             // 设置为模态对话框（对话框关闭前，无法操作主窗口）d.resize(200, 100);           // 设置对话框的大小为 200×100d.show();                     // 显示对话框（非阻塞方式）return a.exec();              // 启动事件循环，程序进入消息处理状态
}

• Widget w：主窗口（你自定义的窗口类，通常继承自 QWidget）。
• QDialog d：对话框窗口，标题是“对话框”。
• setModal(true)：因为是模态对话框，所以当对话框没关闭时，不能点击主窗口。
• show()：显示对话框，但不会阻塞代码（对比 exec()）。

1. 补充

1. 模态（Modal）

   • 阻塞用户对其他窗口的操作。
   • 常用于提示用户“必须先完成当前操作”。
   • 例子：弹出“保存/取消”的对话框。

2. 非模态（Modeless）

   • 不阻塞其他窗口，可以同时操作。
   • 常用于工具窗口。

3. QDialog::show() vs QDialog::exec()

   • show() → 非阻塞，只是显示窗口，程序会继续执行。
   • exec() → 阻塞，对话框关闭前，程序停在这里（常用于模态对话框）。

2. setModal(true)与 exec()的区别

1️⃣ setModal(true)

• 作用：设置对话框为 模态（Modal）。

• 影响：用户在对话框没关闭前，不能操作其它窗口（比如主窗口）。

• 显示方式：它还是要配合 show() 来显示。

  QDialog d;
  d.setModal(true);
  d.show();   // 模态对话框（禁止操作主窗口），但程序继续往下走
  qDebug() << "这行会立刻执行";
  

👉 模态只是限制 用户交互，但 不会阻塞代码执行。

---

2️⃣ exec()

• 作用：显示对话框，同时进入一个 本地事件循环。

• 影响：用户必须关闭对话框，程序代码才会往下执行。

• 等价效果：模态 + 阻塞。

  QDialog d;
  d.exec();   // 模态 + 阻塞，必须关闭对话框，程序才会继续
  qDebug() << "只有关掉对话框，这行才会执行";
  

---

3️⃣ 区别总结

• setModal(true) + show() → 模态非阻塞
  • 用户不能操作主窗口，但程序代码继续运行。
• exec() → 模态阻塞
  • 用户不能操作主窗口，程序代码也会停在这里，等对话框关闭才继续。

---

4️⃣ 小口诀

• setModal(true) 控制的是：用户能不能点主窗口。
• exec() 控制的是：程序能不能继续往下执行。

五、总结

1. QWidget

• 定义：Qt 所有可视化界面控件的基类（Widget = 窗口部件/控件）。
• 特点：
  • 可以作为独立窗口（如果没有父对象）。
  • 可以作为子控件嵌套在别的控件里（比如按钮、文本框）。
  • 提供了基本的绘制、事件处理（鼠标、键盘）、布局功能。
• 中文理解：小部件 / 控件。
• 例子：按钮 (QPushButton)、标签 (QLabel)、输入框 (QLineEdit) 都继承自 QWidget。

---

2. QMainWindow

• 定义：继承自 QWidget 的一个主窗口类，是 Qt 专门为应用程序的主界面准备的。
• 特点：
  • 内置了菜单栏（Menu Bar）、工具栏（Tool Bar）、状态栏（Status Bar）、停靠窗口（Dock Widget）、中心窗口（Central Widget）等。
  • 适合用来做应用程序的主框架界面。
• 中文理解：主窗口。
• 例子：像 Qt Creator、Word 这种有菜单栏、工具栏的程序，通常用 QMainWindow 搭建。

---

3. QDialog

• 定义：继承自 QWidget 的对话框类，通常用来做临时窗口。
• 特点：
  • 默认是 模态窗口（Modal）：弹出后会阻塞主窗口输入，直到关闭。
  • 也可以设为 非模态（Modeless）：和主窗口同时交互。
  • 常用于弹出提示框、登录框、设置对话框。
• 中文理解：对话框。
• 例子：弹出的“确认/取消”窗口就是 QDialog。

---

4. 三者关系

1. QObject

• 提供对象模型、信号槽机制。

2. QPaintDevice

• 提供绘制接口，所有可绘制的类都要继承它（QWidget、QPixmap、QImage…）。

3. QWidget

• 继承自 QObject（能发信号/槽）和 QPaintDevice（能被绘制）。
• 是所有控件的基类。

4. QDialog / QMainWindow

• 都是 QWidget 的子类。

• QMainWindow适合做“程序主界面”，有完整的菜单、工具栏、状态栏。

• QDialog适合做“临时对话框”，比如登录、提示、设置。

📌 类关系图（简化版）：

QObject└── QWidget (同时继承自 QPaintDevice)├── QDialog└── QMainWindow

---

✅ 总结一句：

• QPaintDevice 给 QWidget 提供了“能画”的能力；
• QObject 给 QWidget 提供了“能通信”的能力；
• 所以 QWidget 是 Qt 控件的核心基类，在它之上才有 QDialog 和 QMainWindow。