## 10.2 Ui_YourFormName.h 文件的组成 我们了解了 uic 工具的使用方法和公用，现在来看看它为我们生成的 C++头文件的组成 是什么样的，里面的“构件”又有哪些功用，这对我们理解后面几节的内容有着重要的作用 。 我们将使用 Qt Designer 创建一个界面文件，名为 calculatorform.ui，这个程序主要 是完成简单的加法计算功能。该界面的元素组合如图 10-1 所示。  图 10-1 使用 Qt Designer 制作的界面 怎样做到在不使用 qmake 的情况下，就可以产生对应的头文件呢，我们遵循上一节介绍 的方法，在 Qt 的命令行下面输入如下命令： ``` uic –o ui_calculatorform.h calculatorform.ui ``` 小贴士：再次提醒，以 Windows XP 操作系统为例，进入 Qt 命令行的方法是：依次点击【开始】->【所有程序】->【Qt SDK by Nokia v2009.03 (open source)】->【Qt Command Prompt】。然后切换到你的.ui 文件所在的目录，执行上述命令即可。 以下是据此生成的 ui_calculatorform.h 文件的完整内容，我将分段向大家讲解。 ``` /******************************************************************************** ** Form generated from reading ui file 'calculatorform.ui' ** ** Created: Sun Sep 6 22:34:26 2009 ** by: Qt User Interface Compiler version 4.5.2 ** ** WARNING! All changes made in this file will be lost when recompiling ui file! ********************************************************************************/ ``` 这一段代码是 uic 工具自动生成的注释内容，它记录了该 C++头文件对应的原始.ui 文件的名字以及产生的时间和使用的 uic 的版本。最后一行提示内容很重要，它明确的告诉我们，不要手动修改该文件内容，因为在下次运行 qmake 或者 uic 时，它们会被覆盖掉。所以，我们如果需要对文件内容做修改，那么到 Qt Designer 中修改界面元素就行了，uic 会把所 有的改动反映出来。 ``` #ifndef UI_CALCULATORFORM_H #define UI_CALCULATORFORM_H #include <QtCore/QVariant> #include <QtGui/QAction> #include <QtGui/QApplication> #include <QtGui/QButtonGroup> #include <QtGui/QGridLayout> #include <QtGui/QHeaderView> #include <QtGui/QLabel> #include <QtGui/QSpacerItem> #include <QtGui/QSpinBox> #include <QtGui/QVBoxLayout> #include <QtGui/QWidget> ``` 上面这段的开头两句加上该文件结尾的 #endif // UI_CALCULATORFORM_H 这句构成了完整的防止头文件重复定义的卫哨，这是很好的编程规范，我们在自己书写代码时，也要遵循 这种严谨的做法。 后面的几句加入了程序中用到的窗口部件以及变量的头文件 。请大家注意它们的用法也 是非常规范的，正是许多 C++大师所提倡的“用到什么就包含什么，不用的就不包含 ”的做 法的应用典范。笔者发现有很多的朋友不论什么情况，都喜欢加入一句 #include <QtGui>或 者#include <QtCore>，这固然省事，因为它们包含了这两个模块下的所有子模块的定义 ，但 是这样一来，就降低了程序的编译速度，使得性能下降。 ``` QT_BEGIN_NAMESPACE class Ui_CalculatorForm { public: QGridLayout *gridLayout; QSpacerItem *spacerItem; QLabel *label_3_2; QVBoxLayout *vboxLayout; QLabel *label_2_2_2; QLabel *outputWidget; QSpacerItem *spacerItem1; QVBoxLayout *vboxLayout1; QLabel *label_2; QSpinBox *inputSpinBox2; QLabel *label_3; QVBoxLayout *vboxLayout2; QLabel *label; QSpinBox *inputSpinBox1; ``` 上面这段代码中，首先用 QT_BEGIN_NAMESPACE 宏表示开始进入名字空间。然后定义了一个名为 Ui_CalculatorForm 的类，它实际上是界面的实体类，界面上的所有元素都被定义 为相应的窗口部件的实例，并且它们一定是被定义为 public,即公有的成员，这将使得后面的 Ui 名字空间内的派生类能够继承它们。 ``` void setupUi(QWidget *CalculatorForm) { if (CalculatorForm->objectName().isEmpty()) CalculatorForm->setObjectName(QString::fromUtf8("CalculatorForm")); CalculatorForm->resize(400, 300); QSizePolicy sizePolicy(static_cast<QSizePolicy::Policy>(5), static_cast<QSizePolicy::Policy>(5)); sizePolicy.setHorizontalStretch(0); sizePolicy.setVerticalStretch(0); sizePolicy.setHeightForWidth(CalculatorForm->sizePolicy().hasHeightForWidth()); CalculatorForm->setSizePolicy(sizePolicy); gridLayout = new QGridLayout(CalculatorForm); #ifndef Q_OS_MAC gridLayout->setSpacing(6); #endif #ifndef Q_OS_MAC gridLayout->setMargin(9); #endif gridLayout->setObjectName(QString::fromUtf8("gridLayout")); gridLayout->setObjectName(QString::fromUtf8("")); spacerItem = new QSpacerItem(40, 20, QSizePolicy::Expanding, QSizePolicy::Minimum); gridLayout->addItem(spacerItem, 0, 6, 1, 1); label_3_2 = new QLabel(CalculatorForm); label_3_2->setObjectName(QString::fromUtf8("label_3_2")); label_3_2->setGeometry(QRect(169, 9, 20, 52)); label_3_2->setAlignment(Qt::AlignCenter); gridLayout->addWidget(label_3_2, 0, 4, 1, 1); vboxLayout = new QVBoxLayout(); #ifndef Q_OS_MAC vboxLayout->setSpacing(6); #endif vboxLayout->setMargin(1); vboxLayout->setObjectName(QString::fromUtf8("vboxLayout")); vboxLayout->setObjectName(QString::fromUtf8("")); label_2_2_2 = new QLabel(CalculatorForm); label_2_2_2->setObjectName(QString::fromUtf8("label_2_2_2")); label_2_2_2->setGeometry(QRect(1, 1, 36, 17)); vboxLayout->addWidget(label_2_2_2); outputWidget = new QLabel(CalculatorForm); outputWidget->setObjectName(QString::fromUtf8("outputWidget")); outputWidget->setGeometry(QRect(1, 24, 36, 27)); outputWidget->setFrameShape(QFrame::Box); outputWidget->setFrameShadow(QFrame::Sunken); outputWidget->setAlignment(Qt::AlignAbsolute|Qt::AlignBottom|Qt::AlignCenter|Qt::AlignHCenter |Qt::AlignHorizontal_Mask|Qt::AlignJustify|Qt::AlignLeading|Qt::AlignLeft|Qt::AlignRight|Qt:: AlignTop|Qt::AlignTrailing|Qt::AlignVCenter|Qt::AlignVertical_Mask); vboxLayout->addWidget(outputWidget); gridLayout->addLayout(vboxLayout, 0, 5, 1, 1); spacerItem1 = new QSpacerItem(20, 40, QSizePolicy::Minimum, QSizePolicy::Expanding); gridLayout->addItem(spacerItem1, 1, 2, 1, 1); vboxLayout1 = new QVBoxLayout(); #ifndef Q_OS_MAC vboxLayout1->setSpacing(6); #endif vboxLayout1->setMargin(1); vboxLayout1->setObjectName(QString::fromUtf8("vboxLayout1")); vboxLayout1->setObjectName(QString::fromUtf8("")); label_2 = new QLabel(CalculatorForm); label_2->setObjectName(QString::fromUtf8("label_2")); label_2->setGeometry(QRect(1, 1, 46, 19)); vboxLayout1->addWidget(label_2); inputSpinBox2 = new QSpinBox(CalculatorForm); inputSpinBox2->setObjectName(QString::fromUtf8("inputSpinBox2")); inputSpinBox2->setGeometry(QRect(1, 26, 46, 25)); vboxLayout1->addWidget(inputSpinBox2); gridLayout->addLayout(vboxLayout1, 0, 3, 1, 1); label_3 = new QLabel(CalculatorForm); label_3->setObjectName(QString::fromUtf8("label_3")); label_3->setGeometry(QRect(63, 9, 20, 52)); label_3->setAlignment(Qt::AlignCenter); gridLayout->addWidget(label_3, 0, 1, 1, 1); vboxLayout2 = new QVBoxLayout(); #ifndef Q_OS_MAC vboxLayout2->setSpacing(6); #endif vboxLayout2->setMargin(1); vboxLayout2->setObjectName(QString::fromUtf8("vboxLayout2")); vboxLayout2->setObjectName(QString::fromUtf8("")); label = new QLabel(CalculatorForm); label->setObjectName(QString::fromUtf8("label")); label->setGeometry(QRect(1, 1, 46, 19)); vboxLayout2->addWidget(label); inputSpinBox1 = new QSpinBox(CalculatorForm); inputSpinBox1->setObjectName(QString::fromUtf8("inputSpinBox1")); inputSpinBox1->setGeometry(QRect(1, 26, 46, 25)); vboxLayout2->addWidget(inputSpinBox1); gridLayout->addLayout(vboxLayout2, 0, 0, 1, 1); retranslateUi(CalculatorForm); QMetaObject::connectSlotsByName(CalculatorForm); } // setupUi ``` 上面这段代码是界面实体类的公有方法 setupUi()的内容。这是最为重要的一个成员函数，它完成了整个界面的构造和布局，代码的内容比较简单，遵循了我们前面反复讲到的使 用 Qt 编程的基本步骤，即先声明要使用到的窗口部件，然后实例化它们，再为它们设置属 性和方法。 QMetaObject::connectSlotsByName(CalculatorForm);这一句是需要重点说明的，因为 它实现了 CalculatorForm 界面实体类中的信号与槽机制。这个方法的原型是： ``` void QMetaObject::connectSlotsByName ( QObject * object ) [static] ``` 它是 QMetaObject 类的静态方法，作用是递归搜索 object 对象及子对象，然后将其中相匹配的信号与槽连接起来。所谓相匹配的信号与槽，就是要求槽函数的书写形式如下所示： ``` void on_<object name>_<signal name>(<signal parameters>); ``` 从编程人员的角度来看，只要将槽函数遵循上面的书写形式 ，就能够实现信号和槽的自动关联，而无需手写代码显式的完成。 再举个例子，假设我们的界面实体类中含有一个子对象，它的类型是 QPushButton，它 的 objectName 属性被设置为 btn1。那么为了使槽函数与信号 clicked()能够自动关联，我们 必须将槽函数写成如下形式： ``` void on_button1_clicked(); ``` 小贴士：QMetaObject 类是 Qt 元对象系统（Meta-Object System）的组成部分，是实现信号/槽机制、运行时类型信息以及 Qt 属性系统的基础。在一个应用程序中所有的 QObject 子类 都会创建一个属于自己的单独的 QMetaObject 的实例，并且这个实例存储了该子类的所有元 对象信息。这些通常包括类名（class name）、超类名（superclass name）、属性信息（properties）、信号与槽（signals and slots）等。 关于 Qt 的元对象系统，我们会在后面的第 13 章作详细介绍。 在后面我们会介绍编译时处理.ui 文件的 3 种方法：直接使用法、单继承法和多继承法。 无论使用它们中的哪一种，都要显式的调用 setupUi()这个方法来完成界面元素的构造和布 局，而它的参数就是你自定义的窗体类，这一点请大家在阅读时注意。 ``` void retranslateUi(QWidget *CalculatorForm) { CalculatorForm->setWindowTitle(QApplication::translate("CalculatorForm", "Calculator Form", 0, QApplication::UnicodeUTF8)); label_3_2->setText(QApplication::translate("CalculatorForm", "=", 0, QApplication::UnicodeUTF8)); label_2_2_2->setText(QApplication::translate("CalculatorForm", "Output", 0, QApplication::UnicodeUTF8)); outputWidget->setText(QApplication::translate("CalculatorForm", "0", 0, QApplication::UnicodeUTF8)); label_2->setText(QApplication::translate("CalculatorForm", "Input 2", 0, QApplication::UnicodeUTF8)); label_3->setText(QApplication::translate("CalculatorForm", "+", 0, QApplication::UnicodeUTF8)); label->setText(QApplication::translate("CalculatorForm", "Input 1", 0, QApplication::UnicodeUTF8)); Q_UNUSED(CalculatorForm); } // retranslateUi ``` 以上这段是 retranslateUi 方法的定义，它使得应用程序具备了支持国际化的能力 。其 中调用了 translate()方法，它是在 Qt 4.5 以后新引入的。 ``` namespace Ui { class CalculatorForm: public Ui_CalculatorForm {}; } // namespace Ui QT_END_NAMESPACE #endif // UI_CALCULATORFORM_H ``` 上面这段代码定义了名字空间 Ui，在其内部声明了一个名为 CalculatorForm 的类，它单公有继承自界面实体类 Ui_CalculatorForm，这就使得它继承了界面实体类的所有公有成 员。声明名字空间的用意是防止混淆命名。 注意，这个类的名字是与你的.ui 文件中 Form 的 objectName 的属性值相一致的。在后面的章节里，我们都要与这个类打交道，而不与界面实体类 Ui_CalculatorForm 发生联系，这样做就使得应用程序的界面设计与代码尽可能的分离开来，是现代编程思想的体现。