首页 Qt 学习之路 2 Qt 学习之路 2(15):标准对话框 QMessageBox

Qt 学习之路 2(15):标准对话框 QMessageBox

43 4.5K

所谓标准对话框,是 Qt 内置的一系列对话框,用于简化开发。事实上,有很多对话框都是通用的,比如打开文件、设置颜色、打印设置等。这些对话框在所有程序中几乎相同,因此没有必要在每一个程序中都自己实现这么一个对话框。

Qt 的内置对话框大致分为以下几类:

  • QColorDialog:选择颜色;
  • QFileDialog:选择文件或者目录;
  • QFontDialog:选择字体;
  • QInputDialog:允许用户输入一个值,并将其值返回;
  • QMessageBox:模态对话框,用于显示信息、询问问题等;
  • QPageSetupDialog:为打印机提供纸张相关的选项;
  • QPrintDialog:打印机配置;
  • QPrintPreviewDialog:打印预览;
  • QProgressDialog:显示操作过程。

这里我们简单地介绍一下标准对话框QMessageBox的使用。在前面有了关于对话框的基础之上,应该可以结合文档很轻松地学习如何使用 Qt 的标准对话框。其它种类的标准对话框,我们将在后面的章节中再一一介绍。

QMessageBox用于显示消息提示。我们一般会使用其提供的几个 static 函数:

  • void about(QWidget * parent, const QString & title, const QString & text):显示关于对话框。这是一个最简单的对话框,其标题是 title,内容是 text,父窗口是 parent。对话框只有一个 OK 按钮。
  • void aboutQt(QWidget * parent, const QString & title = QString()):显示关于 Qt 对话框。该对话框用于显示有关 Qt 的信息。
  • StandardButton critical(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton):显示严重错误对话框。这个对话框将显示一个红色的错误符号。我们可以通过 buttons 参数指明其显示的按钮。默认情况下只有一个 Ok 按钮,我们可以使用StandardButtons类型指定多种按钮。
  • StandardButton information(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton)QMessageBox::information()函数与QMessageBox::critical()类似,不同之处在于这个对话框提供一个普通信息图标。
  • StandardButton question(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = StandardButtons( Yes | No ), StandardButton defaultButton = NoButton)QMessageBox::question()函数与QMessageBox::critical()类似,不同之处在于这个对话框提供一个问号图标,并且其显示的按钮是“是”和“否”两个。
  • StandardButton warning(QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton)QMessageBox::warning()函数与QMessageBox::critical()类似,不同之处在于这个对话框提供一个黄色叹号图标。

我们可以通过下面的代码来演示下如何使用QMessageBox

if (QMessageBox::Yes == QMessageBox::question(this,
                                              tr("Question"),
                                              tr("Are you OK?"),
                                              QMessageBox::Yes | QMessageBox::No,
                                              QMessageBox::Yes)) {
    QMessageBox::information(this, tr("Hmmm..."), tr("I'm glad to hear that!"));
} else {
    QMessageBox::information(this, tr("Hmmm..."), tr("I'm sorry!"));
}

我们使用QMessageBox::question()来询问一个问题。这个对话框的父窗口是 this,也就是我们的 MainWindow(或者其他 QWidget 指针)。QMessageBoxQDialog的子类,这意味着它的初始显示位置将会是在 parent 窗口的中央(我们在前面的章节中提到过这一点)。第二个参数是对话框的标题。第三个参数是我们想要显示的内容。这里就是我们需要询问的文字。下面,我们使用或运算符(|)指定对话框应该出现的按钮。这里我们希望是一个 Yes 和一个 No。最后一个参数指定默认选择的按钮。这个函数有一个返回值,用于确定用户点击的是哪一个按钮。按照我们的写法,应该很容易的看出,这是一个模态对话框,因此我们可以直接获取其返回值。如果返回值是 Yes,也就是说用户点击了 Yes 按钮,我们显示一个普通消息对话框,显示“I'm glad to hear that!”,否则则显示“I'm sorry!”。运行一下我们的程序片段,就可以看到其中的不同:

QMessageBox 演示示例

QMessageBox类的 static 函数优点是方便使用,缺点也很明显:非常不灵活。我们只能使用简单的几种形式。为了能够定制QMessageBox细节,我们必须使用QMessageBox的属性设置 API。如果我们希望制作一个询问是否保存的对话框,我们可以使用如下的代码:

QMessageBox msgBox;
msgBox.setText(tr("The document has been modified."));
msgBox.setInformativeText(tr("Do you want to save your changes?"));
msgBox.setDetailedText(tr("Differences here..."));
msgBox.setStandardButtons(QMessageBox::Save
                          | QMessageBox::Discard
                          | QMessageBox::Cancel);
msgBox.setDefaultButton(QMessageBox::Save);
int ret = msgBox.exec();
switch (ret) {
case QMessageBox::Save:
    qDebug() << "Save document!";
    break;
case QMessageBox::Discard:
    qDebug() << "Discard changes!";
    break;
case QMessageBox::Cancel:
    qDebug() << "Close document!";
    break;
}

msgBox 是一个建立在栈上的QMessageBox实例。我们设置其主要文本信息为“The document has been modified.”,informativeText 则是会在对话框中显示的简单说明文字。下面我们使用了一个detailedText,也就是详细信息,当我们点击了详细信息按钮时,对话框可以自动显示更多信息。我们自己定义的对话框的按钮有三个:保存、丢弃和取消。然后我们使用了exec()是其成为一个模态对话框,根据其返回值进行相应的操作。

同时在 KDE 和 Windows 7 上编译运行一下上面的代码,我们可以看到一些区别:

自定义 QMessageBox - KDE
自定义 QMessageBox - Windows 7

除去对话框样式,我们值得注意的是QMessageBox下方按钮的排列顺序。KDE 上是 Show Details...、Save、Discard 和 Cancel;而 Windows 7 上则是 Save、Discard、Show Details... 和 Cancel。我们并没有指定按钮的顺序,Qt 已经帮我们按照不同平台的使用习惯对其进行了调整。这一点在 Mac OS 上也会有相应的体现。对于一个普通的QDialog而言,Qt 使用的是QDialogButtonBox这个类来实现不同平台的对话框按钮顺序的显示的。更多细节请参考这个类的文档。

43 评论

rophie 2013年3月12日 - 09:07

我想知道qt5中文乱码怎么解决啊?

回复
豆子 2013年3月12日 - 15:17

Qt5 使用 UTF-8 编码一般就没有乱码问题了。查看一下文件编码。

回复
otto 2013年10月14日 - 00:31

楼主,文章的“我们一般会使用其提供的几个 static 函数:”下面的几行示例代码在这网页都无法显示完全,后面显示不出来,IE chrome 和猎豹浏览器都无法显示完全

回复
豆子 2013年10月14日 - 10:10

不好意思,先前添加 CSS 时有些问题。现在已经改过来了,请刷新一遍网页。如果没有效果,先清空下缓存再刷新试试。

回复
otto 2013年12月16日 - 10:25

豆子哥,对于后面用switch语句不是很明白,可否讲解下?
switch(ret){
qDebug()<<"save document!";
break;
case QMessageBox::Discard:
qDebug()<<"Discard changes!";
break;
case QMessageBox::Cancel:
qDebug()<<"close document!";
break;

回复
豆子 2013年12月16日 - 10:44

switch 语句判断的是用户点击了哪个按钮,于是执行相应的操作。ret 实际就是对话框的返回值,其含义是用户点击的按钮。

回复
otto 2013年12月16日 - 14:18

就是说,如果我要实现什么其他功能,就把qDebug()<<"close document!";换成我想实现的功能,这里理解对吗?

回复
豆子 2013年12月16日 - 22:34

是的,把那部分代码替换成你需要的就可以了。

回复
Sanhu Li 李三乎 2014年3月19日 - 03:04

感谢博主的教程
在第二段代码后面数第二行,InformationText是不是应该是InformativeText啊

虽然说感觉InformationText更容易理解一些

回复
豆子 2014年3月19日 - 09:26

是的,文章中的内容写错了,已经修改过来,感谢指出

回复
Fez 2014年5月21日 - 22:54

豆子哥,我们点击按钮是只能返回按钮信息么?
如果我能否通过按钮返回对话框的其他信息?
例如对话框的标题?
例如InformativeText的那段文字?

回复
豆子 2014年5月23日 - 15:18

如果使用 static 函数打开对话框,对话框传入的信息你都是可以知道的。或者你可以记录下对话框的指针。

回复
Nina 2014年5月23日 - 15:43

豆子哥,我运行了之后出现提示:‘tr' was not declared in this scope.是我没添加什么头文件吗?

回复
豆子 2014年5月27日 - 09:16

有可能是你没有添加 Q_OBJECT 宏。这个函数是 Q_OBJECT 宏展开的。或者你的类不是 QObject 子类,这样的话就要用 QObject::tr() 这样的静态函数。

回复
choury 2014年5月31日 - 16:10

请问如何才能实现一个非模态的对话框呢?

回复
豆子 2014年6月3日 - 09:23

使用 show() 函数打开对话框就是非模态的。

回复
瞬间 2016年8月30日 - 23:37

int QMessageBox::exec()
void QWidget::show()
在QMessageBox类中使用,
QMessageBox *msgBox = new QMessageBox(this);
...
ret = msgBox->exec();
msgBox->QDialog::show();//ret = msgBox->QDialog::show();//error
两者返回值类型不一样, 后者为void, 无法对button处理
豆子老师可是否有办法在非模态下拿到返回值

回复
豆子 2016年9月5日 - 15:10

非模态的话只能用信号槽来获取值,或者是将指针传入,利用该指针调用某个 set 函数进行设置

回复
bin 2016年9月7日 - 01:05

指针传入?怎么个传入法?

豆子 2016年9月8日 - 09:01

自己封装QMessageBox,在构造函数中将主窗口的指针作为参数传给对话框类,就可以在对话框中调用主窗口的函数了。

孙多牛 2014年7月22日 - 22:49

写得非常好,耗时肯定不少,豆子老师辛苦了,谢谢分享。

回复
小虫色叔叔 2014年8月3日 - 18:21

QString fileName =
QFileDialog::getOpenFileName(this,
tr("Open Image"),".",
tr("Image Files(*.png *.jpg *.jpeg *.bmp)")
);
if(0 == fileName.length())
{
QMessageBox::information(
NULL,
tr("Path"),
tr("You didn't select any files.")
);
}
豆哥,当我准备打开某个文件时,已经打开选择对话框了,但是最后点了取消,这个时候程序会自动退出,我不想让程序退出而是回到准备选择打开文件的状态应该怎么写。

回复
豆子 2014年8月5日 - 21:19

你这段代码看起来没有问题,如果不作任何处理并且桌面上还留有窗口的话,程序应该是不会退出的。

回复
mseyj 2015年1月18日 - 12:51

楼主,我想让QMessageBox弹出框中的按钮上显示的文本是中文的“确定”、“取消”,而不是按钮本身的英文字符,有什么办法吗

回复
豆子 2015年1月21日 - 14:54

标准对话框的文本可以在 main() 函数中使用 Qt 国际化机制完成,加载中文文件即可,代码中不需要做任何处理。可以查看有关国际化的内容。

回复
双人鱼 2015年1月29日 - 02:01

我使用的是Qt5.3。QMessageBox::information等一系列的对话框中的按钮都是英文的。想把这些按钮上的文字改成中文的。上网查了很多资料,什么国际化啊等等,都没有成功实现。豆子老师能不能针对这个问题写一篇详细些的文章呢?

回复
豆子 2015年1月29日 - 15:35

在 main() 函数中添加类似下面的代码,

QTranslator qt;
qt.load("qt_zh_CN");
app.installTranslator( &qt );

需要注意的是 qt_zh_CN 必须能够按照路径加载。这个文件在 Qt 安装目录下可以找到。如果界面仍然是英文,可以查看 QTranslator.load() 的返回值和错误信息看出错原因。

回复
双人鱼 2015年1月29日 - 23:33

你好,豆子:
就是按照你说的这个方式去做的,结果还是不能把ok等按钮上的文字汉化成确定等。你试一下好吗?

回复
Hs 2015年7月17日 - 14:57

QString::fromLocal8Bit( "确定" )

把你的中文这样包起来,不就行了?

回复
laoreja 2015年4月13日 - 22:15

谢谢博主的讲解~
我有一个小问题,在mac下,那些QMessageBox::information的第二个标题参数都不会在标题栏显示,请问这是为什么呢?

回复
豆子 2015年4月21日 - 12:46

这一点在文档中有提到,其实是 Apple 要求的。参考 QMessageBox::setWindowTitle() 函数:On Mac OS X, the window title is ignored (as required by the Mac OS X Guidelines)

回复
2015年12月8日 - 23:56

。。部分的页面的 下一篇 和 上一篇 换过来了,但是还有没换过来的

回复
sss 2016年1月27日 - 17:39

你好,请问那个if else判断的那段代码,是要写在哪里的啊

回复
豆子 2016年1月29日 - 15:02

添加在你需要显示对话框的地方,比如按钮响应函数里面就可以了

回复
Kevin 2016年3月2日 - 20:05

豆子哥你好,我用的环境是VS2013+QT5.5.1
代码编译运行,qDebug() << “....”
这段代码在选择对应选项后在控制台没有对应的信息,应该怎么解决呢?

回复
wizshare 2016年6月2日 - 22:08

豆子,你好,我想请教一下像是文中QMessageBox::question函数的使用,我们并没有先创建一个类QMessageBox的对象,我见过QInputDialog::getInt也有这种情况。
正常的顺序不应该是先创建一个QMessageBox的对象,再调用该对象的question函数吗?

回复
豆子 2016年6月3日 - 12:44

类似 QMessageBox::question() 这样的工具函数其实是在函数内部封装了实例化的过程,因此不需要你自己手动完成:这只是一种简化函数。

回复
sheldon zuo 2016年6月5日 - 21:35

豆大大,请问 :查看msgBox.exec()怎么用help查看返回值

回复
sheldon zuo 2016年6月5日 - 21:36

豆大大,请问 :查看msgBox.exec()怎么用help文档查看返回值
讲讲怎么使用help文档吧!

回复
豆子 2016年6月6日 - 09:09

在 Qt Creator 中左侧下面有帮助,就是文档,可以直接搜索相关内容

回复
studio 2018年10月21日 - 19:32

if (QMessageBox::Yes == QMessageBox::question(this,
tr("Question"),
tr("Are you OK?"),
QMessageBox::Yes | QMessageBox::No,
QMessageBox::Yes))

question是静态方法不应该传this. 应该传NULL

回复
豆子 2018年10月27日 - 18:01

question() 是 static 函数,在 static 函数内部不能使用 this,但是在调用 static 函数的时候,当然可以把 this 作为参数传入。此时的 this 指针指向的是调用这个 static 函数的对象。

回复
stu 2020年6月3日 - 00:43

豆子哥,请教一下为什么我使用question的静态方法时,摁yes或者no都没有反应,也就是那个静态方法没有传返回值回来,只有摁回车有用
QMessageBox::StandardButton result;
result = QMessageBox::question(this,"title","content",QMessageBox::Yes | QMessageBox::No, QMessageBox::Yes);
if (result==QMessageBox::Yes){......}else{....}
摁yes或者no的时候根本不会执行到if语句

回复

回复 mseyj 取消回复

关于我

devbean

devbean

豆子,生于山东,定居南京。毕业于山东大学软件工程专业。软件工程师,主要关注于 Qt、Angular 等界面技术。

主题 Salodad 由 PenciDesign 提供 | 静态文件存储由又拍云存储提供 | 苏ICP备13027999号-2