## 7.2 子類化 QDialog 創建基于對話框的應用程序主要是使用子類化 QDialog 的方法。在本節，我們采用這個方法創建一個稍微復雜的實例-可擴展對話框。 可擴展對話框通常只顯示簡單的外觀，但是它還有一個切換按鈕（ toggle button）， 可以讓用戶在對話框的簡單外觀和擴展外觀之間來回切換。 可擴展對話框通常用于試圖同時 滿足普通用戶和高級用戶需要的應用程序中，這種應用程序通常會隱藏那些高級選項，除非 用戶明確要求看到它們。 這個對話框是一個用于電子制表軟件應用程序的排序對話框（ Sort 對話框），在這個 對話框中，用戶可以選擇一列或多列進行排序。在這個簡單外觀中，允許用戶輸入一個單一 的排序鍵，而在擴展外觀下，還額外提供了兩個排序鍵。 More 按鈕允許用戶在簡單外觀和 擴展外觀之間切換。該實例的運行效果如圖 7-2 所示。   圖 7-2 實例運行效果 該實例名為 extensionDlg。共有以下原生源文件：工程文件 extensionDlg.pro，主程 序文件 main.cpp，對話框類 ExtensionDlg 的頭文件 extensionDlg.h，實現文件 extensionDlg.cpp。 在第 6 章中我們向大家介紹了創建 Qt 應用程序的基本方法，這里我們采用 Qt Creator作為 IDE，并使用完全手寫的方式完成程序的界面布局和構建。 首先當然是在 Qt Creator 中創建這個名為 extensionDlg 的項目，類型是 Empty Qt4 Project。然后在其中依次加入對話框類 ExtensionDlg 的頭文件 extensionDlg.h，實現文件 extensionDlg.cpp，主程序文件 main.cpp 以及工程文件 extensionDlg.pro。這些文件的內容， 可以在 Qt Creator 的代碼編輯器中完成編輯。 我們先看一下對話框類 ExtensionDlg 的頭文件的內容。 ``` #ifndef EXTENSIONDLG_H #define EXTENSIONDLG_H #include <QtGui> class ExtensionDlg : public QDialog { Q_OBJECT public: ExtensionDlg(); void initBasicInfo(); void initDetailInfo(); public slots: void slot2Extension(); private: QWidget *baseWidget; QWidget *detailWidget; }; ``` 第 1 行引入 QtGui 模塊的頭文件 第 2 行聲明我們的自定義對話框類 ExtensionDlg 單公有繼承自 QDialog。 第 3 行加入 Q_OBJECT 宏，程序中用到諸如信號/槽等 Qt 核心機制的時候，都要加入這 個宏。 第 4-7 行聲明了構造函數和初始化基礎信息和擴展信息的函數。 第 8-9 行聲明公有槽 slot2Extension()，它在用戶點擊【Detail】按鈕時被觸發。 第 10-12 行聲明兩個私有成員變量 baseWidget 和 detailWidget，它們都是 QWidget 的 實例，分別代表伸縮前后的對話框窗體。 再來看看 ExtensionDlg 的實現文件。 ``` #include "extensionDlg.h" ExtensionDlg::ExtensionDlg() { setWindowTitle(tr("Extension Dialog")); initBasicInfo(); initDetailInfo(); QVBoxLayout *layout = new QVBoxLayout; layout->addWidget(baseWidget); layout->addWidget(detailWidget); layout->setSizeConstraint(QLayout::SetFixedSize); layout->setSpacing(6); setLayout(layout); } void ExtensionDlg::initBasicInfo() { baseWidget = new QWidget; QLabel *nameLabel = new QLabel(tr("Name")); QLineEdit *nameEdit = new QLineEdit; QLabel *sexLabel = new QLabel(tr("Sex")); QComboBox *sexComboBox = new QComboBox; sexComboBox->addItem(tr("male")); sexComboBox->addItem(tr("female")); QPushButton *okButton = new QPushButton(tr("OK")); QPushButton *detailButton = new QPushButton(tr("Detail")); connect(detailButton,SIGNAL(clicked()),this,SLOT(slot2Extension())); QDialogButtonBox *btnBox = new QDialogButtonBox(Qt::Horizontal); btnBox->addButton(okButton,QDialogButtonBox::ActionRole); btnBox->addButton(detailButton,QDialogButtonBox::ActionRole); QFormLayout *formLayout = new QFormLayout; formLayout->addRow(nameLabel,nameEdit); formLayout->addRow(sexLabel,sexComboBox); QVBoxLayout *vboxLayout = new QVBoxLayout; vboxLayout->addLayout(formLayout); vboxLayout->addWidget(btnBox); baseWidget->setLayout(vboxLayout); } void ExtensionDlg::initDetailInfo() { detailWidget = new QWidget; QLabel *ageLabel = new QLabel(tr("Age")); QLineEdit *ageEdit = new QLineEdit; ageEdit->setText(tr("25")); QLabel *deptLabel = new QLabel(tr("Department")); QComboBox *deptComboBox = new QComboBox; deptComboBox->addItem(tr("department 1")); deptComboBox->addItem(tr("department 2")); deptComboBox->addItem(tr("department 3")); deptComboBox->addItem(tr("department 4")); QLabel *addressLabel = new QLabel(tr("address")); QLineEdit *addressEdit = new QLineEdit; QFormLayout *formLayout = new QFormLayout; formLayout->addRow(ageLabel,ageEdit); formLayout->addRow(deptLabel,deptComboBox); formLayout->addRow(addressLabel,addressEdit); detailWidget->setLayout(formLayout); detailWidget->hide(); } void ExtensionDlg::slot2Extension() { if (detailWidget->isHidden()) { detailWidget->show(); } else { detailWidget->hide(); } } ``` 第 1-9 句是構造函數中的內容。 第 1 句設置應用程序的標題。 第 2 句調用 initBasicInfo()函數，初始化基本信息船窗體。 第 3 句調用 initDetailInfo()函數，初始化擴展信息窗體。 第 4-9 句設置窗體的布局。 第 4 句定義一個垂直布局類實體 layout。 第 5、6 兩句，分別將 baseWidget 和 detailWidget 加入到布局中。 第 7、8 兩句對于布局管理來說是非常常見的用法，必須熟練掌握。其中 setSizeConstraint()函數用于設置窗體的縮放模式，其默認取值是 QLayout::SetDefaultConstraint。這里取參數值為 Qlayout::SetFixedSize 是為了使窗體 的大小固定，不可經過鼠標拖動而改變大小；如果不這樣設置，當用戶再次點擊 【Detail】按鈕時，對話框將不能恢復到初始狀態。 setSpacing()函數用于設置位于布局之中的窗口部件之間的間隔大小。 這里暫時不對布局管理的相關內容展開講解，在《布局管理》這一章中將有詳細的介紹。 第 9 句將剛剛設置好的布局應用加載到窗體上。 第 10-29 句是 initBasicInfo()函數體的內容。 第 10 句實例化 baseWiaget，注意 baseWidget 是全局變量。 第 11-18 句，依次定義窗體中的部件，注意在輸入字符時，前面都加上了 tr()函數。 第 19 句對于整個程序來說是關鍵，它使用信號 /槽機制連接了 detailButton 的單擊信號和窗口類 ExtensionDlg 的 slot2Extension()函數，這就使得整個對話框變得可伸縮。 第 20-22 行示范了 QDialogButtonBox 類的用法，它用于創建一個符合當前窗口部件樣 式的一組按鈕，并且它們被排列在某種布局之中。在 Qt Designer 中，最為常見的用法是 從窗口部件盒里面把默認的那個 QDialogButtonBox 窗口部件拖到界面上來，不過顯然這并 不如使用代碼來得方便。 第 20 行的 Qt::Horizontal 實參表示創建水平方向的按鈕組合。 第 21、22 兩行把兩個按鈕加入到這個組合之中。其中的 QDialogButtonBox::ActionRole 參數表示創建的按鈕具有實際的功能，單擊它可以引起對話框的某種變化。該參數可以有很 多不同的值，使得這些按鈕具有不同的功能，它們都被包含在 QDialogButtonBox::ButtonRole 這個枚舉值之中。 第 23-29 行設置窗體的布局。窗體的頂級布局是一個垂直布局，而其中嵌套了一個表 單布局。 第 23-25 行是設置表單布局的常用方法，表單布局常用于窗體界面元素可以整齊的分 成兩列的情況。addRow()方法用于向布局中加入整行的界面元素。 第 26-29 行定義窗體的頂級布局，并將其兩個元素 formLayout 和 btnBox 依次加入其中。 小貼士：布局也是一種窗口部件，認識到這一點很關鍵。 第 30-47 行定義了 initDetailInfo()函數。其實現過程與 initBasicInfo()函數大同 小異。只是需要注意第 47 行，正是由于對 detailWidget 調用了 hide()函數，才使得程序 初始時，顯示的是基本信息，而將擴展信息隱藏了起來。 hide()函數用于將窗口隱藏起來， 它是 Qt 默認的槽函數之一，其原型如下： ``` void QWidget::hide () [slot] ``` 它的作用等同于調用 setVisible(false)函數。 第 48-55 行定義了 slot2Extension()函數。前面講到，它是我們自定義的槽函數，在 點擊【Detail】按鈕時，將被觸發。它的內容很簡單，就是判斷擴展窗口是否被隱藏，如果被隱藏，就顯示它；否則就隱藏它。 isHidden()函數用于判斷窗體的顯示窗體的顯隱狀態。 然后就可以像下面這樣書寫主函數。第 1 句是必需的。第 2-4 句定義 ExtensionDlg 的 對象，并模態的顯示這個窗體。 ``` #include <QApplication> #include "extensionDlg.h" int main(int argc, char * argv[]) { QApplication app(argc,argv); ExtensionDlg exDlg; exDlg.show(); return app.exec(); } ``` 最后就是書寫項目文件 ExtensionDlg.pro 了。 ``` TEMPLATE = app TARGET = DEPENDPATH += . INCLUDEPATH += . # Input HEADERS += extensionDlg.h SOURCES += extensionDlg.cpp main.cpp ``` 第 1 句，表示程序的類型是 app。 第 2 句中 TARGET 指定可執行文件或庫的基本文件名，其中不包含任何的擴展、前綴或 版本號，默認的就是當前的目錄名。 第 4 句中，INCLUDEPATH 指定 C++編譯器搜索全局頭文件的路徑。 第 5 句是注釋。 第 6 句中，HEADERS 指定工程的 C++頭文件（.h）。多個頭文件的情況下，用空格隔 開。 第 7 句中,SOURCES 指定工程的 C++實現文件（.cpp），多個頭文件的情況下，用空格隔開。 qmake 的語法規則是比較簡明的，詳細情況請參閱附錄。 好了，到此我們就完成了使用子類化的方法創建自定義對話框窗口程序。這其中有幾點還想再強調一下，一是要明白所謂子類化自 QDialog 類就是指通過繼承自 QDialog 類來創建自定義的對話框類；二是要知道如果程序中用到了 Qt 的核心機制（如信號/槽），不 要忘記在類的聲明處的第一行加入 Q_OBJECT 宏；三是要掌握判斷和控制顯隱對話框的方法；四是掌握定義窗口界面元素的方法（先定義，再設置其屬性）；五是了解布局管理的基本方法（后面還會學到）；六是要掌握書寫工程文件的基本方法。七是掌握 Qt Creator 的基本用法。 在下一節，我們將采用 Qt Designer 完成這個程序界面的布局，大家將會了解到，有 時候使用 Qt Designer 設計界面會方便一些。