QT的事件分发、事件过滤器详解
一、事件的流向
QT的各种控件（QObject的子类）都有事件处理成员函数，例如：
bool QObject::event(QEvent *e);//所有事件
dragEnterEvent(QDragEnterEvent *);//拖拽进入事件
focusInEvent(QFocusEvent *);//获得焦点事件
mousePressEvent(QMouseEvent *);//鼠标压下事件
····//还有几十个各种类型的事件，不一一列举了，任何一个控件的帮助文件里都可以查到
这些事件需要继承父类重写覆盖之后才能使用，这里主要想说明一点，事件的分发方向，是从子控件一步步向上传递到祖宗控件的，如果子控件拦截了事件，那么父控件就接收不到事件了。子控件怎么拦截事件，怎么不拦截事件，可以先看这个例子：
添加新类QPushButtonEx，它的父类为QPushButton，QPushButtonEx 覆盖 QPushButton 的鼠标按下事件：
void QButtonEx::mousePressEvent(QMouseEvent *e)
{
qDebug()<<"button pressed";
e->ignore();//ignore的作用是使事件继续向父控件传递
}
在一个MainWindow上添加一个QPushButton（提升为QPushButtonEx），也重写MainWindow的鼠标按下事件：
void MainWindow::mousePressEvent(QMouseEvent *e)
{
qDebug()<<"mainwindow pressed";
e->ignore();
}
点击按钮，运行结果如下：
这也就验证了事件的传递方向，子控件先接收到事件，父控件后接收到事件。尤其注意代码中的e->ignore();这句的作用是使得事件能够继续流向父控件；与之相反的是e->accept();它将事件拦截，父控件将无法收到已经被accept过的事件；重写的事件处理函数中，如果不写accept或ignore，那么默认为：事件被accept（拦截）！
上面的代码为例，如果QButtonEx::mousePressEvent()函数中不写e->ignore()，或者写e->accept()，那么
MainWindow::mousePressEvent()函数将不会被触发，运行结果中只能看到打印：button pressed
二、事件过滤器
考虑一下上面的这种事件流向机制，有何不足？先来看这几种应用场景：
1、某事件发生了，我想在父控件先处理，处理完再让子控件处理（和前面所述的流向相反）
2、某些控件已经重写了一些事件处理函数，我想临时让这些事件处理函数失效，待会再恢复
3、Qt 创建了QEvent事件对象之后，会调用QObject的event()函数处理事件的分发。显然，我们可以在event()函数中实现拦截的操作。由于event()函数是 protected 的，因此，需要继承已有类。如果组件很多，就需要重写很多个event()函数。这当然相当麻烦，更不用说重写event()函数还得小心一堆问题。https://blog.csdn.net/gusgao/article/details/48917427
4、绘制了一个按钮，按钮上又覆盖上一层label，那么这个label会遮住button，使得这个按钮无法被点击到。
这些问题都可以用事件过滤器来解决，事件过滤器的作用用一句话来说就是:
任意对象都可以提前拦截其他任意对象的事件，拦截到的事件都会在本对象的eventFilter函数中被接收到，程序员可以决定拦截并处理后是否继续放行。
举例：一个按钮被点击，本应是按钮先收到点击事件，通过事件过滤器，可以让窗体先收到这个事件，窗体再决定是否把这个事件继续传播给按钮。从事件过滤器的功能来看，不妨叫做：事件监视器、事件拦截器。
假设有两个对象，分别叫做“老师A”和“学生a”，实现事件过滤器需要做两个工作：
1、学生a给老师A授权，允许老师查看自己的所有事件；
2、老师A重写eventFilter函数，对拦截到的学生的事件进行处理；
第1个工作就是一句代码，例如：
ui->pushButton->installEventFilter(this);//pushButton设置mainwindow作为自己的事件监视器(事件过滤器)
第2个工作就是重写监视对象A的成员函数：
bool MainWindow::eventFilter(QObject *watched, QEvent *event)//pushButton的所有事件都要先流到这里，这里放行后pushButton才能收到事件
{
if(watched == ui->pushButton)//确认被监视的对象
{
if(event->type() == QEvent::MouseButtonPress)//确认事件的类型
{
QMouseEvent *e = static_cast
qDebug()<<"Filter mainwindow MouseButtonPress";
if(e->button() == Qt::LeftButton)//鼠标左键
return true; //true=拦截
else
return false; //false=继续传播
}
}
return false; //false=继续传播
}
分别单击鼠标左、右键，运行的结果分别为：
------
可以看到：
1、按钮并没有收到左键被按下事件，因为这一事件被监视对象给拦截后，没有放行；
2、按钮收到了右键按下事件，这一事件依次被以下函数执行：监视对象的eventFilter函数-->按钮的mousePressEvent()函数-->窗口的mousePressEvent()函数
/*******************************
Qt的事件模型一个强大的功能是:一个QObject对象能够监视发送其他QObject对象的事件，在事件到达之前对其进行处理。
假设我们有一个CustomerInfoDialog控件，由一些QLineEdit控件组成。我们希望使用Space键得到下一个QLineEdit的输入焦点。
一个最直接的方法是继承QLineEdit重写keyPressEvent()函数，当点击了Space键时，调用focusNextChild()：
void MyLineEdit::keyPressEvent(QKeyEvent *event)
{
if (event->key() == Qt::Key_Space)
{
focusNextChild();
}
else
{
QLineEdit::keyPressEvent(event);
}
}
这个方法有一个最大的缺点：如果我们在窗体中使用了很多不同类型的控件（QComboBox，QSpinBox等等），
我们也要继承这些控件，重写它们的keyPressEvent()。一个更好的解决方法是让CustomerInfoDialog监视其子控件的键盘事件，
在监视代码处实现以上功能。这就是事件过滤的方法。实现一个事件过滤包括两个步骤：
1. 在目标对象上调用installEventFilter()，注册监视对象。
2. 在监视对象的eventFilter()函数中处理目标对象的事件。
注册监视对象的位置是在CustomerInfoDialog的构造函数中：
CustomerInfoDialog::CustomerInfoDialog(QWidget *parent) : QDialog(parent)
{
...
firstNameEdit->installEventFilter(this);
lastNameEdit->installEventFilter(this);
cityEdit->installEventFilter(this);
phoneNumberEdit->installEventFilter(this);
}
事件过滤器注册后，发送到firstNameEdit，lastNameEdit，cityEdit，phoneNumberEdit控件的事件首先到达CustomerInfoDialog::eventFilter()函数，然后在到达最终的目的地。
下面是eventFilter()函数的代码：
bool CustomerInfoDialog::eventFilter(QObject *target, QEvent *event)
{
if (target == firstNameEdit || target == lastNameEdit
|| target == cityEdit || target == phoneNumberEdit)
{
if (event->type() == QEvent::KeyPress)
{
QKeyEvent *keyEvent = static_cast
if (keyEvent->key() == Qt::Key_Space)
{
focusNextChild();
return true;
}
}
}
return QDialog::eventFilter(target, event);
}
首先，我们看是目标控件是否为QLineEdit，如果事件为键盘事件，把QEvent转换为QKeyEvent，确定被敲击的键。如果为Space键，调用focusNextChild()，把焦点交给下一个控件，返回true通知Qt已经处理了这个事件，如果返回false，Qt将会把事件传递给目标控件，把一个空格字符插入到QLineEdit中。
如果目标控件不是QLineEdit，或者事件不是Space敲击事件，把控制权交给基类QDialog的eventFilter()。目标控件也可以是基类QDialog正在监视的控件。（在Qt4.1中，QDialog没有监视的控件，但是Qt的其他控件类，如QScrollArea，监视一些它们的子控件）
Qt的事件处理有5中级别：
1. 重写控件的事件处理函数：如重写keyPressEvent()，mousePressEvent()和paintEvent()，这是最常用的事件处理方法，我们已经看到过很多这样的例子了。
2. 重写QObject::event()，在事件到达事件处理函数时处理它。在需要改变Tab键的惯用法时这样做。也可以处理那些没有特定事件处理函数的比较少见的事件类型（例如，QEvent::HoverEnter）。我们重写event()时，必须要调用基类的event()，由基类处理我们不需要处理的那些情况。
3. 给QObject对象安装事件过滤器：对象用installEventFilter()后，所有达到目标控件的事件都首先到达监视对象的eventFilter()函数。如果一个对象有多个事件过滤器，过滤器按顺序激活，先到达最近安装的监视对象，最后到达最先安装的监视对象。
4. 给QApplication安装事件过滤器，如果qApp（唯一的QApplication对象）安装了事件过滤器，程序中所有对象的事件都要送到eventFilter()函数中。这个方法在调试的时候非常有用，在处理非活动状态控件的鼠标事件时这个方法也很常用。
5. 继承QApplication，重写notify()。Qt调用QApplication::nofity()来发送事件。重写这个函数是在其他事件过滤器处理事件前得到所有事件的唯一方法。通常事件过滤器是最有用的，因为在同一时间，可以有任意数量的事件过滤器，但是notify()函数只有一个。
许多事件类型，包括鼠标，键盘事件，是能够传播的。如果事件在到达目标对象的途中或者由目标对象处理掉，事件处理的过程会重新开始，不同的是这时的目标对象是原目标对象的父控件。这样从父控件再到父控件，知道有控件处理这个事件或者到达了最顶级的那个控件。
下图显示了一个键盘事件在一个对话框中从子控件到父控件的传播过程。当用户敲击一个键盘，时间首先发送到有焦点的控件上（这个例子中是QCheckBox）。如果QCheckBox没有处理这个事件，Qt把事件发送到QGroupBox中，如果仍然没有处理，则最后发送到QDialog中。
/***************************************
事件
在Qt中，事件是作为对象处理的，所有事件对象继承自抽象类QEvent。此类用来表示程序内部发生或者来自于外部但应用程序应该知道的动作。事件能够能过被 QObject 的子类接受或者处理，但是通常用在与组件有关的应用中。本文主要阐述了在一个典型应用中的事件接收与处理。
事件的传递发送
当一个事件产生时，Qt 通过实例化一个 QEvent 的合适的子类来表示它，然后通过调用 event() 函数发送给 QObject 的实例（或者它的子类）。
event() 函数本身并不会处理事件，根据事件类型，它将调用相应的事件处理函数，并且返回事件被接受还是被忽略。
一些事件，比如 QMouseEvent 和 QKeyEvent，来自窗口系统；有的，比如 QTimerEvent，来自于其他事件源；另外一些则来自应用程序本身。
事件的类型
大部分事件类型有专门的类，比如 QResizeEvent, QPaintEvent, QMouseEvent, QKeyEvent 和 QCloseEvent。它们都是 QEvent 的子类，并且添加了自己特定的事件处理函数。比如 QResizeEvent 事件添加了 size()和 oldSize() 函数，使组件获知自身大小的改变。
有些事件支持不止一个事件类型。比如 QMouseEvent 鼠标事件，可以表示鼠标的按下，双击，移动，以及其它的一些操作。
每一个事件都有其相关联的类型，由 QEvent::Type 定义。我们能够很方便地在运行时用这些类型来判断该事件是哪一个子类。
因为程序响应方式的多样性和复杂性，Qt 的事件传递机制是富有弹性很灵活的。QCoreApplication::notify() 的相关文档阐述大部分内容；Qt Quarterly 中的文章 Another Look at Events 也进行了简要描述。在这里我们的阐述对于 95% 的程序而言来说已经足够了。
事件的处理
通常事件的处理需要调用一个虚函数。比如，QPaintEvent 事件的处理需要调用 QWidget::paintEvent() 函数。这个虚函数负责做出适当的响应，通常是用来重绘组件。如果你在自己的函数中并不打算实现所有的处理，你可以调用基类的实现。
例如，下面的代码用来处理鼠标左键点击一个自定义的选择框的操作，而其他的点击事件则被传递给基类 QCheckBox 处理。
void MyCheckBox::mousePressEvent(QMouseEvent *event)
{
if (event->button() == Qt::LeftButton) {
// handle left mouse button here
} else {
// pass on other buttons to base class
QCheckBox::mousePressEvent(event);
}
}
如果你想代替基类的处理，你必须自己实现所有的功能。但是，如果你只想扩展子基类的功能，你只需要实现你自己需要的那部分，剩下的让基类来替你处理。
少数情况下，Qt 可能没有指定专门的处理函数，或者指定的处理函数不能满足要求。通常对 Tab 键的处理就会发生这种情况。一般地，Tab 键用来移动焦点，但是一些控件需要 Tab 键作其它的事情。
这些对象可以通过重新实现 QObject::event() 来满足需要，它们可以在通用处理调用之前或之后来加入自己的处理，或者完全将事件处理替换为自己的事件处理函数。一个非常罕见的控件或许既要处理 Tab 键，又要调用程序特定的事件类型。那么，我们就可以使用以下代码实现。
bool MyWidget::event(QEvent *event)
{
if (event->type() == QEvent::KeyPress) {
QKeyEvent *ke = static_cast
if (ke->key() == Qt::Key_Tab) {
// special tab handling here
return true;
}
} else if (event->type() == MyCustomEventType) {
MyCustomEvent *myEvent = static_cast
// custom event handling here
return true;
}
return QWidget::event(event);
}
注意，QWidget::event() 在那些没有被处理的事件仍然要被调用，并且通过返回值表示事件是否被处理，返回 true 表示事件被阻止发送到其他的对象。
事件过滤器
有时，并不存在一个特定事件函数，或者特定事件功能不足。最普通的例如按下tab键。正常情况下，被QWidget看成是去移动 键盘焦点，但少数窗口部件需要自行解释。
让我们试着设想已经有了一个CustomerInfoDialog的小部件。CustomerInfoDialog 包含一系列QLineEdit. 现在，我们想用空格键来代替Tab，使焦点在这些QLineEdit间切换。
一个解决的方法是子类化QLineEdit，重新实现keyPressEvent()，并在keyPressEvent()里调用focusNextChild()。像下面这样：
void MyLineEdit::keyPressEvent(QKeyEvent *event)
{
if (event->key() == Qt::Key_Space)
{
focusNextChild();
}
else
{
QLineEdit::keyPressEvent(event);
}
}
但这有一个缺点。如果CustomerInfoDialog里有很多不同的控件（比如QComboBox,QEdit,QSpinBox），我们就必须子类化这么多控件。这是一个烦琐的任务。
一个更好的解决办法是： 让CustomerInfoDialog去管理他的子部件的按键事件，实现要求的行为。我们可以使用事件过滤器。
一个事件过滤器的安装需要下面2个步骤：
1， 调用installEventFilter（）注册需要管理的对象。
2，在eventFilter() 里处理需要管理的对象的事件。
一般，推荐在CustomerInfoDialog的构造函数中注册被管理的对象。像下面这样：
CustomerInfoDialog::CustomerInfoDialog(QWidget *parent)
: QDialog(parent)
{
...
firstNameEdit->installEventFilter(this);
lastNameEdit->installEventFilter(this);
cityEdit->installEventFilter(this);
phoneNumberEdit->installEventFilter(this);
}
一旦，事件管理器被注册，发送到firstNameEdit，lastNameEdit，cityEdit，phoneNumberEdit的事件将首先发送到eventFilter()。
下面是一个 eventFilter()函数的实现：
bool CustomerInfoDialog::eventFilter(QObject *target, QEvent *event)
{
if (target == firstNameEdit || target == lastNameEdit
|| target == cityEdit || target == phoneNumberEdit)
{
if (event->type() == QEvent::KeyPress)
{
QKeyEvent *keyEvent = static_cast
if (keyEvent->key() == Qt::Key_Space)
{
focusNextChild();
return true;
}
}
}
return QDialog::eventFilter(target, event);
}
在上面的函数中，我们首先检查目标部件是否是 firstNameEdit，lastNameEdit，cityEdit，phoneNumberEdit。接着，我们判断事件是否是按键事件。如果事件是按键事件，我们把事件转换为QKeyEvent。接着，我们判断是否按下了空格键，如果是，我们调用focusNextChild()，把焦点传递给下一个控件。然后，返回，true通知Qt，我们已经处理了该事件。
如果返回false的话，Qt继续将该事件发送给目标控件，结果是一个空格被插入到QLineEdit中。
如果目标控件不是 QLineEdit,或者按键不是空格键，我们将把事件传递给基类的eventFilter()函数。
Qt提供5个级别的事件处理和过滤：
1，重新实现事件函数。 比如： mousePressEvent(), keyPress-Event(), paintEvent() 。
这是最常规的事件处理方法。
2，重新实现QObject::event().
这一般用在Qt没有提供该事件的处理函数时。也就是，我们增加新的事件时。
3，安装事件过滤器
4，在 QApplication 上安装事件过滤器。
这之所以被单独列出来是因为： QApplication 上的事件过滤器将捕获应用程序的所有事件，而且第一个获得该事件。也就是说事件在发送给其它任何一个event filter之前发送给QApplication的event filter。
5，重新实现QApplication 的 notify()方法.
Qt使用 notify()来分发事件。要想在任何事件处理器捕获事件之前捕获事件，唯一的方法就是重新实现QApplication 的 notify()方法。
Qt创建了QEvent事件对象之后，会调用QObject的event()函数做事件的分发。有时候，你可能需要在调用event()函数之前做一些另外的操作，比如，对话框上某些组件可能并不需要响应回车按下的事件，此时，你就需要重新定义组件的event()函数。如果组件很多，就需要重写很多次event()函数，这显然没有效率。为此，你可以使用一个事件过滤器，来判断是否需要调用event()函数。
QOjbect有一个eventFilter()函数，用于建立事件过滤器。这个函数的签名如下：
virtual bool QObject::eventFilter ( QObject * watched, QEvent * event )
如果watched对象安装了事件过滤器，这个函数会被调用并进行事件过滤，然后才轮到组件进行事件处理。在重写这个函数时，如果你需要过滤掉某个事件，例如停止对这个事件的响应，需要返回true
bool MainWindow::eventFilter(QObject *obj, QEvent *event)
{
if (obj == textEdit) {
if (event->type() == QEvent::KeyPress) {
QKeyEvent *keyEvent = static_cast(event);
qDebug() << "Ate key press" << keyEvent->key();
return true;
} else {
return false;
}
} else {
// pass the event on to the parent class
return QMainWindow::eventFilter(obj, event);
}
}
上面的例子中为MainWindow建立了一个事件过滤器。为了过滤某个组件上的事件，首先需要判断这个对象是哪个组件，然后判断这个事件的类型。例如，我不想让textEdit组件处理键盘事件，于是就首先找到这个组件，如果这个事件是键盘事件，则直接返回true，也就是过滤掉了这个事件，其他事件还是要继续处理，所以返回false。对于其他组件，我们并不保证是不是还有过滤器，于是最保险的办法是调用父类的函数。
在创建了过滤器之后，下面要做的是安装这个过滤器。安装过滤器需要调用installEventFilter()函数。这个函数的签名如下：
void QObject::installEventFilter ( QObject * filterObj )
1
这个函数是QObject的一个函数，因此可以安装到任何QObject的子类，并不仅仅是UI组件。这个函数接收一个QObject对象，调用了这个函数安装事件过滤器的组件会调用filterObj定义的eventFilter()函数。例如，textField.installEventFilter(obj)，则如果有事件发送到textField组件是，会先调用obj->eventFilter()函数，然后才会调用textField.event()。
当然，你也可以把事件过滤器安装到QApplication上面，这样就可以过滤所有的事件，已获得更大的控制权。不过，这样做的后果就是会降低事件分发的效率。
如果一个组件安装了多个过滤器，则最后一个安装的会最先调用，类似于堆栈的行为。
注意，如果你在事件过滤器中delete了某个接收组件，务必将返回值设为true。否则，Qt还是会将事件分发给这个接收组件，从而导致程序崩溃。
事件过滤器和被安装的组件必须在同一线程，否则，过滤器不起作用。另外，如果在install之后，这两个组件到了不同的线程，那么，只有等到二者重新回到同一线程的时候过滤器才会有效。
事件的调用最终都会调用QCoreApplication的notify()函数，因此，最大的控制权实际上是重写QCoreApplication的notify()函数。由此可以看出，Qt的事件处理实际上是分层五个层次：重定义事件处理函数，重定义event()函数，为单个组件安装事件过滤器，为QApplication安装事件过滤器，重定义QCoreApplication的notify()函数。这几个层次的控制权是逐层增大的。
/***********************父子窗体事件传递与事件过滤**************
处理监控系统的时候遇到问题，在MainWidget中创建多个子Widget的时候，原意是想鼠标点击先让MainWidget截获处理后再分派给子Widget去处理，但调试后发现如果子Widget重新实现了事件方法，就直接处理掉事件了，没有进到MainWidget的处理方法中去，如果子Widget没有accept或ignore该事件，则该事件就会被传递给其父亲，在子Widget存在accept或ignore事件的时候，想要经过一下MainWidget的处理方法，就得用到事件处理器，因此网上找了一下，发现QT的事件处理器可以处理。
QT将事件封装为QEvent实例以后，会呼叫QObject的event()方法，并且将QEvent实例传送给它，在某些情况下，希望在执行event()之前，先对一些事件进行处理或过滤，然后再决定是否呼叫event()方法，这时候可以使用事件过滤器。
可以重新定义一个继承自QObject(或其子类)的类的eventFilter()方法，
bool FilterObject::eventFilter(QObject *object, QEvent *event)
{
if(event->type() == QEvent::KeyPress)
{
QKeyEvent *keyEvent = static_cast
if (keyEvent->key() == Qt::Key_Tab)
{
// 处理Tab键
return true;
}
}
return false;
}
eventFilter()的object参数表示事件发生的来源物件，eventFilter()若返回false，则安装该事件过滤器的对象的event()会继续执行，若返回true，则安装事件过滤器的对象后event()方法就不会被执行，由此进行事件的拦截处理。给本对象安装事件过滤器：
this->installEventFilter(this);
Qt事件的类型很多, 常见的qt的事件如下:
键盘事件: 按键按下和松开.
鼠标事件: 鼠标移动,鼠标按键的按下和松开.
拖放事件: 用鼠标进行拖放.
滚轮事件: 鼠标滚轮滚动.
绘屏事件: 重绘屏幕的某些部分.
定时事件: 定时器到时.
焦点事件: 键盘焦点移动.
进入和离开事件: 鼠标移入widget之内,或是移出.
移动事件: widget的位置改变.
大小改变事件: widget的大小改变.
显示和隐藏事件: widget显示和隐藏.
窗口事件: 窗口是否为当前窗口.
还有一些非常见的qt事件,比如socket事件,剪贴板事件,字体改变,布局改变等等.
Qt的事件和Qt中的signal不一样. 后者通常用来"使用"widget, 而前者用来"实现" widget. 比如一个按钮, 我们使用这个按钮的时候, 我们只关心他clicked()的signal, 至于这个按钮如何接收处理鼠标事件,再发射这个信号,我们是不用关心的. 但是如果我们要重载一个按钮的时候,我们就要面对event了. 比如我们可以改变它的行为,在鼠标按键按下的时候(mouse press event) 就触发clicked()的signal而不是通常在释放的( mouse release event)时候.
事件的产生
事件的两种来源:
一种是系统产生的;通常是window system把从系统得到的消息,比如鼠标按键,键盘按键等, 放入系统的消息队列中. Qt事件循环的时候读取这些事件,转化为QEvent,再依次处理.
一种是由Qt应用程序程序自身产生的.程序产生事件有两种方式, 一种是调用QApplication::postEvent(). 例如QWidget::update()函数,当需要重新绘制屏幕时,程序调用update()函数,new出来一个paintEvent,调用QApplication::postEvent(),将其放入Qt的消息队列中,等待依次被处理. 另一种方式是调用sendEvent()函数. 这时候事件不会放入队列, 而是直接被派发和处理, QWidget::repaint()函数用的就是这种方式.
事件的调度
两种调度方式,一种是同步的, 一种是异步.
Qt的事件循环是异步的,当调用QApplication::exec()时,就进入了事件循环. 该循环可以简化的描述为如下的代码:
while ( !app_exit_loop ) {
while( !postedEvents ) { processPostedEvents() }
while( !qwsEvnts ){ qwsProcessEvents(); }
while( !postedEvents ) { processPostedEvents() }
}
先处理Qt事件队列中的事件, 直至为空. 再处理系统消息队列中的消息, 直至为空, 在处理系统消息的时候会产生新的Qt事件, 需要对其再次进行处理.
调用QApplication::sendEvent的时候, 消息会立即被处理,是同步的. 实际上QApplication::sendEvent()是通过调用QApplication::notify(), 直接进入了事件的派发和处理环节.
事件的派发和处理
首先说明Qt中事件过滤器的概念. 事件过滤器是Qt中一个独特的事件处理机制, 功能强大而且使用起来灵活方便. 通过它, 可以让一个对象侦听拦截另外一个对象的事件. 事件过滤器是这样实现的: 在所有Qt对象的基类: QObject中有一个类型为QObjectList的成员变量,名字为eventFilters,当某个QObjec (qobjA)给另一个QObject (qobjB)安装了事件过滤器之后, qobjB会把qobjA的指针保存在eventFilters中. 在qobjB处理事件之前,会先去检查eventFilters列表, 如果非空, 就先调用列表中对象的eventFilter()函数. 一个对象可以给多个对象安装过滤器. 同样, 一个对象能同时被安装多个过滤器, 在事件到达之后, 这些过滤器以安装次序的反序被调用. 事件过滤器函数( eventFilter() ) 返回值是bool型, 如果返回true, 则表示该事件已经被处理完毕, Qt将直接返回, 进行下一事件的处理; 如果返回false, 事件将接着被送往剩下的事件过滤器或是目标对象进行处理.
Qt中,事件的派发是从QApplication::notify() 开始的, 因为QAppliction也是继承自QObject, 所以先检查QAppliation对象, 如果有事件过滤器安装在qApp上, 先调用这些事件过滤器. 接下来QApplication::notify() 会过滤或合并一些事件(比如失效widget的鼠标事件会被过滤掉, 而同一区域重复的绘图事件会被合并). 之后,事件被送到reciver::event() 处理.
同样, 在reciver::event()中, 先检查有无事件过滤器安装在reciever上. 若有, 则调用之. 接下来,根据QEvent的类型, 调用相应的特定事件处理函数. 一些常见的事件都有特定事件处理函数, 比如:mousePressEvent(), focusOutEvent(), resizeEvent(), paintEvent(), resizeEvent()等等. 在实际应用中, 经常需要重载这些特定事件处理函数在处理事件. 但对于那些不常见的事件, 是没有相对应的特定事件处理函数的. 如果要处理这些事件, 就需要使用别的办法, 比如重载event() 函数, 或是安装事件过滤器.
事件的转发
对于某些类别的事件, 如果在整个事件的派发过程结束后还没有被处理, 那么这个事件将会向上转发给它的父widget, 直到最顶层窗口. 如图所示, 事件最先发送给QCheckBox, 如果QCheckBox没有处理, 那么由QGroupBox接着处理, 如果QGroupBox没有处理, 再送到QDialog, 因为QDialog已经是最顶层widget, 所以如果QDialog不处理, QEvent将停止转发.
如何判断一个事件是否被处理了呢? Qt中和事件相关的函数通过两种方式相互通信. QApplication::notify(), QObject::eventFilter(), QObject::event() 通过返回bool值来表示是否已处理. “真”表示已经处理, “假”表示事件需要继续传递. 另一种是调用QEvent::ignore() 或 QEvent::accept() 对事件进行标识. 这种方式只用于event() 函数和特定事件处理函数之间的沟通. 而且只有用在某些类别事件上是有意义的, 这些事件就是上面提到的那些会被转发的事件, 包括: 鼠标, 滚轮, 按键等事件.
实际应用
1.重载特定事件处理函数
最常见的事件处理办法就是重载象mousePressEvent(), keyPressEvent(), paintEvent() 这样的特定事件处理函数. 以按键事件为例, 一个典型的处理函数如下:
void imageView::keyPressEvent(QKeyEvent * event)
{
switch (event->key()) {
case Key_Plus:
zoomIn();
break;
case Key_Minus:
zoomOut();
break;
case Key_Left:
// …
default:
QWidget::keyPressEvent(event);
}
}
2.重载event()函数
通过重载event()函数,我们可以在事件被特定的事件处理函数处理之前(象keyPressEvent())处理它. 比如, 当我们想改变tab键的默认动作时,一般要重载这个函数. 在处理一些不常见的事件(比如:LayoutDirectionChange)时,evnet()也很有用,因为这些函数没有相应的特定事件处理函数. 当我们重载event()函数时, 需要调用父类的event()函数来处理我们不需要处理或是不清楚如何处理的事件.
下面这个例子演示了如何重载event()函数, 改变Tab键的默认动作: (默认的是键盘焦点移动到下一个控件上. )
bool CodeEditor::event(QEvent * event)
{
if (event->type() == QEvent::KeyPress) {
QKeyEvent *keyEvent = (QKeyEvent *) event;
if (keyEvent->key() == Key_Tab) {
insertAtCurrentPosition('\t');
return true;
}
}
return QWidget::event(event);
}
3.在QT对象上安装事件过滤器
安装事件过滤器有两个步骤: (假设要用A来监视过滤B的事件)
首先调用B的installEventFilter( const QOject *obj ), 以A的指针作为参数. 这样所有发往B的事件都将先由A的eventFilter()处理.
然后, A要重载QObject::eventFilter()函数, 在eventFilter() 中书写对事件进行处理的代码.
用这种方法改写上面的例子: (假设我们将CodeEditor 放在MainWidget中)
MainWidget::MainWidget()
{
// …
CodeEditor * ce = new CodeEditor( this, “code editor”);
ce->installEventFilter( this );
// …
}
bool MainWidget::eventFilter( QOject * target , QEvent * event )
{
if( target == ce ){
if( event->type() == QEvent::KeyPress ) {
QKeyEvent *ke = (QKeyEvent *) event;
if( ke->key() == Key_Tab ){
ce->insertAtCurrentPosition('\t');
return true;
}
}
}
return false;
}
4.给QAppliction对象安装事件过滤器
一旦我们给qApp(每个程序中唯一的QApplication对象)装上过滤器,那么所有的事件在发往任何其他的过滤器时,都要先经过当前这个eventFilter(). 在debug的时候,这个办法就非常有用, 也常常被用来处理失效了的widget的鼠标事件,通常这些事件会被QApplication::notify()丢掉. ( 在QApplication::notify() 中, 是先调用qApp的过滤器, 再对事件进行分析, 以决定是否合并或丢弃)
5.继承QApplication类,并重载notify()函数
Qt是用QApplication::notify()函数来分发事件的.想要在任何事件过滤器查看任何事件之前先得到这些事件,重载这个函数是唯一的办法. 通常来说事件过滤器更好用一些, 因为不需要去继承QApplication类. 而且可以给QApplication对象安装任意个数的事件过滤器, 相比之下, notify()函数只有一个.