C++ Qt開發：自定義Dialog對話框組件

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹自定義`Dialog`組件的常用方法及靈活運用。自定義對話框需要解決的問題是，如何讓父窗體與子窗體進行數據交換，要... ...

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹自定義Dialog組件的常用方法及靈活運用。

在之前的文章中筆者已經為大家展示了預設Dialog組件的使用方法，雖然內置組件支持對數據的輸入，但有時候我們需要一次性輸入多個數據，此時如果之使用預設模態對話框似乎不太夠用，此時我們需要自己創建一個自定義對話框，需要說明的是此類對話框也是一種窗體，所以可以在其上面放置任何通用組件，以實現更多複雜的開發需求。

自定義對話框需要解決的問題是，如何讓父窗體與子窗體進行數據交換，要實現數據的交換有兩種方式，第一種方式是通過動態載入模態對話框，當用戶點擊確定後通過GetValue()來拿到數據，而第二種方式則是通過發送信號的方式將數據投遞給父窗體，這兩種方式都可以，讀者可根據自身需求來選擇不同的通信方式。

1.1 使用模態對話框傳值

首先我們需要創建一個自定義對話框，在Qt中創建對話框很容易，具體創建流程如下所示：

選擇項目 -> AddNew -> QT -> Qt設計師界面類 -> 選擇DialogWithoutButtons -> 命名為Dialog保存

此時直接點擊下一步按鈕，並選中Forms/dialog.ui界面編輯菜單，在編輯欄中我們分別增加一個LineEdit編輯框，以及兩個PushButton按鈕組件，將第一個組件命名為BtnOk將第二個組件命名為BtnCancel，界面如下所示；

當做完頁面佈局後，其次我們還需要在Dialog.ui組件上增加兩個信號，分別是點擊和關閉，並將信號關聯到兩個槽函數上，其信號應該寫成如下圖所示。

如上圖，accept() 是 QDialog 類的一個公共槽函數。調用這個槽函數會觸發對話框的接受（accept）操作，通常用於模擬用戶點擊對話框的“確定”按鈕。同樣的reject() 也是 QDialog 類的一個公共槽函數。調用這個槽函數會觸發對話框的拒絕（reject）操作，通常用於模擬用戶點擊對話框的“取消”按鈕。

接著我們點開模態對話框的dialog.cpp對話框類，其類內需要定義兩個成員函數，它們的功能如下：

第一個 GetValue() 用來獲取當前編輯框內的數據並將數據返回給父窗體。
第二個 SetValue() 用來接收傳入的參數，並將此參數設置到自身窗體中的編輯框內。

#include "dialog.h"
#include "ui_dialog.h"

Dialog::Dialog(QWidget *parent) :QDialog(parent),ui(new Ui::Dialog)
{
    ui->setupUi(this);
}

// 用於MainWindow獲取編輯框中的數據
QString Dialog::GetValue()
{
    return ui->lineEdit->text();
}

// 用於設置當前編輯框中的數據為MainWindow
void Dialog::SetValue(QString x)
{
    ui->lineEdit->setText(x);
}

Dialog::~Dialog()
{
    delete ui;
}

接著我們來看一下MainWindow函數中是如何接收參數的，對於主窗體來說，當用戶點擊on_pushButton_clicked()按鈕時，我們需要動態將自己創建的Dialog載入，讀取出主窗體編輯框內的值並設置到子窗體內，當用戶按下QDialog::Accepted時則是獲取子窗體內的值，此時通過調用ptr->GetValue()子窗體的成員函數來返回一個字元串，並將其設置到父窗體的編輯框內，主函數代碼如下所示；

// 首先要包含Dialog對話框類
#include "dialog.h"

#include <iostream>
#include <QDialog>

MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    ui->lineEdit->setEnabled(false);
    ui->lineEdit->setText("hello lyshark");
}

MainWindow::~MainWindow()
{
    delete ui;
}

// 按鈕點擊後執行
void MainWindow::on_pushButton_clicked()
{
    // 創建模態對話框
    Dialog *ptr = new Dialog(this);                                 // 創建一個對話框
    Qt::WindowFlags flags = ptr->windowFlags();                     // 需要獲取返回值
    ptr->setWindowFlags(flags | Qt::MSWindowsFixedSizeDialogHint);  // 設置對話框固定大小

    // 讀取MainWindows參數並設置到Dialog
    QString item = ui->lineEdit->text();
    ptr->SetValue(item);

    int ref = ptr->exec();             // 以模態方式顯示對話框
    if (ref==QDialog::Accepted)        // OK鍵被按下,對話框關閉
    {
        // 當BtnOk被按下時,則設置對話框中的數據
        QString the_value = ptr->GetValue();
        std::cout << "value = " << the_value.toStdString().data() << std::endl;
        ui->lineEdit->setText(the_value);
    }

    // 刪除釋放對話框句柄
    delete ptr;
}

至此就實現了參數的子窗體傳遞到父窗體，如下圖所示；

2.1 使用信號傳值

對於信號傳值，我們需要在dialog.h頭文件中增加sendText()信號，以及on_pushButton_clicked()槽函數的聲明部分，如下所示；

// 定義信號(信號只需聲明無需實現)
signals:
    void sendText(QString str);
private slots:
    void on_pushButton_clicked();

而在dialog.cpp實現部分，我們首先需要將子窗體中的按鈕組件綁定到onBtnClick()槽函數上面，當需要發送數據時直接通過調用emit sendText觸發信號，並攜帶子窗體中send_data的數據；

#include "dialog.h"
#include "ui_dialog.h"

Dialog::Dialog(QWidget *parent) :QDialog(parent),ui(new Ui::Dialog)
{
    ui->setupUi(this);

    // 連接pushButton到onBtnClick上
    connect(ui->pushButton, SIGNAL(clicked()), this, SLOT(onBtnClick()));
}

Dialog::~Dialog()
{
    delete ui;
}

// 發送信號到MainWindow
void Dialog::on_pushButton_clicked()
{
    QString send_data = ui->lineEdit->text();
    emit sendText(send_data);
}

接著是在mainwindow.h頭文件定義中，新增槽函數receiveMsg()函數用來接收信號的傳值。

private slots:
    // 定義槽函數
    void receiveMsg(QString str);
    void on_pushButton_clicked();

在mainwindow.cpp實現部分，接收到信號後的槽函數receiveMsg其內部可以直接將參數設置到父類視窗的lineEdit組件上，而當on_pushButton_clicked按鈕被點擊是，我們只需要載入自己的子窗體，並Connect鏈接槽函數receiveMsg上面，當做完這一切之後，再通過subwindow->show()讓子窗體顯示出來。

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include "dialog.h"
#include <QDialog>

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent),ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    ui->lineEdit->setEnabled(false);
}

// 接收信號並設置到LineEdit上
void MainWindow::receiveMsg(QString str)
{
    ui->lineEdit->setText(str);
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::on_pushButton_clicked()
{
    Dialog *subwindow = new Dialog(this);
    // 當收到sendText信號時使用receiveMsg槽函數處理
    connect(subwindow, SIGNAL(sendText(QString)), this, SLOT(receiveMsg(QString)));
    subwindow->show();
}

當然，此類對話框是非模態的，讀者可以拖動父對話框，而由於是信號控制，所以當發送參數到父窗體後，子窗體並不會立即關閉，如下圖所示；