## 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 设计界面会方便一些。