Qt应用开发(基础篇)——消息对话框 QMessageBox

一、前言

        QMessageBox类继承于QDialog，是一个模式对话框，常用于通知用户或向用户提出问题并接收答案。

        对话框QDialog

        QMessageBox消息框主要由四部分组成，一个主要文本text，用于提醒用户注意某种情况;一个信息文本informativeText，用于进一步解释警报或向用户询问问题;一个可选的详细文本detailedText，用于在用户请求时提供更多数据，还有就是用于接受用户响应的图标和标准按钮。

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

     QMessageBox提供一些静态的API(information(), question(), warning(), critical())可以直接打开对话框，根据API自带不同的状态图标，方便我们简单快速的使用，但是提供参数比较少，只有标题、主要文本和按钮，没有实例化的灵活。

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);

二、QMessageBox类

1、text

        该属性表示对话框显示的主要文本，文本可以是纯文本或者富文本，默认为空字符串。

        部件会自动检测文本类型，文本类型默认Qt::AutoText，也可以通过setTextFormat设置。

QString text() const
void setText(const QString &text)

2、detailedText

        该属性表示对话框显示的详细文本，文本为纯文本格式，默认为空字符串。

QString detailedText() const
void setDetailedText(const QString &text)

3、informativeText

        该属性表示对话框显示的信息文本，一般用来做主要文本的扩展，在MAC系统中会以更小的字体显示在主要文本下面，其他系统字体大小和主要文本相同，文本为纯文本格式，默认为空字符串。

QString informativeText() const 
void setInformativeText(const QString &text)

4、icon

        该属性表示对话框显示的系统默认图标，图标默认为空。也可以通过setIconPixmap设置自定义图标。

QMessageBox::Icon icon() const
void setIcon(QMessageBox::Icon)

 5、iconPixmap

        该属性表示当前显示的像素图标，可以通过setIconPixmap自定义需要显示的像素图标。

        一般像素图标不一定会适用于全部的系统，所以如果在跨平台的时候，需要为每个平台绘制适合的图标。

QPixmap iconPixmap() const
void setIconPixmap(const QPixmap &pixmap)

6、standardButtons

        该属性表示需要显示的标准按钮的集合。

QMessageBox::StandardButtons standardButtons() const
void setStandardButtons(QMessageBox::StandardButtons buttons)

        比如你可以这么做

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

QMessageBox::StandardButton	描述
QMessageBox::Ok	带AcceptRole角色属性的“Ok”按钮
QMessageBox::Open	带AcceptRole角色属性的“Open”按钮
QMessageBox::Save	带AcceptRole角色属性的“Save”按钮
QMessageBox::Cancel	带RejectRole角色属性的“Cancel”按钮
QMessageBox::Close	带RejectRole角色属性的“Close”按钮
QMessageBox::Discard	带DestructiveRole角色属性的基于平台的“Discard”或者“Don't Save”按钮。
QMessageBox::Apply	带AcceptRole角色属性的“Apply”按钮
QMessageBox::Reset	带ResetRole角色属性的“Reset”按钮
QMessageBox::RestoreDefaults	带ResetRole角色属性的“Restore Defaults”按钮
QMessageBox::Help	带HelpRole角色属性的“Help”按钮
QMessageBox::SaveAll	带AcceptRole角色属性的“Save All”按钮
QMessageBox::Yes	带YesRole角色属性的“Yes”按钮
QMessageBox::YesToAll	带YesRole角色属性的“Yes to All”按钮
QMessageBox::No	带NoRole角色属性的“No”按钮
QMessageBox::NoToAll	带NoRole角色属性的“No to All”按钮
QMessageBox::Abort	带RehectRole角色属性的“Abort”按钮
QMessageBox::Retry	带AcceptRole角色属性的“Retry”按钮
QMessageBox::Ignore	带AcceptRole角色属性的“Ignore”按钮
QMessageBox::NoButton	无效按钮

7、textFormat

        该属性表示显示的主要文本格式，默认为Qt::AutoText。

Qt::TextFormat textFormat() const
void setTextFormat(Qt::TextFormat format)

8、textInteractionFlags

        该属性表示对话框的标签文本应该如何和用户交互。

Qt::TextInteractionFlags textInteractionFlags() const
void setTextInteractionFlags(Qt::TextInteractionFlags flags)

Qt::TextInteractionFlag	描述
Qt::NoTextInteraction	不能与文本交互
Qt::TextSelectableByMouse	可以用鼠标选择文本，并使用上下文菜单或标准键盘快捷键将文本复制到剪贴板。
Qt::TextSelectableByKeyboard	可以用键盘上的光标键选择文本。显示一个文本光标。
Qt::LinksAccessibleByMouse	链接可以用鼠标突出显示和激活。
Qt::LinksAccessibleByKeyboard	链接可以使用tab键聚焦，并使用enter键激活。
Qt::TextEditable	文本是完全可编辑的。
Qt::TextEditorInteraction	TextSelectableByMouse | TextSelectableByKeyboard | TextEditable
Qt::TextBrowserInteraction	TextSelectableByMouse | LinksAccessibleByMouse | LinksAccessibleByKeyboard

9、公共函数

1）addButton

        添加标准按钮，并添加按钮的角色。

void addButton(QAbstractButton *button, QMessageBox::ButtonRole role)
QPushButton *addButton(const QString &text, QMessageBox::ButtonRole role)
QPushButton *addButton(QMessageBox::StandardButton button)

        如果觉得标准按钮不够灵活，使用addButton()重载，它接受一个文本和一个ButtonRole来添加自定义按钮。QMessageBox使用ButtonRole来确定屏幕上按钮的顺序(根据平台而变化)。可以在调用exec()之后测试clickedButton()的值。

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

2）button

        返回标准按钮的指针。

QAbstractButton *button(QMessageBox::StandardButton which) const

3）buttons

        返回按钮的集合。

QList<QAbstractButton *> buttons() const

4）buttonRole

        返回按钮的的角色。

QMessageBox::ButtonRole buttonRole(QAbstractButton *button) const

5）removeButton

        移除按钮。

void removeButton(QAbstractButton *button)

6）checkBox

        返回复选框指针。

QCheckBox *checkBox() const

7）setCheckBox

        添加复选框，添加后对话框获得复选框所有权。如果cb设置为空指针，表示删除复选框。

void setCheckBox(QCheckBox *cb)

8）clickedButton

        返回用户按下的按钮指针，可以通过此获取哪个自定义按钮被按下。

QAbstractButton *clickedButton() const

9）defaultButton

         返回默认按钮的指针。

QPushButton *defaultButton() const

10）setDefaultButton

         设置默认按钮，当用户按下Enter的时候触发该按钮。如果未指定默认按钮，QMessageBox将根据消息框中使用的按钮的按钮角色尝试查找一个。

void setDefaultButton(QPushButton *button)
void setDefaultButton(QMessageBox::StandardButton button)

11）buttonRole

        返回按钮角色。

QMessageBox::ButtonRole buttonRole(QAbstractButton *button) const

QMessageBox::ButtonRole	描述
QMessageBox::InvalidRole	无效按钮
QMessageBox::AcceptRole	表示接受Accept，比如ok
QMessageBox::RejectRole	表示拒绝Reject，比如Cancel
QMessageBox::DestructiveRole	表示丢弃并关闭对话框
QMessageBox::ActionRole	表示按下按钮对话框元素会被修改
QMessageBox::HelpRole	表示帮助
QMessageBox::YesRole	YES
QMessageBox::NoRole	No
QMessageBox::ApplyRole	表示接收当前改变
QMessageBox::ResetRole	表示重置当前改变

12）escapeButton

        返回设置退出按钮指针。

QAbstractButton *escapeButton() const

13）setEscapeButton

        设置退出按钮，指定之后按下ESC键会触发此按钮。

        如果没有指定转义按钮，QMessageBox将尝试使用以下规则找到一个转义按钮：

• 如果只有一个按钮，则为按Esc时激活的按钮。
• 如果有“取消”按钮，则是按Esc时激活的按钮。
• 如果只有一个按钮具有Reject角色或No角色，则它是按Esc时激活的按钮。

        当无法使用这些规则确定退出按钮时，按Esc无效。

void setEscapeButton(QAbstractButton *button)
void setEscapeButton(QMessageBox::StandardButton button)

14）open

        打开对话框并将其finished()或buttonClicked()信号连接到接收器和成员指定的插槽。如果槽函数的第一个参数有一个指针，则连接到buttonClicked()，否则连接到finished()，当对话框关闭的时候，这个信号槽连接会被断开。

void open(QObject *receiver, const char *member)

        实例：打开对话框的同时绑定信号finished与槽函数onMessageBoxFinish，对话框关闭打印信息。

public slots:
    void onMessageBoxFinish();

void MainWindow::onMessageBoxFinish()
{
    qDebug()<<"QMessageBox Finish";
}

QMessageBox msgBox;
msgBox.setWindowTitle("QMessageBox");
msgBox.setText("The document has been modified.");
msgBox.setInformativeText("Do you want to save your changes?");
msgBox.setDetailedText("The document may have been modified externally");
msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
msgBox.setDefaultButton(QMessageBox::Save);
msgBox.open(this,SLOT(onMessageBoxFinish()));
int ret = msgBox.exec();

15）exec

        重写的exec，一样是模式对话框打开，如果存在标准按钮，返回值表示按下的标准按钮的StandardButton值，如果是自定的按钮，那么这个值不确定，需要根据clickbutton()来确定按下了哪个按钮。

        注意：从QDialog继承来的result()也是返回StandardButton值，而不是QDialog::DialogCode

virtual int exec() override

10、静态函数

        在指定的父小部件前面打开具有给定标题和文本的关键消息模态对话框。

QMessageBox::StandardButton critical(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)
QMessageBox::StandardButton information(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)
QMessageBox::StandardButton question(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = StandardButtons(Yes | No), QMessageBox::StandardButton defaultButton = NoButton)
QMessageBox::StandardButton warning(QWidget *parent, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = Ok, QMessageBox::StandardButton defaultButton = NoButton)

        显示一个简单的关于框，其中包含标题和文本。

void about(QWidget *parent, const QString &title, const QString &text)

        显示一个关于Qt的简单消息框，该消息包括应用程序正在使用的Qt版本号，一般用于程序中的help菜单。

void aboutQt(QWidget *parent, const QString &title = QString())

11、信号

        每当在QMessageBox中单击按钮时，就会发出此信号。

void buttonClicked(QAbstractButton *button)