Qt4_准备战斗

简介

在这个例子中，我们介绍可以画自己的第一个自定义窗口部件。我们也加入了一个有用的键盘接口（只用了两行代码）。

t8/lcdrange.h包含LCDRange类定义
t8/lcdrange.cpp包含LCDRange类实现
t8/cannon.h包含CannonField类定义
t8/cannon.cpp包含CannonField类实现
t8/main.cpp包含MyWidget和main

lcdrange.h

#ifndef LCDRANGE_H
#define LCDRANGE_H
#include <QVBoxLayout>
#include <QWidget>

class QSlider;

class LCDRange:public QWidget
{
    Q_OBJECT
public:
    LCDRange(QWidget *parent = 0);
    int showValue() const; //查询滑块的值
public slots:
    void setValue(int); //设置滑块的值
    void setRange(int minVal, int maxVal); //设置滑块的范围
signals:
    void valueChanged(int);
private:
    QSlider *slider;

};

#endif // LCDRANGE_H

我们添加了一个槽：setRange()。

void setRange( int minVal, int maxVal );
现在我们添加了设置 LCDRange 范围的可能性。直到现在，它就可以被设置为 0～99。

lcdrange.cpp

#include "lcdrange.h"

#include <QSlider>
#include <QLCDNumber>

LCDRange::LCDRange(QWidget *parent):QWidget(parent)
{
    QLCDNumber *lcd = new QLCDNumber(2);
    slider = new QSlider(Qt::Horizontal);
    slider->setRange(0,99);
    slider->setValue(0);

    connect(slider, SIGNAL(valueChanged(int)), lcd, SLOT(display(int)));
    connect(slider, SIGNAL(valueChanged(int)), SIGNAL(valueChanged(int)));

    setFocusProxy(slider); //设置这个窗口部件的焦点为slider

    QVBoxLayout *part = new QVBoxLayout;
    part->addWidget(lcd);
    part->addWidget(slider);
    setLayout(part);
}

int LCDRange::showValue() const
{
    return slider->value();
}

void LCDRange::setValue(int value)
{
    slider->setValue(value);
}

void LCDRange::setRange(int minVal, int maxVal)
{
    if(minVal<0||maxVal>99||minVal>maxVal)
    {
        qWarning("LCDRange::setRange(%d,%d)\n"
                 "\tRange must be 0..99\n"
                 "\tand minVal must not be greater than maxVal", minVal, maxVal);
        return;
    }
    slider->setRange(minVal, maxVal);
}

setRange()设置了 LCDRange 中滑块的范围。因为我们已经把 QLCDNumber 设置为只显示两位数字了，我们想通过限制 minVal 和 maxVal 为 0~99 来避免QLCDNumber 的溢出。（我们可以允许最小值为-9，但是我们没有那样做。）如果参数是非法的，我们使用 Qt 的 qWarning()函数来向用户发出警告并立即返回。

qWarning()是一个像 printf 一样的函数，默认情况下它的输出发送到 stderr。如果你想改变的话，你可以使用::qInstallMsgHandler()函数安装自己的处理函数。

cannon.h

#ifndef CANNON_H
#define CANNON_H

#include <QWidget>

class CannonField:public QWidget
{
    Q_OBJECT
public:
    CannonField(QWidget *parent = 0);
    int showAngle() const{return angle;} //显示角度值
public slots:
    void setAngle(int degrees); //接受信号：设置角度值
signals:
    void angleChanged(int); //发送信号：角度值变化
protected:
    void paintEvent(QPaintEvent *); //窗口刷新/重绘
private:
    int angle;//角度值

};

#endif // CANNON_H

CanonField 是一个知道如何显示自己的新的自定义窗口部件。

CanonField 继承了 QWidget，我们使用了 LCDRange 中同样的方式。

目前，CanonField 只包含一个角度值，我们使用了 LCDRange 中同样的方式。

void paintEvent(QPaintEvent *);
这是我们在 QWidget 中遇到的许多事件处理器中的第二个。只要一个窗口部件需要刷新它自己（比如，画窗口部件表面），这个虚函数就会被 Qt 调用。

cannon.cpp

#include "cannon.h"
#include <QPainter>

CannonField::CannonField(QWidget *parent):QWidget(parent)
{
    angle = 45;
    setAutoFillBackground(true);
    setPalette(QPalette(QColor(250,250,200)));
}

void CannonField::setAngle(int degrees)
{
    if(degrees<5)
        degrees = 5;
    if(degrees>70)
        degrees = 70; //限制输入角度范围
    if(angle == degrees)
        return; //如果角度与初始angle相同，返回
    angle = degrees; //若不同，将 angle设置为输入角度
    repaint(); //调用绘画函数
    emit angleChanged(angle); //发送angle变化消息
}

void CannonField::paintEvent(QPaintEvent *)
{
    QString s = "Angle = "+QString::number(angle); //创建文本
    QPainter p(this); //创建操作窗口部件的QPaonter
    p.drawText(200, 200, s); //在（200，200）处绘制文本s
}

构造函数把角度值初始化为 45 度并且给这个窗口部件设置了一个自定义调色板。

setPalette(QPalette(QColor(250,250,200)));
这个调色板只是说明背景色，并选择了其它合适的颜色。（对于这个窗口部件，只有背景色和文本颜色是要用到的。）

setAngle(int degrees)
这个函数设置角度值。我们选择了一个 5～70 的合法范围，并根据这个范围来调节给定的 degrees 的值。当新的角度值超过了范围，我们选择了不使用警告。

如果新的角度值和旧的一样，我们立即返回。这只对当角度值真的发生变化时，发射 angleChanged()信号有重要意义。

然后我们设置新的角度值并重新画我们的窗口部件。QWidget::repaint()函数清空窗口部件（通常用背景色来充满）并向窗口部件发出一个绘画事件。这样的结构就是调用窗口部件的绘画事件函数一次。

最后，我们发射 angleChanged()信号来告诉外面的世界，角度值发生了变化。emit关键字只是 Qt 中的关键字，而不是标准 C++的语法。实际上，它只是一个宏。

paintEvent(QPaintEvent *)
这是我们第一次试图写一个绘画事件处理程序。这个事件参数包含一个绘画事件的描述。QPaintEvent 包含一个必须被刷新的窗口部件的区域。现在，我们比较懒惰，并且只是画每一件事。

我们的代码在一个固定位置显示窗口部件的角度值。首先我们创建一个含有一些文本和角度值的 QString，然后我们创建一个操作这个窗口部件的 QPainter 并使用它来画这个字符串。我们一会儿会回到 QPainter，它可以做很多事。

main.cpp

#include "mainwindow.h"
#include <QApplication>
#include <QPushButton>
#include <QFont>
#include <QSlider>
#include <QLCDNumber>
#include <QVBoxLayout>
#include <QGridLayout>

#include "lcdrange.h"
#include "cannon.h"


class MyWidget:public QWidget
{
public:
    MyWidget(QWidget *parent = 0);

};

MyWidget::MyWidget(QWidget *parent):QWidget(parent)
{

    QPushButton *quit = new QPushButton("Quit");
    quit->setFont(QFont("Times",18,QFont::Bold));
    connect(quit,SIGNAL(clicked()),qApp,SLOT(quit()));

    LCDRange *lcdRange = new LCDRange;
    lcdRange->setRange(5,70);

    CannonField *cannonField = new CannonField;
    connect(lcdRange, SIGNAL(valueChanged(int)), cannonField, SLOT(setAngle(int)));
    connect(cannonField, SIGNAL(angleChanged(int)), lcdRange, SLOT(setValue(int)));


    QGridLayout *grid = new QGridLayout;
    grid->addWidget(quit, 0, 0);
    grid->addWidget(lcdRange, 1, 0, Qt::AlignTop);
    grid->addWidget(cannonField, 1, 1);
    grid->setColumnStretch(1,10);

    lcdRange->setValue(60);
    lcdRange->setFocus(); //对lcdRange窗口设置键盘焦点

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addLayout(grid);
    setLayout(layout);

}

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

    MyWidget w;
    w.show();

    return a.exec();
}

这一次我们在顶层窗口部件中只使用了一个 LCDRange 和一个 CanonField。

LCDRange *angle = new LCDRange;
在构造函数中，我们创建并设置了我们的 LCDRange。

lcdRange->setRange(5,70);
我们设置 LCDRange 能够接受的范围是 5～70 度。

CannonField *cannonField = new CannonField;
我们创建了我们的 CannonField。

connect(lcdRange, SIGNAL(valueChanged(int)), cannonField, SLOT(setAngle(int)));
connect(cannonField, SIGNAL(angleChanged(int)), lcdRange, SLOT(setValue(int)));
这里我们把 LCDRange 的 valueChanged()信号和 CannonField 的 setAngle()槽连接起来了。只要用户操作 LCDRange，就会刷新 CannonField 的角度值。我们也把它反过来连接了，这样 CannonField 中角度的变化就可以刷新 LCDRange 的值。

在我们的例子中，我们从来没有直接改变 CannonField 的角度，但是通过我们的最后一个 connect()我们就可以确保没有任何变化可以改变这两个值之间的同步关系。

这说明了组件编程和正确封装的能力。

注意只有当角度确实发生变化时，才发射 angleChanged()是多么的重要。如果LCDRange 和 CanonField 都省略了这个检查，这个程序就会因为第一次数值变化而进入到一个无限循环当中。

QGridLayout *grid = new QGridLayout;
无论如何，我们需要对我们的布局加一些控制，所以我们使用了更加强大的 QGridLayout 类。QGridLayout 不是一个窗口部件，它是一个可以管理任何窗口部件作为子对象的不同的类。

grid->addWidget(quit, 0, 0);
我们在网格的左上的单元格中加入一个 Quit 按钮：0,0。

grid->addWidget(lcdRange, 1, 0, Qt::AlignTop);
我们把 angle 这个 LCDRange 放到左下的单元格，在单元格内向上对齐。（这只是 QGridLayout 所允许的一种对齐方式，而 QGrid 不允许。）

grid->addWidget(cannonField, 1, 1);
我们把 CannonField 对象放到右下的单元格。（右上的单元格是空的。）

grid->setColumnStretch(1,10);
我们告诉 QGridLayout 右边的列（列 1）是可拉伸的。因为左边的列不是（它的拉伸因数是 0，这是默认值），QGridLayout 就会在 MyWidget 被重新定义大小的时候试图让左面的窗口部件大小不变，而重新定义 CannonField 的大小。

lcdRange->setValue(60);
我们设置了一个初始角度值。注意这将会引发从 LCDRange 到 CannonField 的连接。

lcdRange->setFocus();
我们刚才做的是设置 angle 获得键盘焦点，这样默认情况下键盘输入会到达LCDRange 窗口部件。

LCDRange 没有包含任何 keyPressEvent()，所以这看起来不太可能有用。无论如何，它的构造函数中有了新的一行：
setFocusProxy(slider);
LCDRange 设置滑块作为它的焦点代理。这就是说当程序或者用户想要给LCDRange 一个键盘焦点，滑块就会就会注意到它。QSlider 有一个相当好的键盘接口，所以就会出现我们给 LCDRange 添加的这一行。

用鼠标改变左边滑块的值，lcd屏和右边的绘图界面文本值都会随之变化。按键盘的上下左右键也可控制左边滑块的值，lcd屏和绘图界面的值也随之变化。