Qt QMessageBox類使用教程

Posted on by

前言

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

圖 1 QMessageBox消息對話框

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

通用的QMessageBox消息框

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

1) information消息對話框

information 對話框常用於給用戶提示一些關鍵的信息，它的外觀如下圖所示：

圖 2 information 消息對話框

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

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

各個參數的含義是：

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

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

表 1 QMessageBox::StandardButton 枚舉類型值

枚舉值 含 義
QMessageBox::Ok 標有 “OK” 字樣的按鈕，通常用來表示用戶接受或同意提示框中顯示的信息。
QMessageBox::Open 標有 “Open” 字樣的按鈕。
QMessageBox::Save 標有 “Save” 字樣的按鈕。
QMessageBox::Cancel 標有 “Cancel” 字樣的按鈕。點擊此按鈕，通常表示用戶拒絕接受提示框中顯示的信息。
QMessageBox::Close 標有 “Close” 字樣的按鈕。
QMessageBox::Discard 標有 “Discard” 或者 “Don’t Save” 字樣的按鈕，取決於運行平臺。
QMessageBox::Apply 標有 “Apply” 字樣的按鈕。
QMessageBox::Reset 標有 “Reset” 字樣的按鈕。
QMessageBox::Yes 標有 “Yes” 字樣的按鈕。
QMessageBox::No 標有 “No” 字樣的按鈕。

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

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

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

2) critical消息對話框

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

圖 3 critical 消息對話框

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

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

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

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

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

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

3) question消息對話框

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

圖 4 question消息對話框

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

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

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

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

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

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

4) warning消息對話框

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

圖 5 warning消息對話框

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

StandardButton QMessageBox::warning(QWidget *parent,

                                    const QString &title,

                                    const QString &text,

                                    StandardButtons buttons = Ok,

                                    StandardButton defaultButton = NoButton)

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

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

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

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

5) about和aboutQt對話框

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

圖 6 about消息對話框

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

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

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

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

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

圖 7 aboutQt對話框

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

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

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

自定義QMessageBox對話框

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

QMessageBox對話框的創建

程序中創建 QMessageBox 對象，必須先引入<QMessageBox>頭文件。QMessageBox 類提供瞭兩個構造函數，分別是：

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)

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

第二個構造函數中，各個參數的含義是：

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

 舉個簡單的例子：

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

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

QMessageBox對話框的使用

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

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

表 2 QMessageBox 常用成員方法

成員方法 功 能
void QMessageBox::setWindowTitle(const QString &title) 設置對話框的標題。
void setText(const QString &text) 設置對話框中要顯示的文本。
void setIconPixmap(const QPixmap &pixmap) 設置對話框中使用的圖片。
QAbstractButton *QMessageBox::clickedButton() const 返回用戶點擊的按鈕。
QPushButton *QMessageBox::addButton(const QString &text, ButtonRole role) 向對話框中添加按鈕，text 為按鈕的文本，role 是 QMessageBox::ButtonRole 枚舉類型的變量，用於描述按鈕扮演的角色，它的可選值有 QMessageBox::AcceptRole（同 OK 按鈕）、QMessageBox::RejectRole（同 Cancel 按鈕）等。
int QMessageBox::exec() 使當前對話框彈出，除非用戶關閉對話框，否則對話框將一直存在。此外，當對話框中使用的都是 Qt 提供的按鈕時，該方法可以監聽用戶點擊的是哪個按鈕，並將該按鈕對應的枚舉值返回；如果對話框中包含自定義按鈕，需要借助 clickedButton() 方法確定用戶點擊的按鈕。

舉個簡單的例子：

#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();
}

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

圖 8 自定義的 QMessageBox 對話框

QMessageBox的信號和槽

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

表 3 QMessageBox信號和槽

信號函數 功 能
void QMessageBox::buttonClicked(QAbstractButton *button) 當用戶點擊對話框中的某個按鈕時，會觸發此信號函數，該函數會將用戶點擊的按鈕作為參數傳遞給槽函數。
槽函數 功 能
int QMessageBox::exec() 彈出對話框，直到用戶手動關閉對話框，此對話框將一直存在。

舉個簡單的例子：

//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);
    //創建主窗口
    MyWidget myWidget;
    myWidget.setWindowTitle("主窗口");
    myWidget.resize(400,300);
    //創建消息框
    QMessageBox MyBox(QMessageBox::Question,"","");
    MyBox.setParent(&myWidget);
    //設置消息框的屬性為對話框，它會是一個獨立的窗口
    MyBox.setWindowFlags(Qt::Dialog);
    MyBox.setWindowTitle("協議");
    MyBox.setText("使用本產品，請您嚴格遵守xxx規定！");
    //自定義兩個按鈕
    agreeBut = MyBox.addButton("同意", QMessageBox::AcceptRole);
    disagreeBut = MyBox.addButton("拒絕", QMessageBox::RejectRole);
    myWidget.show();
    //添加信號和槽，監聽用戶點擊的按鈕，如果用戶拒絕，則主窗口隨之關閉。
    QObject::connect(&MyBox,&QMessageBox::buttonClicked,&myWidget,&MyWidget::buttonClicked);
    MyBox.exec();
    return a.exec();
}
//MyWidget類的定義應該放到 .h 文件中，本例中將其寫到 main.cpp 中，程序最後需要添加 #include "當前源文件名.moc" 語句，否則無法通過編譯。
#include "main.moc"

程序執行結果為：

 到此這篇關於Qt QMessageBox類使用教程的文章就介紹到這瞭,更多相關Qt QMessageBox內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：