看一遍就能玩转QMessageBox

怼烎@ 2023-01-23 06:55 32阅读 0赞

**目录**

1.什么是 QMessageBox？

2.最简单用法

3.设置信息文本属性以显示要询问的问题

4.设置标准按钮

4.1 enum QMessageBox::StandardButton

4.2 StandardButtons standardButtons

4.3 void setStandardButtons(StandardButtons buttons)

4.4 设置标准按钮示例代码

5.设置自定义按钮

6.判断被点击的按钮

7.设置详细信息区域中显示的文本

7.1 QString detailedText

7.2 void setDetailedText(const QString &text)

7.3 设置详细信息区域中文本的示例代码

8.设置文本格式

8.1 Qt::TextFormat textFormat

8.2 void setTextFormat(Qt::TextFormat format)

8.3 枚举类型Qt::TextFormat

8.4 设置文本格式为富文本的示例代码

8.5 Qt::RichText

9.根据严重性级别使用提示框

9.1 提问

9.2 报告正常操作的信息

9.3 报告非关键的错误

9.4 报告关键或者严重的错误

--------------------

# **1.什么是 QMessageBox？** #

QMessageBox类提供了一个模态对话框，用于通知用户或向用户询问问题并接收答案。

消息框显示一个主要文本来提醒用户某一情况，一个信息文本来进一步解释该警告或向用户提问，以及一个可选的详细文本来提供更多的数据(如果用户请求的话)。消息框还可以显示用于接受用户响应的图标和标准按钮。

QT提供了两种使用QMessageBox的API，一个是基于属性的API，另一个是静态函数。调用一个静态函数是更简单的方法，但它不如使用基于属性的API灵活，结果信息量也更少。建议使用基于属性的API。

头文件是：\#include "QMessageBox"

# 2.最简单用法 #

使用基于属性的API，只设置一个提示文本"The document has been modified."

用户必须单击OK按钮来取消消息框。图形用户界面的其余部分将被阻塞，直到消息框被关闭。

QMessageBox msgBox;
      msgBox.setText("The document has been modified.");
      msgBox.exec();

![20210713161627469.png][]

# 3.设置信息文本属性以显示要询问的问题 #

比仅仅提醒用户事件更好的方法是询问用户如何处理事件，下面的代码将问题存储在信息文本属性中，然后调用exec()显示。

QMessageBox msgBox;
      msgBox.setText("The document has been modified.");
      msgBox.setInformativeText("Do you want to save your changes?");
      int ret = msgBox.exec();

![20210713162321104.png][]

# 4.设置标准按钮  #

要想彻底弄明白如何设置标准按钮，不得不先讲一下有关的基础知识，还请耐心的看完，文字较少。

## 4.1 enum QMessageBox::StandardButton ##

QMessageBox定义了一个枚举类型：enum QMessageBox::StandardButton

这些枚举定义了QMessageBox可以使用的标准按钮的标志，并且每个按钮都有一个定义的按钮角色。（标准按钮是相对于自定义按钮而言的，这里的标准按钮指的就是QT已定义好的一些枚举值）

下面这个图详细描述了QMessageBox类中可使用的标准按钮：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70][]

## 4.2 StandardButtons standardButtons ##

QMessageBox有一个数据成员为：StandardButtons standardButtons

此属性控制消息框使用哪些标准按钮。默认情况下，此属性不包含标准按钮。这些按钮是通过使用按位或操作符组合StandardButtons中的值来指定的。 按钮的显示顺序与平台有关。 例如，在Windows操作系统中，“取消”的左边是“保存”，而在Mac操作系统中，顺序相反。

## 4.3 void setStandardButtons(StandardButtons buttons) ##

QMessageBox提供了一个函数设置消息框要显示的按钮：

void setStandardButtons(StandardButtons buttons)

参数传递方式如下：

msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);

## 4.4 设置标准按钮示例代码 ##

添加3个按钮，并将“Save”按钮设置为默认按钮

![20210713164601423.png][]

# 5.设置自定义按钮 #

如果标准按钮对于您的消息框不够灵活，您可以使用addButton()重载，它接受文本和ButtonRole来添加自定义按钮。QMessageBox使用ButtonRole来确定屏幕上按钮的顺序(根据平台的不同而不同)。您可以在调用exec()之后测试clickkedbutton()的值。例如：

QMessageBox msgBox;
        QPushButton *connectButton = msgBox.addButton(tr("Connect"), QMessageBox::ActionRole);
        QPushButton *abortButton = msgBox.addButton(QMessageBox::Abort);
    
        msgBox.exec();
    
        if (msgBox.clickedButton() == (QAbstractButton*)connectButton) {
            qDebug() << "connect";
        }
        else if (msgBox.clickedButton() == (QAbstractButton*)abortButton) {
            qDebug() << "abort";
        }

![20210713165259529.png][]

# 6.判断被点击的按钮 #

如果是按照第5节中的方法添加的自定义按钮，则按照第5节中的方法判断即可。

如果是第4节中的方法添加的标准按钮，则按照如下方法判断：

QMessageBox msgBox;
    	msgBox.setText("The document has been modified.");
    	msgBox.setInformativeText("Do you want to save your changes?");
    	msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
    	msgBox.setDefaultButton(QMessageBox::Save);
    	int ret = msgBox.exec();
      
    	switch (ret) {
    	case QMessageBox::Save:
    		// Save was clicked
    		break;
    	case QMessageBox::Discard:
    		// Don't Save was clicked
    		break;
    	case QMessageBox::Cancel:
    		// Cancel was clicked
    		break;
    	default:
    		// should never be reached
    		break;
    	}

# 7.设置详细信息区域中显示的文本 #

## 7.1 QString detailedText ##

QMessageBox有一个数据成员：QString detailedText  
此属性保存要在详细信息区域中显示的文本（QMessageBox有一个“详细信息显示区域”，在我们加的普通提示文本的下方）。该文本将被解释为纯文本。默认情况下，此属性包含一个空字符串。

## 7.2 void setDetailedText(const QString &text) ##

QT提供此函数用于设置要在详细信息区域中显示的文本。

## 7.3 设置详细信息区域中文本的示例代码 ##

QMessageBox msgBox;
        msgBox.setText("The document has been modified.");
        msgBox.setInformativeText("Do you want to save your changes?");
        msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
        msgBox.setDefaultButton(QMessageBox::Save);
        msgBox.setDetailedText("QMessageBox msgBox;\n"
            "msgBox.setText(\"The document has been modified.\"); ");
        int ret = msgBox.exec();

![20210713171430265.png][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 1][]

# 8.设置文本格式 #

## 8.1 Qt::TextFormat textFormat ##

QMessageBox有一个数据成员：Qt::TextFormat textFormat

此属性保存消息框显示的文本的格式消息框使用的当前文本格式。有关可能的选项的解释，请参阅Qt::TextFormat枚举。默认格式为Qt::AutoText。

## 8.2 void setTextFormat(Qt::TextFormat format) ##

QMessageBox提供此函数用于设置文本格式，这里设置的格式不会对“详细信息区域”的文本格式起作用。

## 8.3 枚举类型Qt::TextFormat ##

此枚举用于定义文本格式类型，有三个值可选。

![20210713165923140.png][]

## 8.4 设置文本格式为富文本的示例代码 ##

QMessageBox msgBox;
        msgBox.setText("<b>Hello</b> <i>Qt!</i>");
        msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
        msgBox.setDefaultButton(QMessageBox::Save);
        msgBox.setTextFormat(Qt::RichText);
        int ret = msgBox.exec();

![20210713172134126.png][]

## 8.5 Qt::RichText ##

关于富文本的格式，可查阅QT官方资料，或者在网上搜索，如果后续有时间，我再补充。

# 9.根据严重性级别使用提示框 #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 2][]

根据严重性级别，QMessageBox提供了4个静态函数，显示对应类型的消息框，主要区别在于消息框的图标不同，下面逐一讲解。

## 9.1 提问 ##

int ret = QMessageBox::question(this, tr("My Application"),
            tr("The document has been modified.\n"
                "Do you want to save your changes?"),
            QMessageBox::Save | QMessageBox::Discard
            | QMessageBox::Cancel,
            QMessageBox::Save);

![20210713173810913.png][]

## 9.2 报告正常操作的信息   ##

int ret = QMessageBox::information(this, tr("My Application"),
            tr("The document has been modified.\n"
                "Do you want to save your changes?"),
            QMessageBox::Save | QMessageBox::Discard
            | QMessageBox::Cancel,
            QMessageBox::Save);

![20210713173708998.png][]

## 9.3 报告非关键的错误 ##

int ret = QMessageBox::warning(this, tr("My Application"),
            tr("The document has been modified.\n"
                "Do you want to save your changes?"),
            QMessageBox::Save | QMessageBox::Discard
            | QMessageBox::Cancel,
            QMessageBox::Save);

![20210713173529402.png][]

## 9.4 报告关键或者严重的错误 ##

int ret = QMessageBox::critical(this, tr("My Application"),
            tr("The document has been modified.\n"
                "Do you want to save your changes?"),
            QMessageBox::Save | QMessageBox::Discard
            | QMessageBox::Cancel,
            QMessageBox::Save);

![20210713173928629.png][]

[20210713161627469.png]: /images/20221004/b469050d3ea3491686b70f77f34654f0.png
[20210713162321104.png]: /images/20221004/cc7f97220add421f942f8e9cb7266efa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70]: /images/20221004/8dc5d880535e4f11be4c1ebae93314bc.png
[20210713164601423.png]: /images/20221004/d2ef5f3a697a46d18ffccd059f74c7d2.png
[20210713165259529.png]: /images/20221004/5b8ad5d594f643a59da3e8626a34a74c.png
[20210713171430265.png]: /images/20221004/8622ae50a7d94571b833d274c239abdc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 1]: /images/20221004/73a1abb3563f40eb9131872deba482e3.png
[20210713165923140.png]: /images/20221004/6d7c2dcb0e834d049a2f05093f21163b.png
[20210713172134126.png]: /images/20221004/3123d6d2758b498a9335ee397b440d6a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2pvbGluNjc4_size_16_color_FFFFFF_t_70 2]: /images/20221004/b7eae472743a45b7a053ade346bacaea.png
[20210713173810913.png]: /images/20221004/0fa7c562f6234568a5e95251262f8baf.png
[20210713173708998.png]: /images/20221004/6ffb7b8e53494ac7942d508c240318db.png
[20210713173529402.png]: /images/20221004/6b5f00a62dbe443597a8b121dd2bcc43.png
[20210713173928629.png]: /images/20221004/440bb28f74be4fadaf22221949a0f34d.png