Qt之事件系统
简述
在Qt中,事件就是对象,派生自QEvent抽象类,用来表示在应用程序中发生的事件,或是应用程序需要处理的外部活动产生的事件。
Events可以被任何QObject派生的子类实例对象接收和处理,但它们是关联到特定控件的。下面,我们主要介绍event在典型应用程序中是如何发送及处理的。
事件如何发送
通常情况下,当一个事件发生时,Qt通过构造一个合适的QEvent子类对象来表示事件的发生,然后通过调用event()函数,将该事件对象发送给特定的QObject(或其子类)对象。
此函数不会对事件本身进行处理, 而是首先检查所接受到的事件类型, 然后根据事件类型来调用相应的事件处理程序,事件处理程序在处理完事件之后会返回一个bool值表示该事件是被接受,还是被忽略了。
某些事件,例如:QMouseEvent和QKeyEvent,来自于窗口系统;一些诸如:QTimerEvent,来自于其它的事件源;某些,则来自于应用程序本身。
事件类型
Qt为多数事件类型建立了相应的类,常见的有:QResizeEvent、QPaintEvent、QMouseEvent、QKeyEvent、QCloseEvent。
每一个特定的事件类都继承自QEvent,并添加特定的事件函数。例如:QResizeEvent添加了size()和oldSize()让控件可以发现它们的尺寸发生了的怎么改变.
某些类实际支持不止一种事件类型。QMouseEvent就支持鼠标按键按下事件、双击事件、移动事件、以及其它相关操作所引发的事件。
每一个事件都有一个关联的类型,由QEvent::Type定义,运行时可以很方便的检测每个事件对象的事件类型,以快速的判断该事件对象构造自哪个事件类。
由于程序需要和又多样又复杂的事件进行交互,所以Qt的事件发送机制设计的非常灵活。
QCoreApplication::notify()的文档简洁的说明了整个机制:
bool QCoreApplication::notify(QObject * receiver, QEvent * event) [virtual]
发送事件给接收者:receiver->event(event)。返回从接收者的事件处理程序返回的值。注意这个函数适用于该应用程序中的任何线程中的任何对象。对于特定类型的事件(例如:鼠标和键盘事件)),该事件将被传送到接收者的parent并这样逐级上传。
直到传到顶级对象,如果这些接收者都没有对该事件进行处理的话(比如:返回false)。
共五种处理事件的方式,重写QCoreApplication::notify()只是其中的一种。以下列出了这五种方法:
重写paintEvent()、mousePressEvent()等。这是最常用、最简单但也是最有限的方式。
重写QCoreApplication::notify()。这非常强大,可以完全控制事件处理,但一次只可用于一个子类。
为QCoreApplication::instance()安装一个事件过滤器。这个事件过滤器就能处理所有控件的所有事件,因此这与重写notify()一样强大;此外,可以有不止一个应用程序全局级的事件过滤器,应用程序全局级事件过滤器甚至可以收到已禁用控件的鼠标事件。
注意:应用程序级事件过滤器仅能用于存活在主线程中的对象。
重写QObject::event()(像QWidget那样 )。如果你重写了QObject::event(),当Tab键按下时,你就可以在任何控件级事件过滤器捕获这个Tab键按下事件之前处理这个事件。
给相应的接收对象安装一个事件过滤器。例如:一个捕获所有事件的事件过滤器,包含Tab和Shift+Tab键按下事件,在它们没有改变焦点控件之前。
另请参考:QObject::event()以及installEventFilter()。
事件处理程序
处理事件的标准方式是调用一个虚函数。例如:QPaintEvent是通过调用QWidget::paintEvent()来处理的。这个虚函数负责进行相应的处理,通常就是重画该控件。如果你在自己实现的虚函数中没有做所有必要的工作,你就有必要调用它的基类实现。
例如,下面的代码处理一个定制checkbox控件的鼠标左键点击事件,并将所有其它点击事件转发给它的基类 QCheckBox:
void MyCheckBox::mousePressEvent(QMouseEvent *event)
{
if (event->button() == Qt::LeftButton) {
// 处理鼠标左键
} else {
// 传递其它按键给基类
QCheckBox::mousePressEvent(event);
}
}
如果你需要替换基类的函数,你应该自己实现所有相关的处理。但是,如果你只想扩展基类的功能,那么你就只需实现需要实现的部分,然后调用基类处理函数来处理你不想处理的情况。
偶尔,你要处理没有相应处理函数的特定事件,或遇到事件处理函数不够用情况。最常见的例子是Tab键按下事件。通常,QWidget截获到Tab键按下事件后,会移动键盘焦点,但是少数控件需要自己来处理这个事件。这些对象可以重写QObject::event()函数,通用的事件处理程序,然后在通常处理过程之前或之后写自己的事件处理过程,或完全替代原处理过程。下面是这样一个很常见的控件:
一个既自己处理Tab事件又自己处理某些按键事件,然后将其它不需自己处理的事件转发给基类处理:
bool MyWidget::event(QEvent *event)
{
if (event->type() == QEvent::KeyPress) {
QKeyEvent *ke = static_cast<QKeyEvent *>(event);
if (ke->key() == Qt::Key_Tab) {
// 特别的Tab操作
return true;
}
} else if (event->type() == MyCustomEventType) {
MyCustomEvent *myEvent = static_cast<MyCustomEvent *>(event);
// 自定义事件处理
return true;
}
return QWidget::event(event);
}
注意:对没有处理的事件仍调用QWidget::event(),并返回该基类调用的返回值以指示事件是否被处理了;若返回true,则将会禁止将该事件再发往其它对象。
事件过滤器
有时候一个对象需要检查,还可能截取发往其它对象的事件。例如:对话框通常需要过滤发往某些控件的事件,比如:更改Enter键按下的事件处理。
通过调用过滤器对象的QObject::installEventFilter()函数,为目标对象设置一个事件过滤器,就可在过滤器对象的QObject::eventFilter()函数中处理发往目标对象的事件。一个事件过滤器在目标对象收到事件之前处理事件,这使得过滤器对象在需要的时候可以检查并丢弃事件。可以调用 QObject::removeEventFilter()来移除已经安装的事件过滤器。
当过滤器的eventFilter()实现被调用时,它可以选择处理该事件,还是转发该事件, 或禁止该事件继续被其它对象处理。若所有的事件过滤器都允许一个事件可被继续处理(每个过滤器处理后都返回 false), 该事件最终将被发送到目标对象。如果其中一个中止了这个流程(通过返回true),则后面的过滤器对象以及目标对象将不会收到该事件。
bool FilterObject::eventFilter(QObject *object, QEvent *event)
{
if (object == target && event->type() == QEvent::KeyPress) {
QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event);
if (keyEvent->key() == Qt::Key_Tab) {
// 特别的Tab操作
return true;
} else
return false;
}
return false;
}
上面代码演示了另外一种截取发往特定对象Tab键事件的方法。在这个例子里,该过滤器处理Tab事件后返回 true来阻止它们被继续处理。所有其它的按键事件将被忽略掉,然后过滤器返回false来允许该事件被已安装的后续过滤器处理,最终发往目标控件.
另外,也可以过滤整个应用程序的所有事件, 只需将过滤器对象安装到QApplication或QCoreApplication 对象上。这样的全局事件过滤器会在任何对象级过滤器调用之前调用.
这是非常强大的,但也拖慢了整个应用程序范围内每个事件的每次处理过程;通常使用其它的技术来代替。
发送事件
许多应用程序需要创建并发送自己的事件。你完全可以模仿Qt自有的事件循环机制, 先构造合适的事件对象, 然调用QCoreApplication::sendEvent()和QCoreApplication::postEvent()把构造好的事件发送给指定的接收者.
sendEvent()立即同步处理要发送的事件。当它返回的时候, 表示相关的事件过滤器 和/或 目标对象已经处理完了该事件。 对于多数的事件类,有一个名为isAccepted()的函数可以用来判别该事件是已被接受处理了,还是被拒绝处理了.
postEvent()将事件提交到一个队列中等待调度。在下一次Qt的主事件循环运行时,就会调度所有提交到队列中的事件,以某种优化的方式。例如,如果有几个大小改变事件,它们就会被压缩成一个事件。这同样适用于绘图事件:QWidget::update()调用postEvent(),以避免多次重画来消除闪烁以及提高速度。
postEvent()也被用于对象的初始化过程,因为提交过的事件通常在相应对象初始化完毕后极短的时间内就会被调度。在实现一个控件的时候,在自定义控件的构造函数中尽早支持事件机制是非常重要的,在可能接受到任何事件之前,确保尽早初始化成员变量。
要创建一个自定义的事件,你需要定义一个事件号,这个事件号应该大于QEvent::User,并且可能需要继承QEvent,以传递关于你自定义的事件类型的特定信息。