Qt6入门教程 9:QWidget、QMainWindow和QDialog

目录

一.QWidget

1.窗口和控件

2.事件

二.QMainWindow

三.QDialog

1.模态对话框

1.1.模态对话框

1.2.半模态对话框

2.非模态对话框

3.小结


在用Qt Creator创建Qt Widgets项目时,会默认提供三种基类以供选择,它们分别是QWidget、QMainWIndow和QDialog,其中QMainWindow和QDialog的基类都是QWidget。

一.QWidget

QWidget是所有用户界面对象的基类,它从窗口系统中接收鼠标、键盘和其他事件,并在屏幕上绘制自己。未嵌入到父窗口的小部件称为窗口,否则称之为控件。通常窗口包含边框和标题栏,当然也可用设置窗口标志(window flags)去掉窗口的边框和标题栏。在Qt中,QMainWindow和QDialog的各种子类是最常见的窗口类型。

1.窗口和控件

没有父窗口的小部件通常是独立窗口(顶层小部件),对于窗口,可以用setWindowTitle()和setWindowIcon()来设置标题栏的标题和图标。

有父窗口的小部件称为控件,它们通常内嵌到父窗口中。Qt中大多数小部件都是当控件使用的,比如,尽管标签(QLabel)可以显示为一个窗口,但一般不这么用,通常把它作为窗口的一个控件,就像前面的HelloWorld项目那样。

通常情况下,如果需要嵌入到其他窗口中,则基于QWidget创建。

2.事件

小部件会响应用户操作产生的各种事件。Qt通过QEvent子类实例调用特定的事件处理函数(QEvent子类中包含每个事件的详细信息),将事件传递到小部件。

下面是与QWidget相关事件的简介。

●最常用的事件处理函数

paintEvent():小部件重绘时被调用。如果要显示自定义内容,必须实现它。使用QPainter绘制只能在paintEvent()或paintEvent()调用的函数中进行。

resizeEvent():小部件大小变化时被调用

mousePressEvent():通常在两种情况下被调用。一是鼠标指针在小部件内,并点击了鼠标按键;二是小部件通过grabMouse()函数把鼠标抢占了。按下鼠标不放和调用grabMouse()的效果是一样的。

mouseReleaseEvent():当鼠标按键释放时被调用。小部件只有在接收了相应的鼠标按下事件,才会接收鼠标释放事件,这两事件是一一对应的关系。有一个例外,如果在按住鼠标的同时弹出菜单,则此弹出菜单会立即偷走鼠标事件(进入菜单的事件循环中)。

mouseDoubleClickEvent():在小部件中双击会被调用。双击实际上是当做两次单击处理的,如果双击的时候手抖了,可能还会收到鼠标移动事件。需要注意的是,在第二次点击到达之前,是无法区分单击和双击的,所以不要试图在双击事件里处理单击逻辑。

●如果要接受键盘输入,需要多实现几个事件处理函数

keyPressEvent():当键盘按键按下是被调用。长按会重复调用。

focusInEvent():当小部件获取键盘焦点时被调用。

focusOutEvent():当小部件失去键盘焦点时被调用。

●不那么常用的事处理函数

mouseMoveEvent():当鼠标按键按下且移动鼠标时被调用。这在拖拽时非常有用。如果调用了setMouseTracking(true),不用按下鼠标也能也能触发这个事件啦。

keyReleaseEvent():在键盘按键释放时被调用。

wheelEvent():当焦点在小部件上,滚动鼠标滚轮时被调用。

enterEvent():当鼠标移动到小部件时被调用。但不包括其中的子部件,比如窗口中有个按钮,鼠标移动到按钮上并不会触发窗口的enterEvent。

leaveEvent():当鼠标移动到小部件时被调用。同理,鼠标离开了子部件,不会触发父部件的leaveEvent。

moveEvent():当小部件在父窗口中移动时被调用。

closeEvent():当小部件关闭时被调用。

有些事件并没有预置的事件处理函数,处理这些事件时,需要直接重写event()。所有的事件类型,详见:Qt Assistant--->QEvent::Type

关于Qt的事件系统,后面会用一篇博客单独介绍。

二.QMainWindow

QMainWindow是Qt框架自带的一个预定义好的主窗口类。所谓主窗口,就是一个应用程序最顶层的窗口,比如Qt Creator就是一个主窗口。经典的主窗口通常是由一个标题栏,一个菜单栏,若干工具栏和一个任务栏组成。在这些子组件之间则是我们的工作区。事实上,QMainWindow正是这样的一种布局,如下图所示:

在QMainWindow中可以添加QMenuBar(菜单栏)、QToolBar(工具栏)、QStatusBar(状态栏)以及QDockWidget(停靠窗体)

QMainWindow中必须要有Central Widget(中心小部件),中心小部件可以是Qt自带控件,比如QTextEdit或QGraphicsView,也可以是自定义控件。可以通过setCentralWidget()函数来设置中心小部件。

当QMainWindow用于单文档(SDI)或多文档(MDI)应用程序,可以将QMdiArea设置为中心小部件。

下面是设置QTextEdit为中心小部件的代码。

●新建txt文件,将后缀改为pro,pro内容如下:

cpp 复制代码
QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

SOURCES += \
    main.cpp

简单解释一下pro文件。首先,我们定义了QT,用于告诉编译器,需要使用哪些模块,我们通常需要添加core和gui。第二行,如果 Qt 的主版本号(QT_MAJOR_VERSION)大于4,也就是Qt5,则需要另外添加widgets(因为在Qt5中,所有组件都是在widgets 模块定义的)。SOURCES 和 HEADERS 顾名思义,就是项目所需要的源代码文件和头文件,这里不需要头文件。现在有个基本的概念即可,以后随着项目的不断增大,pro文件会越来越复杂。

●在pro同目录新建main.cpp,内容如下:

cpp 复制代码
#include <QApplication>
#include <QMainWindow>
#include <QTextEdit>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMainWindow w;
    w.setWindowTitle("https://blog.csdn.net/caoshangpa");
    QTextEdit textEdit;
    w.setCentralWidget(&textEdit);
    w.resize(400, 300);
    w.show();
    return a.exec();
}

运行一下:

关于如何添加菜单栏、工具栏和状态栏将在下一篇中介绍。

三.QDialog

QDialog是Qt框架带来的一个预定义好的对话框类。所谓对话框,主要用于短期任务以及和用户进行简要交互,对话框也是一种顶层窗口。对话框提供返回值,可以有默认按钮。QDialog也可以有一个QSizeGrip在它的右下角,使用setSizeGripEnabled(true)设置。

还是用上面的pro,man.cpp如下:

cpp 复制代码
#include <QApplication>
#include <QDialog>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QDialog w;
    w.setSizeGripEnabled(true);
    w.setWindowTitle("https://blog.csdn.net/caoshangpa");
    w.resize(400, 300);
    w.show();
    return a.exec();
}

箭头所指的就是QSizeGrip,它在无边框窗口时非常有用,可以通过拖动右下角缩放窗口。状态栏(QStatusBar)自带这个小部件,所以如果你用到了状态栏,就不需要再显式的添加QSizeGrip了。

1.模态对话框

模态对话框有两种application modal(默认)和window modal,可以通过 setWindowModality()函数设置,该函数参数是枚举值,如下表所示:

|----------------------|---|------------------------|
| 参数 | 值 | 描述 |
| Qt::NonModal | 0 | 该窗口不是模式窗口,不会阻止对其他窗口的访问 |
| Qt::WindowModal | 1 | 阻止访问与对话相关联的窗口,比如它的父窗口 |
| Qt::ApplicationModal | 2 | 阻止访问应用程序的所有其他窗口 |

模态对话框是阻塞同一应用程序中其它可视窗口输入的对话框。模态对话框有自己的事件循环,用户必须完成这个对话框中的交互操作,并且关闭了它之后才能访问应用程序中的其它任何窗口。显示模态对话框最常见的方法是调用其exec()函数,当用户关闭对话框,exec()将提供一个有用的返回值,此时流程控制继续从调用exec()的地方进行。

半模态对话框仅阻止访问与对话相关联的窗口,允许用户继续使用应用程序中的其他窗口。使用半模态对话框的步骤通常是调用setModal(true)或者setWindowModality(),然后show()。有别于exec(),show()立即将控制权返回给调用者。当用半模态对话框处理耗时操作时,必须周期性的调用QApplication::processEvents(),防止对话框卡死无法响应用户操作。

1.1.模态对话框

cpp 复制代码
#include <QApplication>
#include <QMainWindow>
#include <QDialog>
#include <QPushButton>
#include <QDebug>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMainWindow w;
    QDialog d(&w);
    d.setWindowTitle("CSDN");
    QPushButton pushButton;
    QObject::connect(&pushButton, &QPushButton::clicked, [&] {
        d.exec();
        qDebug() << "test";
    });
    pushButton.setText("Press Me");
    w.setCentralWidget(&pushButton);
    w.setWindowTitle("https://blog.csdn.net/caoshangpa");
    w.resize(400, 300);
    w.show();
    return a.exec();
}

运行一下:

此时,对话框关闭后才会打印"test"

1.2.半模态对话框

cpp 复制代码
#include <QApplication>
#include <QMainWindow>
#include <QDialog>
#include <QPushButton>
#include <QDebug>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMainWindow w;
    QDialog d(&w);
    d.setModal(true);
    // 与上面那句效果一样.
    // d.setWindowModality(Qt::ApplicationModal);
    d.setWindowTitle("CSDN");
    QPushButton pushButton;
    QObject::connect(&pushButton, &QPushButton::clicked, [&] {
        d.show();
        qDebug() << "test";
    });
    pushButton.setText("Press Me");
    w.setCentralWidget(&pushButton);
    w.setWindowTitle("https://blog.csdn.net/caoshangpa");
    w.resize(400, 300);
    w.show();
    return a.exec();
}

或者去掉d.setModal(true);并将d.show()改为d.open(),因为d.open()与下面这两句等效:

cpp 复制代码
d.setWindowModality(Qt::WindowModal);
d.show();

运行效果与模态对话框相同。不过,对话框弹出后会立即打印"test"。

2.非模态对话框

非模态对话框是和同一个程序中其它窗口操作无关的对话框。在文字处理中的查找和替换对话框通常是非模态的,允许用户同时与应用程序的主窗口和对话框进行交互。调用show()来显示非模态对话框,并立即将控制权返回给调用者。

在上面的代码中去掉d.setModal(true);就是非模态对话框了

运行一下:

对话框弹出后,继续点击按钮,可以看到,非模态对话框并不会阻塞按钮对鼠标的响应。

3.小结

显示对话框的方法有show()、open()和exec()三种。

●如果对话框已经有模态特性,则用show()方法显示的对话框具有模态特性。

●如果对话框没有模态特性,则用show()方法显示的对话框没有模态特性。

●无论对话框是否有模态特性,用open()或exec()方法显示的对话框都是模态对话框,其中用open()方法显示的对话框默认是window modal,用exec()方法显示的对话框默认是application modal。

●当程序执行到show()或open()方法时,显示对话框后会继续执行后续的代码;用exec()方法显示对话框时,需关闭对话框后才执行exec()语句的后续代码。

原文链接:Qt6入门教程 9:QWidget、QMainWindow和QDialog-CSDN博客

相关推荐
徒步僧7 小时前
ThingsBoard规则链节点:RPC Call Reply节点详解
qt·microsoft·rpc
可峰科技8 小时前
斗破QT编程入门系列之一:认识Qt:初步使用(四星斗师)
开发语言·qt
我喜欢就喜欢8 小时前
基于qt vs下的视频播放
开发语言·qt·音视频
CP-DD9 小时前
Qt的架构设计
qt
阿_旭10 小时前
基于YOLO11/v10/v8/v5深度学习的维修工具检测识别系统设计与实现【python源码+Pyqt5界面+数据集+训练代码】
人工智能·python·深度学习·qt·ai
Bruce小鬼14 小时前
QT创建按钮篇
开发语言·qt
martian66515 小时前
QT开发:掌握现代UI动画技术:深入解析QML和Qt Quick中的动画效果
开发语言·c++·qt·ui
墨染新瑞17 小时前
两个有趣的小东西(qt和类型转换)
开发语言·网络·qt
Bruce小鬼18 小时前
解决MAC安装QT启动项目不显示窗口问题
开发语言·qt·macos
云雨歇21 小时前
Qt学习笔记(三)网络编程
笔记·qt·学习