当前位置：首页 > article >正文

【Qt】QDialog对话框

article 2025/3/25 23:40:47

> 作者：დ旧言~
> 座右铭：松树千年终是朽，槿花一日自为荣。

> 目标：了解 Qt 对话框的基本概念，并能使用。

> 毒鸡汤：有些事情，总是不明白，所以我不会坚持。早安!

> 专栏选自：QT从基础到入门_დ旧言~的博客-CSDN博客

> 望小伙伴们点赞👍收藏✨加关注哟💕💕

一、概念

概念：

对话框是GUI程序中不可或缺的组成部分。一些不适合在主窗口实现的功能组件可以设置在对话框中。对话框通常是一个顶层窗口，出现在程序最上层，用于实现短期任务或者简洁的用户交互。

Qt常用的内置对话框有：

QFiledialog（文件对话框）
QColorDialog（颜色对话框）
QFontDialog（字体对话框）
QInputDialog（输入对话框）
QMessageBox（消息框）

二、对话框的分类

2.1、模态对话框

概念：

模态对话框指的是：显示后无法与父窗口进行交互，是一种阻塞式的对话框。使用QDialog::exec()函数调用。模态对话框使用于必须依赖用户选择的场合，如消息显示、文件选择，打印设置等。

代码示例：在菜单项中，点击菜单项时就会触发triggered()信号

#include "mainwindow.h"
#include "ui_mainwindow.h"
 
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
 
    QMenuBar* menubar = menuBar();
    this->setMenuBar(menubar);
 
    QMenu* menu1 = new QMenu("文件");
    QMenu* menu2 = new QMenu("编辑");
    menubar->addMenu(menu1);
    menubar->addMenu(menu2);
 
    QAction* action = new QAction("新建");
    menu1->addAction(action);
 
    QToolBar* toolbar = new QToolBar(this);
    this->addToolBar(toolbar);
    toolbar->addAction(action);
    
    //当点击新建时，弹出一个模态对话框
    connect(action, &QAction::triggered, [=](){
        QDialog dialog;
        dialog.resize(300, 200);
        dialog.exec();
    });
}
 
MainWindow::~MainWindow()
{
    delete ui;
}

2.2、非模态对话框

概念：

非模态对话框显示后独立存在，可以同时与父窗口进行交互，是一种非阻塞式对话框，使用QDialog::show()函数调用。
非模态对话框一般在堆上创建，若创建在栈上，弹出的非模态对话框就会一闪而过。

需设置Qt：

WA_DeleteOnClose属性。

目的是：

当创建多个非模态对话框时（如打开了多个非模态窗口），为了避免内存泄漏要设置此属性，非模态对话框适用于特殊功能设置的场合，如查找操作，属性设置等。

代码呈现：

//当点击新建时，弹出一个模态对话框
connect(action, &QAction::triggered, [=](){
    //非模态对话框，创建在堆区，防止一闪而过
    QDialog* dialog = new QDialog(this);
    //调整尺寸
    dialog->resize(300, 200);
    //当dialog无限创建时，设置该属性可以在关闭非模态对话框时自动释放该对象，防止内存泄露
    dialog->setAttribute(Qt::WA_DeleteOnClose);
    dialog->show();
});

2.3、混合属性对话框

概念：

混合属性对话框同时具有模态对话框和非模态对话框的属性，对话框的生成和销毁具有非模态对话框属性，功能上具有模态对话框的属性，使用QDialog::setModal()函数可以创建混合特性的对话框。创建对话框时需要指定对话框的父组件。

代码呈现：

connect(action, &QAction::triggered, [=]() {
    QDialog* dialog = new QDialog(this);
 
    dialog->setAttribute(Qt::WA_DeleteOnClose);
 
    dialog->setModal(true);
 
    dialog->resize(300, 200);
 
    dialog->show();
});

三、消息对话框 QMessageBox

概念：

消息对话框是应用程序中最常用的界面元素。消息对话框主要用于为用户提示重要信息，强制用户进行选择操作 QMessageBox 类中定义了静态成员函数，可以直接调用创建不同风格的消息对话框。

示例①：问题提示消息对话框

其中可以设置的按钮的类型如下：

示例②：信息提示消息对话框

实现效果如下：

四、颜色对话框QColorDialog

颜⾊对话框的功能是允许用户选择颜色，继承自QDialog类：

常用方法介绍：

QColorDialog (QWidget *parent = nullptr) //创建对象的同时设置父对象
QColorDialog(const QColor &initial, QWidget *parent = nullptr) //创建对象的同时通过QColor对象设置默认颜色和父对象
void setCurrentColor(const QColor &color) //设置当前颜色对话框
QColor currentColor() const //获取当前颜色对话框
QColor getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString&title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions()) //打开颜色选择对话框，并返回⼀个QColor对象
void open(QObject *receiver, const char *member) //打开颜色对话框

代码示例：

#include "mainwindow.h"
#include "ui_mainwindow.h"
 
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    resize(800, 600);
 
    QPushButton* btn = new QPushButton("颜色对话框", this);
    //创建颜色对话框
    QColorDialog* cdlog = new QColorDialog(this);
 
    connect(btn, &QPushButton::clicked, [=]() {
        //打开颜色对话框，并设置默认颜色为红色
        QColor color = cdlog->getColor(QColor(255, 0, 0));
        qDebug() << "r = " << color.red();
        qDebug() << "g = " << color.green();
        qDebug() << "b = " << color.blue();
    });
}
 
MainWindow::~MainWindow()
{
    delete ui;
}

五、文件对话框QFileDialog

概念：

文件对话框用于应用程序中需要打开一个外部文件或需要将当前内容存储到指定的外部文件。

常用方法介绍：

打开文件（一次只能打开一个文件）：QString getOpenFileName(QWidget *parent = nullptr, const QString &caption = QString(), const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())
打开多个文件（一次可以打开多个文件）：QStringList getOpenFileNames(QWidget *parent = nullptr, const QString &caption = QString(),const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())
保存文件：QString getSaveFileName(QWidget *parent = nullptr, const QString &caption = QString(),const QString &dir = QString(), const QString &filter = QString(), QString *selectedFilter = nullptr, QFileDialog::Options options = Options())

代码示例：打开文件