前言

QMessageBox 是 Qt 框架中常用的一個類，可以生成各式各樣、各種用途的消息對話框，如圖 1 所示。

圖 1 QMessageBox消息對話框

很多 GUI 程序都會用到消息對話框，且很多場景中使用的消息對話框是類似的，唯一的區(qū)別只是提示信息不同。為了提高程序員的開發(fā)效率，避免重復(fù)地“造輪子”，Qt 開發(fā)者設(shè)計好了幾種通用的 QMessageBox 消息對話框，需要時可以直接使用。

通用的QMessageBox消息框

Qt 提供了 6 種通用的 QMessageBox 消息對話框，通過調(diào)用 QMessageBox 類中的 6 個靜態(tài)成員方法，可以直接在項目中使用它們。

1) information消息對話框

information 對話框常用于給用戶提示一些關(guān)鍵的信息，它的外觀如下圖所示：

圖 2 information 消息對話框

在項目中使用 information 消息對話框，直接調(diào)用 QMessageBox 類中的 information() 靜態(tài)成員方法即可，該方法的語法格式如下：

StandardButton QMessageBox::information(QWidget *parent,
                                        const QString &title,
                                        const QString &text,
                                        StandardButtons buttons = Ok,
                                        StandardButton defaultButton = NoButton)

各個參數(shù)的含義是：

• parent：指定消息對話框的父窗口，消息提示框會作為一個獨立的窗口顯示在父窗口的前面。消息提示框從彈出到關(guān)閉的整個過程中，用戶無法操作父窗口，更不能刪除父窗口；
• title：指定消息對話框的標(biāo)題，即圖 2 中的 Titile；
• text：指定消息對話框的具體內(nèi)容，即圖 2 中的 text；
• buttons：指定消息對話框中包含的按鈕。默認(rèn)情況下，消息對話框只包含一個按鈕，即圖 2 中顯示的 "OK" 按鈕。根據(jù)需要，我們可以用|按位或運算符在消息對話框中設(shè)置多個按鈕，例如 QMessageBox::Ok|QMessageBox::Cancel；
• defaultButton：指定 Enter 回車鍵對應(yīng)的按鈕，用戶按下回車鍵時就等同于按下此按鈕。注意，defaultButton 參數(shù)的值必須是 buttons 中包含的按鈕，當(dāng)然也可以不手動指定，QMessageBox 會自動從 buttons 中選擇合適的按鈕作為 defaultButton 的值。

information() 函數(shù)會返回用戶按下的按鈕。StandardButton 是 QMessageBox 類中定義的枚舉類型，每個枚舉值代表一種按鈕。StandardButton 類型中的值有很多，下表給大家羅列了幾個常用的：

表 1 QMessageBox::StandardButton 枚舉類型值

例如，使用 information() 函數(shù)實現(xiàn)圖 2 所示的對話框，實現(xiàn)代碼為：

QMessageBox::StandardButton result = QMessageBox::information(&widget, "Title","text");

其中，widget 是我們創(chuàng)建好的 QWidget 窗口，創(chuàng)建好的 information 對話框會顯示在 widget 窗口的前面。通過用 result 接收 information() 函數(shù)的返回值，我們可以得知用戶選擇的是哪個按鈕。

2) critical消息對話框

critical 消息對話框常用于給用戶提示“操作錯誤”或“運行失敗”的信息，它的外觀如下圖所示：

圖 3 critical 消息對話框

項目中使用 critical 消息對話框，直接調(diào)用 QMessageBox 類提供的 critical() 靜態(tài)成員方法即可，該方法的語法格式為：

StandardButton QMessageBox::critical(QWidget *parent,
                                     const QString &title,
                                     const QString &text,
                                     StandardButtons buttons = Ok,
                                     StandardButton defaultButton = NoButton)

各個參數(shù)的含義以及返回值的含義，都與 information() 函數(shù)相同，這里不再重復(fù)贅述。

例如，使用 critical() 函數(shù)實現(xiàn)圖 3 所示的對話框，實現(xiàn)代碼為：

QMessageBox::StandardButton result=QMessageBox::critical(&widget, "Title","text");

其中，widget 是我們創(chuàng)建好的 QWidget 窗口，創(chuàng)建好的 critical 對話框會顯示在 widget 窗口的前面。

3) question消息對話框

question 對話框常用于向用戶提出問題并接收用戶的答案，它的外觀如下圖所示：

圖 4 question消息對話框

項目中使用 question 對話框，可以直接調(diào)用 QMessageBox 類的 question() 靜態(tài)成員方法，該方法的語法格式為：

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

各個參數(shù)的含義以及返回值的含義，都與 information() 函數(shù)相同。

例如，使用 question() 函數(shù)實現(xiàn)圖 4 所示的對話框，實現(xiàn)代碼為：

QMessageBox::StandardButton result=QMessageBox::question(&widget, "Title","text");

其中，widget 是我們創(chuàng)建好的 QWidget 窗口，創(chuàng)建好的 question 對話框會顯示在 widget 窗口的前面。

4) warning消息對話框

warining 對話框常用于向用戶顯示一些警告信息，它的外觀如下圖所示：

圖 5 warning消息對話框

項目中使用 warning 對話框，可以直接調(diào)用 QMessageBox 類的 warning() 靜態(tài)成員方法，該方法的語法格式為：

StandardButton QMessageBox::warning(QWidget *parent,

                                    const QString &title,

                                    const QString &text,

                                    StandardButtons buttons = Ok,

                                    StandardButton defaultButton = NoButton)

各個參數(shù)的含義以及返回值的含義，都與 information() 函數(shù)相同。

例如，使用 warning() 函數(shù)實現(xiàn)圖 5 所示的對話框，實現(xiàn)代碼為：

QMessageBox::StandardButton result=QMessageBox::warning(&widget, "Title","text");

其中，widget 是我們創(chuàng)建好的 QWidget 窗口，創(chuàng)建好的 warning 對話框會顯示在 widget 窗口的前面。

5) about和aboutQt對話框

about 對話框常常作為介紹某個產(chǎn)品或某項功能的臨時窗口，它的外觀如下圖所示：

圖 6 about消息對話框

注意，about 對話框沒有固定的圖標(biāo)，它顯示的圖標(biāo)可能來自父窗口、包含父窗口的頂層窗口等，也可能使用和 information 對話框相同的圖標(biāo)。

項目中使用 about 對話框，直接調(diào)用 QMessageBox 類提供的 about() 靜態(tài)成員方法即可，該方法的語法格式如下：

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

各個參數(shù)的含義和與 information() 函數(shù)相同。和前面的幾種對話框不同，about對話框中只包含一個默認(rèn)的 Ok 按鈕，且 about() 函數(shù)沒有返回值。

aboutQt 可以看做是 about 對話框的一個具體實例，它只能顯示 Qt 的介紹信息，如下圖所示：

圖 7 aboutQt對話框

項目中使用 aboutQt 對話框，直接調(diào)用 QMessageBox 類提供的 aboutQt() 靜態(tài)成員方法即可，該函數(shù)的語法格式如下：

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

我們只能設(shè)置 aboutQt 對話框的 parent 父窗口和 title 標(biāo)題，不能自定義它的內(nèi)容。所以在實際場景中，aboutQt() 對話框很少使用。

自定義QMessageBox對話框

以上 6 種通用的 QMessageBox 對話框，界面上的圖片無法修改，按鈕上的文字也無法修改（例如無法將 OK、No 改成中文）。如果想修改它們，就需要自定義一個 QMessageBox 對話框。

QMessageBox對話框的創(chuàng)建

程序中創(chuàng)建 QMessageBox 對象，必須先引入<QMessageBox>頭文件。QMessageBox 類提供了兩個構(gòu)造函數(shù)，分別是：

QMessageBox::QMessageBox(QWidget *parent = Q_NULLPTR)
QMessageBox::QMessageBox(Icon icon,
                         const QString &title,
                         const QString &text,
                         StandardButtons buttons = NoButton,
                         QWidget *parent = Q_NULLPTR,
                         Qt::WindowFlags f = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint)

第一個構(gòu)造函數(shù)可以創(chuàng)建一個“空白”對話框，即對話框中不包含任何文本和按鈕。當(dāng)然，通過調(diào)用 QMessageBox 類提供的成員方法，可以向“空白”對話框中添加各種元素（圖標(biāo)、文本、按鈕等）。

第二個構(gòu)造函數(shù)中，各個參數(shù)的含義是：

• icon：指定對話框中的圖片。Icon 是 QMessageBox 類中定義的枚舉類型，內(nèi)部包含 QMessageBox::NoIcon、QMessageBox::Question、QMessageBox::Information、QMessageBox::Warning、QMessageBox::Critical 幾個值，分別表示：不指定圖片、question對話框的圖片（圖 4）、information對話框的圖片（圖 2）、warning對話框的圖片（圖 5）、critical對話框的圖片（圖 3）。
• title：指定對話框的標(biāo)題；
• text：指定對話框中顯示的文本信息；
• buttons：指定對話框中包含的的按鈕，可選值如表 1 所示。
• parent：指定對話框的父窗口；
• f：指定對話框的屬性。WindowFlags 是 Qt 提供的枚舉類型，內(nèi)部包含的值有很多，有的用來指定對話框的用途（比如 Qt::Dialog 表示對話框窗口），有的用來指定對話框的外觀（比如 MSWindowsFixedSizeDialogHint 表示給對話框添加一個細(xì)的邊框）

?舉個簡單的例子：

#include <QApplication>
#include <QMessageBox>
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    //創(chuàng)建 QMessageBox 類對象
    QMessageBox MyBox(QMessageBox::Question,"Title","text",QMessageBox::Yes|QMessageBox::No);
    //使 MyBox 對話框顯示
    MyBox.exec();
    return a.exec();
}

程序中創(chuàng)建了一個 MyBox 對話框，通過調(diào)用 QMessageBox 提供的 exec() 方法，可以使 MyBox 對話框彈出。運行程序可以發(fā)現(xiàn)，MyBox 對話框的外觀和圖 4 的 question 對話框完全一樣。

QMessageBox對話框的使用

QMessageBox 類提供了很多功能實用的成員方法，方便我們快速地制作出實際場景需要的對話框。

下表給大家羅列了常用的一些 QMessageBox 類成員方法：

表 2 QMessageBox 常用成員方法

舉個簡單的例子：

#include <QApplication>
#include <QMessageBox>
#include <QPushButton>
#include <QDebug>
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QMessageBox MBox;
    MBox.setWindowTitle("QMessageBox自定義對話框");
    MBox.setText("這是一個自定義的對話框");
    MBox.setIconPixmap(QPixmap("C:\\Users\\xiexuewu\\Desktop\\icon_c.png"));
    QPushButton *agreeBut = MBox.addButton("同意", QMessageBox::AcceptRole);
    MBox.exec();
    if (MBox.clickedButton() == (QAbstractButton*)agreeBut) {
        //在 Qt Creator 的輸出窗口中輸出指定字符串
        qDebug() << "用戶點擊了同意按鈕";
    }
    return a.exec();
}

程序運行結(jié)果如圖 8 所示，點擊“同意”按鈕后，我們會在 Qt Creator 的輸出窗口中看到“用戶點擊了同意按鈕”。

圖 8 自定義的 QMessageBox 對話框

QMessageBox的信號和槽

操作 QMessageBox 對話框，最常用的信號函數(shù)是 buttonClicked() 函數(shù)，最常用的槽函數(shù)是 exec() 函數(shù)，它們的語法格式和功能如下表所示。?

表 3 QMessageBox信號和槽

舉個簡單的例子：

//main.cpp
#include <QApplication>
#include <QWidget>
#include <QMessageBox>
#include <QPushButton>
#include <QAbstractButton>
QPushButton* agreeBut;
QPushButton* disagreeBut;
class MyWidget:public QWidget{
    Q_OBJECT
public slots:
    void buttonClicked(QAbstractButton * butClicked);
};
void MyWidget::buttonClicked(QAbstractButton * butClicked){
    if(butClicked == (QAbstractButton*)disagreeBut){
        this->close();
    }
}
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    //創(chuàng)建主窗口
    MyWidget myWidget;
    myWidget.setWindowTitle("主窗口");
    myWidget.resize(400,300);
    //創(chuàng)建消息框
    QMessageBox MyBox(QMessageBox::Question,"","");
    MyBox.setParent(&myWidget);
    //設(shè)置消息框的屬性為對話框，它會是一個獨立的窗口
    MyBox.setWindowFlags(Qt::Dialog);
    MyBox.setWindowTitle("協(xié)議");
    MyBox.setText("使用本產(chǎn)品，請您嚴(yán)格遵守xxx規(guī)定！");
    //自定義兩個按鈕
    agreeBut = MyBox.addButton("同意", QMessageBox::AcceptRole);
    disagreeBut = MyBox.addButton("拒絕", QMessageBox::RejectRole);
    myWidget.show();
    //添加信號和槽，監(jiān)聽用戶點擊的按鈕，如果用戶拒絕，則主窗口隨之關(guān)閉。
    QObject::connect(&MyBox,&QMessageBox::buttonClicked,&myWidget,&MyWidget::buttonClicked);
    MyBox.exec();
    return a.exec();
}
//MyWidget類的定義應(yīng)該放到 .h 文件中，本例中將其寫到 main.cpp 中，程序最后需要添加 #include "當(dāng)前源文件名.moc" 語句，否則無法通過編譯。
#include "main.moc"

程序執(zhí)行結(jié)果為：

?到此這篇關(guān)于Qt QMessageBox類使用教程的文章就介紹到這了,更多相關(guān)Qt QMessageBox內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論