第一个例子是一个用C++实现的查找对话框。我们把这个对话框实现为一个类,这样它就是一个独立的控件,并有自己的信号(signal)和slot函数
类的源代码分别放在finddialog.h和finddialog.cpp中。首先看finddialog.h的代码
1 #ifndef FINDDIALOG_H
2 #define FINDDIALOG_H
3 #include <QDialog>
4 class QCheckBox;
5 class QLabel;
6 class QLineEdit;
7 class QPushButton;
8 class FindDialog : public QDialog
9 {
10 Q_OBJECT
11 public:
12 FindDialog(QWidget *parent = 0);
13 signals:
14 void findNext(const QString &str, Qt::CaseSensitivity cs);
15 void findPrevious(const QString &str, Qt::CaseSensitivity cs);
16 private slots:
17 void findClicked();
18 void enableFindButton(const QString &text);
19 private:
20 QLabel *label;
21 QLineEdit *lineEdit;
22 QCheckBox *caseCheckBox;
23 QCheckBox *backwardCheckBox;
24 QPushButton *findButton;
25 QPushButton *closeButton;
26 };
27 #endif
一共27行,第1,2,27行是为了避免头文件被多次包含。
第3行包含QDialog头文件,这个类从QDialog继承,QDialog从QWidget继承。
第4至7行是用到的Qt中类的前向声明。通过前向声明,编译器就知道这个类已经存在,而不用写出包含的头文件。这个问题稍后还要讲。
第8至26行是类FindDialog的定义。
第10行,Q_OBJECT是一个宏定义,如果类里面用到了signal或者slots,就要声明这个宏。
第12行, FindDialog(QWidget *parent = 0);构造函数是Qt控件类的标准格式,默认的父参数为NULL,说明没有父控件。
第13行,signals声明了这个对话框发出的两个信号,如果选择向前查找,那么对话框就发出findPrevious()信号,否则,发出findNext()信号。关键字signals也是一个宏,在编译之前,C++预处理把它变成标准的c++代码。Qt::CaseSensitivity是一个枚举类型,有Qt::CaseSensitive和Qt::CaseInsensitive两个值。
在类的私有部分,声明了两个slot函数。为了实现这两个函数,需要用到对话框的其他控件的信息,所以保存了一些控件的指针。slots关键字和signals一样,也是一个宏。
对于私有成员变量,我们只是使用了它们的指针,没有对它们进行存取操作,编译器不需要知道它们的详细定义,所以只使用了这些类的前向声明。当然,也可以使用<QCheckBox>,<QLabel>等,但是,使用前向声明会让编译速度更快一些。
下面看一下finddialog.cpp源文件代码:
文件头和构造函数部分
1 #include <QtGui>
2 #include "finddialog.h"
3 FindDialog::FindDialog(QWidget *parent)
4 : QDialog(parent)
5 {
6 label = new QLabel(tr("Find &what:"));
7 lineEdit = new QLineEdit;
8 label->setBuddy(lineEdit);
9 caseCheckBox = new QCheckBox(tr("Match &case"));
10 backwardCheckBox = new QCheckBox(tr("Search &backward"));
11 findButton = new QPushButton(tr("&Find"));
12 findButton->setDefault(true);
13 findButton->setEnabled(false);
14 closeButton = new QPushButton(tr("Close"));
15 connect(lineEdit, SIGNAL(textChanged(const QString &)),
16 this, SLOT(enableFindButton(const QString &)));
17 connect(findButton, SIGNAL(clicked()),
18 this, SLOT(findClicked()));
19 connect(closeButton, SIGNAL(clicked()),
20 this, SLOT(close()));
21 QHBoxLayout *topLeftLayout = new QHBoxLayout;
22 topLeftLayout->addWidget(label);
23 topLeftLayout->addWidget(lineEdit);
24 QVBoxLayout *leftLayout = new QVBoxLayout;
25 leftLayout->addLayout(topLeftLayout);
26 leftLayout->addWidget(caseCheckBox);
27 leftLayout->addWidget(backwardCheckBox);
28 QVBoxLayout *rightLayout = new QVBoxLayout;
29 rightLayout->addWidget(findButton);
30 rightLayout->addWidget(closeButton);
31 rightLayout->addStretch();
32 QHBoxLayout *mainLayout = new QHBoxLayout;
33 mainLayout->addLayout(leftLayout);
34 mainLayout->addLayout(rightLayout);
35 setLayout(mainLayout);
36 setWindowTitle(tr("Find"));
37 setFixedHeight(sizeHint().height());
38 }
首先包含了<QtGui>, 这个头文件包含了Qt的GUI类的定义。Qt有几个模块,每个有其自己的库。最重要的模块是QtCore, QtGui, QtNetwork, QtOpenGL, QtSql, QtSvg, 及 QtXml. <QtGui> 头文件包含了QtCore 及QtGui 模块的所有类的定义,因此包含该头文件可以避免单独包含每个类。然而包含这种大的头文件是个不好的风格,特别是对于大型应用程序.
第四行,将parent 参数传递给基类构造函数。接着创建子控件。tr()函数用以语言翻译,它在QObject及每个包含Q_OBJECT宏的派生类中声明。这是个好习惯。
第8行,设置标签的buddy是行编辑。一个buddy是指当标签的快捷键按下时接收焦点的控件。如当用户按Alt+W (该标签的快捷键), 焦点会落在行编辑上(该标签的buddy).
第十二行,调用setDefault(true)将Find 按钮设为对话框的默认按钮。默认按钮指的是当用户按回车键时对应按下的按钮。
由于 QObject是FindDialog的一个祖先,因此我们在调用connect()时可以省略QObject:: 前缀。
布局管理器能包含控件及其它布局管理器。最外面的layout是主layout,负责对话框的整个区域,其余的是子layout。使用spacer或stretch保证按钮在其layout中的占位。注:布局管理器不是控件,它们从QLayout派生,第25,33,34行,子布局管理器添加到父layout中,会自动为其指定父亲。
第37行,设置窗口的固定高度,因为对话框中没有任何控件能够明确占用任何其它垂直的空间。QWidget::sizeHint() 函数返回控件的理想大小。
到这里FindDialog的构造函数就完成了。在创建控件和布局时我们使用了new,一般情况下,我们还需要写析构函数delete这些控件。但是在Qt中这是不需要的,当父控件销毁时,Qt自动删除它所有的子控件和布局。
下面是FindDialog类的两个slot函数:
39 void FindDialog::findClicked()
40 {
41 QString text = lineEdit->text();
42 Qt::CaseSensitivity cs =
43 caseCheckBox->isChecked() ? Qt::CaseSensitive
44 : Qt::CaseInsensitive;
45 if (backwardCheckBox->isChecked()) {
46 emit findPrevious(text, cs);
47 } else {
48 emit findNext(text, cs);
49 }
50 }
51 void FindDialog::enableFindButton(const QString &text)
52 {
53 findButton->setEnabled(!text.isEmpty());
54 }
当用户点击findButton按钮,findClicked()就会调用,根据backwardCheckBox状态,他发出findPrevious()或者findNext()信号。emit也是一个Qt的宏。
当用户改变lineEdit中的文本,enableFindButton()slot函数就会调用。如果输入了文本,那么让findButton有效,否则就无效。
最后,创建main.cpp测试FindDialog对话框。
1 #include <QApplication>
2 #include "finddialog.h"
3 int main(int argc, char *argv[])
4 {
5 QApplication app(argc, argv);
6 FindDialog *dialog = new FindDialog;
7 dialog->show();
8 return app.exec();
9 }
运行qmake编译程序。由于在FindDialog中包含了Q_OBJECT宏,由qmake生成的makefile会包含特殊的规则运行moc(Qt的原对象编译器)。
为了确保moc正确工作,类定义必须放在头文件而不能放在实现文件中。由moc生成的代码中包含这个头文件,并加入它自己实现的C++代码。
使用了Q_OBJECT宏的类必须运行moc。如果使用qmake,那么makefile里自动包含相关的规则。如果忘记了运行moc,就会发生连接错误,报函数声明了却没实现。不同的编译器给出的提示信息不同,有的会非常晦涩。GCC给出的错误信息如下:
finddialog.o: In function 'FindDialog::tr(char const*, char const*)':
/usr/lib/qt/src/corelib/global/qglobal.h:1430: undefined reference to
'FindDialog::staticMetaObject'
Visual C++中的输出是这样:
finddialog.obj : error LNK2001: unresolved external symbol
"public:~virtual int __thiscall MyClass::qt_metacall(enum QMetaObject
::Call,int,void * *)"
这时需要重新运行qmake,更新makefile,然后编译程序。
运行程序,如果看到了快捷键,测试ALT+W,ALT+C,ALT+B,ALT+F引发相应的处理程序。使用TAB键在将焦点改变到不同的控件上。默认的TAB键是控件创建的顺序。QWidget::setTabOrder()可以改变这个顺序。
提供合适的tab顺序和快捷键可以让用户不用鼠标也可以运行程序,通过键盘可以快速控制程序。