在这个例子中,我们介绍可以画自己的第一个自定义窗口部件。我们也加入了一个有用的键盘接口(只用了两行代码)。
- lcdrange.h包含LCDRange类定义。
- lcdrange.cpp包含LCDRange类实现。
- cannon.h包含CannonField类定义。
- cannon.cpp包含CannonField类实现。
- main.cpp包含MyWidget和main。
一行一行地解说
lcdrange.h:
这个文件和第七章中的lcdrange.h
很相似。我们添加了一个槽:setRange()
。
void setRange( int minVal, int maxVal );
现在我们添加了设置LCDRange
范围的可能性。直到现在,它就可以被设置为0~99。
lcdrange.cpp:
在构造函数中有一个变化(稍后我们会讨论的)。
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:
CanonField
是一个知道如何显示自己的新的自定义窗口部件。
(CannonField
是一个自定义的窗口部件(QWidget
),它具备显示自身内容的能力)
class CannonField : public QWidget
{
Q_OBJECT
public:
CannonField(QWidget *parent = 0, Qt::WindowFlags name = Qt::WindowFlags());
CanonField
继承了QWidget
,我们使用了LCDRange
中同样的方式。
int angle() const { return ang; }
public slots:
void setAngle(int degrees);
signals:
void angleChanged(int);
目前,CanonField
只包含一个角度值,我们使用了LCDRange
中同样的方式。
protected:
void paintEvent(QPaintEvent *); // 窗口刷新/重绘
这是我们在QWidget
中遇到的许多事件处理器中的第二个。只要一个窗口部件需要刷新它自己(比如,画窗口部件表面),这个虚函数就会被Qt调用。
paintEvent
不会在代码中直接调用。它是由 Qt 的事件循环机制自动调用的。事件循环会处理各种事件并调用相应的事件处理函数。你只需要重写 paintEvent
方法,Qt 会在需要绘制或重绘时自动调用它。
cannon.cpp:
CannonField::CannonField(QWidget *parent, Qt::WindowFlags name)
: QWidget(parent, name)
{
我们又一次使用和前一章中的LCDRange
同样的方式。
ang = 45;
setAutoFillBackground(true); // 设置填充背景
setPalette(QPalette(QColor(250, 250, 200)));
构造函数把角度值初始化为45度并且给这个窗口部件设置了一个自定义调色板。
这个调色板只是说明背景色,并选择了其它合适的颜色。(对于这个窗口部件,只有背景色和文本颜色是要用到的。)
void CannonField::setAngle(int degrees)
{
if (degrees < 5)
degrees = 5;
if (degrees > 70)
degrees = 70;
if (ang == degrees)
return;
ang = degrees;
repaint();
emit angleChanged(ang);
}
这个函数设置角度值。我们选择了一个5~70的合法范围,并根据这个范围来调节给定的degrees
的值。当新的角度值超过了范围,我们选择了不使用警告。
如果新的角度值和旧的一样,我们立即返回。这只对当角度值真的发生变化时,发射angleChanged()
信号有重要意义。
然后我们设置新的角度值并重新画我们的窗口部件。QWidget::repaint()
函数清空窗口部件(通常用背景色来充满)并向窗口部件发出一个绘画事件。这样的结构就是调用窗口部件的绘画事件函数一次。
最后,我们发射angleChanged()
信号来告诉外面的世界,角度值发生了变化。emit关键字只是Qt中的关键字,而不是标准C++的语法。实际上,它只是一个宏。
void CannonField::paintEvent(QPaintEvent *)
{
QString s = "Angle = " + QString::number(ang);
QPainter p(this);
p.drawText(200, 200, s);
}
这是我们第一次试图写一个绘画事件处理程序。这个事件参数包含一个绘画事件的描述。QPaintEvent
包含一个必须被刷新的窗口部件的区域。现在,我们比较懒惰,并且只是画每一件事。
我们的代码在一个固定位置显示窗口部件的角度值。首先我们创建一个含有一些文本和角度值的QString
,然后我们创建一个操作这个窗口部件的QPainter
并使用它来画这个字符串。我们一会儿会回到QPainter
,它可以做很多事。
main.cpp:
#include "cannon.h"
我们包含了我们的新类:
class MyWidget : public QWidget
{
public:
MyWidget(QWidget *parent=0, Qt::WindowFlags name = Qt::WindowFlags());
};
这一次我们在顶层窗口部件中只使用了一个LCDRange
和一个CanonField
。
LCDRange *lcdRange = 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);
我们把lcdRange
放到左下的单元格(1,0),在单元格内向上对齐。(这只是QGridLayout
所允许的一种对齐方式,而QGrid
不允许。)
grid->addWidget(cannonField, 1, 1);
我们把CannonField
对象放到右下(1,1)的单元格。(右上的单元格是空的)
grid->setColStretch(1, 10);
我们告诉QGridLayout
右边的列(列1)是可拉伸的。因为左边的列不是 (它的拉伸因数是0,这是默认值),QGridLayout
就会在MyWidget
被重新定义大小的时候试图让左面的窗口部件大小不变,而重新定义CannonField
的大小。
lcdRange->setValue(60);
我们设置了一个初始角度值。注意这将会引发从LCDRange
到CannonField
的连接。
注意:调用lcdRange->setRange(6, 70)
即调用slider->setRange(minVal, maxVal)
时, 就会把slider->value
的值设置为范围的最小值6。所以这个地方初始值设为6时不会触发 angleChanged(int)
这个信号,相应的槽函数setAngle
也不会执行。就会出现下图这种情况:
lcdRange->setFocus();
我们刚才做的是设置lcdRange
获得键盘焦点,这样默认情况下键盘输入会到达LCDRange
窗口部件。
LCDRange
没有包含任何keyPressEvent()
,所以这看起来不太可能有用。无论如何,它的构造函数中有了新的一行:
setFocusProxy(slider);
LCDRange
设置滑块作为它的焦点代理。这就是说当程序或者用户想要给LCDRange
一个键盘焦点,滑块就会就会注意到它。QSlider
有一个相当好的键盘接口,所以就会出现我们给LCDRange
添加的这一行。 (点击跳转)
行为
键盘现在可以做一些事了——方向键、Home、End、PageUp 和 PageDown 都可以作一些事情。
当滑块被操作,CannonFiled
会显示新的角度值。如果重新定义大小,CannonField
会得到尽可能多的空间。
练习
设置重新定义窗口的大小。如果你把它变窄或者变矮会发生什么? (LCDRange
不会改变 拉伸因数默认是0,右边会有变化)
如果你把AlignTop
删掉,LCDRange
的位置会发生什么变化?为什么?
(不再强制垂直顶部对齐,位置会依赖于布局的默认行为)
如果你给左面的列一个非零的拉伸因数,当你重新定义窗口大小时会发生什么? (LCDRange
会随着窗口的变化而变化)
不考虑setFocus()
调用。你更喜欢什么样的行为?
试着在QButton::setText()
调用中把“Quit”改为“&Quit”。按钮看起来变成什么样子了?如果你在程序运行的时候按下Alt+Q会发生什么?(在少量键盘中时Meta+Q)。
在大多数桌面应用程序中,特定键序列(如Alt+字母)会触发菜单或快捷键动作。在这种情况下,按下 Alt+Q
会激活 quit
按钮,因为 QPushButton
支持 &Quit
这样的文本格式,其中 &
符号表示快捷键(Mnemonic)。在 Windows 系统上,通常会展示一个虚线框(focus rectangle)来指示该按钮现在是活跃的,用户可以按下回车键来执行按钮的操作。这是桌面应用程序的标准行为,以增强可访问性和用户体验。
把CannonField
的文本放到中间。
现在你可以进行第九章了。
lcdrange.h
#ifndef LCDRANGE_H
#define LCDRANGE_H
#include <QWidget>
class QSlider;
class LCDRange : public QWidget
{
Q_OBJECT
public:
explicit LCDRange(QWidget *parent = 0, Qt::WindowFlags name = Qt::WindowFlags());
int value() const;
public slots:
void setValue(int);
void setRange(int minVal, int maxVal);
signals:
void valueChanged(int);
private:
QSlider *slider;
};
#endif // LCDRANGE_H
lcdrange.cpp
#include "lcdrange.h"
#include <QVBoxLayout>
#include <QLCDNumber>
#include <QSlider>
LCDRange::LCDRange(QWidget *parent, Qt::WindowFlags name)
: QWidget(parent, name)
{
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* layout = new QVBoxLayout;
layout->addWidget(lcd);
layout->addWidget(slider);
setLayout(layout);
}
int LCDRange::value() 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 );
}
cannon.h
#ifndef CANNON_H
#define CANNON_H
#include <QWidget>
class CannonField : public QWidget
{
Q_OBJECT
public:
CannonField(QWidget *parent = 0, Qt::WindowFlags name = Qt::WindowFlags());
int angle() const { return ang;}
QSizePolicy sizePolicy() const;
public slots:
void setAngle(int degrees);
signals:
void angleChanged(int);
protected:
void paintEvent(QPaintEvent *);
private:
int ang;
};
#endif // CANNON_H
cannon.cpp
#include "cannon.h"
#include <QPainter>
CannonField::CannonField(QWidget *parent, Qt::WindowFlags name)
: QWidget(parent, name)
{
ang = 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 (ang == degrees)
return;
ang = degrees;
repaint();
emit angleChanged(ang);
}
void CannonField::paintEvent(QPaintEvent *)
{
QString s = "Angle = " + QString::number(ang);
QPainter p(this);
p.drawText(200, 200, s);
}
main.cpp
#include <QApplication>
#include <Qpushbutton>
#include <QVBoxLayout>
#include <QGridLayout>
#include <Qfont>
#include "lcdrange.h"
#include "cannon.h"
class MyWidget : public QWidget
{
public:
MyWidget(QWidget *parent = 0, Qt::WindowFlags name = Qt::WindowFlags());
};
MyWidget::MyWidget(QWidget *parent, Qt::WindowFlags name)
: QWidget(parent, name)
{
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);
QVBoxLayout *layout = new QVBoxLayout;
layout->addLayout(grid);
setLayout(layout);
lcdRange->setValue(60);
lcdRange->setFocus(); //设置lcdRange获得键盘焦点
}
int main( int argc, char **argv )
{
QApplication a( argc, argv );
MyWidget w;
w.setGeometry( 100, 100, 500, 355 );
w.show();
return a.exec();
}