第二章 创建对话框

1、子类化QDialog

第一个例子是完全使用C++编写的Find对话框。

finddialog.h:

#ifndef FINDDIALOG_H
#define FINDDIALOG_H

#include <QDialog>

class QCheckBox;
class QLabel;
class QLineEdit;
class QPushButton;

class FindDialog : public QDialog
{
    Q_OBJECT
public:
    FindDialog(QWidget *parent = 0);
signals:
    void findNext(const QString &str, Qt::CaseSensitivity cs);
    void findPrevious(const QString &str, Qt::CaseSensitivity cs);
private slots:
    void findClicked();
    void enableFindButton(const QString &text);
private:
    QLabel *label;
    QLineEdit *lineEdit;
    QCheckBox *caseCheckBox;
    QCheckBox *backwardCheckBox;
    QPushButton *findButton;
    QPushButton *closeButton;
};

#endif // FINDDIALOG_H

头部的预编译指令是为了防止对这个头文件的多重包含

对于定义了信号与槽的类来说在类定义的开始处的Q_OBJECT宏都是必须的，它给出了一些函数的声明

FindDialog类的构造函数是典型的Qt窗口部件类的定义方式。parent参数指定了它的父窗口部件。该参数的默认值是一个空指针，意味着该对话框没有父对象。

signals关键字实际上是一个宏，C++预处理器会在编译程序找到它之前把它转换成标准C++代码。我的疑问是为什么槽的声明是私有的。

finddialog.cpp:

#include <QtGui>
#include <QLabel>
#include <QCheckBox>
#include <QLineEdit>
#include <QPushButton>
#include <QHBoxLayout>
#include <QVBoxLayout>
#include "finddialog.h"

FindDialog::FindDialog(QWidget *parent)
    :QDialog(parent)
{
    label = new QLabel(tr("Find &what:"));
    lineEdit = new QLineEdit;
    label->setBuddy(lineEdit);

    caseCheckBox = new QCheckBox(tr("Match &case"));
    backwardCheckBox = new QCheckBox(tr("Search &backward"));

    findButton = new QPushButton(tr("&Find"));
    findButton->setDefault(true);
    findButton->setEnabled(false);

    closeButton = new QPushButton("Close");
    connect(lineEdit, SIGNAL(textChanged(const QString &)),
            this, SLOT(enableFindButton(const QString &)));
    connect(findButton, SIGNAL(clicked()),
            this, SLOT(findClicked()));
    connect(closeButton, SIGNAL(clicked()),
            this, SLOT(close()));

    QHBoxLayout *topLeftLayout = new QHBoxLayout;
    topLeftLayout->addWidget(label);
    topLeftLayout->addWidget(lineEdit);

    QVBoxLayout *leftLayout = new QVBoxLayout;
    leftLayout->addLayout(topLeftLayout);
    leftLayout->addWidget(caseCheckBox);
    leftLayout->addWidget(backwardCheckBox);

    QVBoxLayout *rightLayout = new QVBoxLayout;
    rightLayout->addWidget(findButton);
    rightLayout->addWidget(closeButton);
    rightLayout->addStretch();

    QHBoxLayout *mainLayout = new QHBoxLayout;
    mainLayout->addLayout(leftLayout);
    mainLayout->addLayout(rightLayout);
    setLayout(mainLayout);

    setWindowTitle(tr("Find"));
    setFixedHeight(sizeHint().height());
}

void FindDialog::findClicked()
{
    QString text = lineEdit->text();
    Qt::CaseSensitivity cs =
            caseCheckBox->isChecked() ? Qt::CaseSensitive
                                      : Qt::CaseInsensitive;
    if(backwardCheckBox->isChecked())
    {
        emit findPrevious(text, cs);
    }
    else
    {
        emit findNext(text, cs);
    }
}

void FindDialog::enableFindButton(const QString &text)
{
    findButton->setEnabled(!text.isEmpty());
}

在字符串周围的tr函数调用时把它们翻译成其他语言的标记，即使现在没有需要将程序翻译成其它语言，但是这样做也是有好处的。

在部件的text字符创中使用了符号“&”表示快捷键，使用alt+“&”后的第一个字母可以实现快捷的选中该部件。

所谓buddy，就是一个窗口部件，它可以再按下标签的快捷键时接受焦点输入。

setDefault让Find按钮称为默认按钮，默认按钮即当用户按下回车时能够按下对应的键。

omit是Qt中的关键字，它会被C++预处理器转换成标准C++代码。

main.cpp:

#include <QApplication>
#include "finddialog.h"

int main(int argc, char** argv)
{
    QApplication app(argc, argv);
    FindDialog *dialog = new FindDialog;
    dialog->show();
    return app.exec();
}

运行效果：

2、深入介绍槽与信号

信号与槽是Qt编程的基础。它可以让编程人员将这些互不了解的对象绑定在一起。

槽和普通的C++函数几乎是一样的，可以使虚函数、可以被重载、可以使公有的、保护的、私有的。并且也可以被其他C++成员函数直接调用，还有它们的参数可以使任意类型，唯一不同的是：槽还可以和信号连接在一起，在这种情况下，每当发射这个信号的时候，就会自动调用这个槽。

connect(sender, SIGNAL(signal), receiver,SLOT(slot));

这里的sender和receiver是指向QObject的指针，signal和slot是不带参数的函数名。实际上，SIGNAL和SLOT宏会把它们的参数转换成相应的字符串。

• 一个信号可以连接多个槽

在发射这个信号的时候会以不确定的顺序一个接一个的调用这些槽

• 多个信号可以连接同一个槽

无论发射哪一个信号都会调用这个槽

• 一个信号可以与另外一个信号连接

当发射第一个信号的时候也会发射第二个信号

• 连接可以被移除

这种情况很少用

注意：要把信号连接到槽，它们的参数必须具有相同的顺序和相同的类型。例外：如果信号比连接的槽的参数多，那么后面多余的参数将被忽略。

3、快速设计对话框

这一节会使用Qt Designer来可视化的设计一个对话框。

操作步骤就是使用Qt Designer来设计需要的对话框，然后保存为.ui的格式。

在编译的时候会将.ui格式的文件转换为C++并且存储在ui_name.h和ui_name.cpp中。

生成的类没有任何基类，当在程序中使用它时，可以创建一个QDialog类的对象，然后把它传递给setupUi()函数。

现在定义一个新的类继承自QDialog和Ui::GoToCellDialog类（我填写的Ui文件生成的类名）。

gotocelldialog.h:

#ifndef GOTOCELLDIALOG_H
#define GOTOCELLDIALOG_H

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

class GotoCellDialog : public QDialog, public Ui::GoToCellDialog
{
    Q_OBJECT
public:
    GotoCellDialog(QWidget *parent = 0);
private slots:
    void on_lineEdit_textChanged();
};

#endif // GOTOCELLDIALOG_H

该类继承自两个类：QDialog、Ui::GoToCellDialog

gotocelldialog.cpp:

#include <QtGui>
#include "gotocelldialog.h"

GotoCellDialog::GotoCellDialog(QWidget *parent)
    : QDialog(parent)
{
    setupUi(this);

    // QRegExp regExp("[A-Za-z][1-9][0-9]{0, 2}");
    QRegExp regExp("[A-Za-z][1-9][0-9]{0,2}");
    lineEdit->setValidator(new QRegExpValidator(regExp, this));

    connect(okButton, SIGNAL(clicked()), this, SLOT(accept()));
    connect(cancelButton, SIGNAL(clicked()), this, SLOT(reject()));
}

void GotoCellDialog::on_lineEdit_textChanged()
{
    okButton->setEnabled(lineEdit->hasAcceptableInput());
}

实现文件中绑定了需要绑定的信号与槽。

对编辑框的输入进行了验证，使用正则表达式的方法来验证。

accept()槽可以讲对话框返回的结果变量设置为QDialog::Accepted，其值为1、而reject()槽会把对话框的值设置为QDialog::Rejected，其值为0。可以根据对话框的返回值来判断是否点击了OK按钮。

main.cpp:

#include <QApplication>

#include "gotocelldialog.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    GotoCellDialog *dialog = new GotoCellDialog;
    dialog->show();

    return a.exec();
}

实例化一个该类的对象并显示出来。

使用QDialogButtonBox来制作这个对话框，以使它在MAC平台上显得更加圆润。

4、