Qt-事件过滤器eventFilter概念及使用方法实例

一、事件的流向

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<QMouseEvent *>(event);//前面已经确认过事件类型为鼠标类型，所以这里可以放心的进行静态转换
            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事件过滤器（QT事件处理的5个层次：自己覆盖或过滤，父窗口过滤，Application过滤与通知）

Qt事件模型一个真正强大的特色是一个QObject 的实例能够管理另一个QObject 实例的事件。 

让我们试着设想已经有了一个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<QKeyEvent *>(event); 
             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(), keyPressEvent(),   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 )

　　这个函数是QObject的一个函数，因此可以安装到任何QObject的子类，并不仅仅是UI组件。这个函数接收一个QObject对象，调用了这个函数安装事件过滤器的组件会调用filterObj定义的eventFilter()函数。例如，textField.installEventFilter(obj)，则如果有事件发送到textField组件是，会先调用obj->eventFilter()函数，然后才会调用textField.event()。

　　当然，你也可以把事件过滤器安装到QApplication上面，这样就可以过滤所有的事件，已获得更大的控制权。不过，这样做的后果就是会降低事件分发的效率。

　　如果一个组件安装了多个过滤器，则最后一个安装的会最先调用，类似于堆栈的行为。

　　注意，如果你在事件过滤器中delete了某个接收组件，务必将返回值设为true。否则，Qt还是会将事件分发给这个接收组件，从而导致程序崩溃。

　　事件过滤器和被安装的组件必须在同一线程，否则，过滤器不起作用。另外，如果在install之后，这两个组件到了不同的线程，那么，只有等到二者重新回到同一线程的时候过滤器才会有效。

　　事件的调用最终都会调用QCoreApplication的notify()函数，因此，最大的控制权实际上是重写QCoreApplication的notify()函数。由此可以看出，Qt的事件处理实际上是分层五个层次：重定义事件处理函数（比如keyPressEvent），重定义event函数（QObject就有event()函数），为单个组件安装事件过滤器（QObject就有installEventFilter），为QApplication安装事件过滤器（继承自QObject，但所有事件会先发给它），重定义QCoreApplication的notify函数(写明谁来接收哪个事件)。这几个层次的控制权是逐层增大的。

/*****************************************************

事件过滤器eventFilter的使用
如果不提升控件，可以在控件的父对象中为控件安装事件过滤器，从而在父对象中处理子控件的事件；

在父对象源文件中：

//为控件安装事件过滤器
ui.pushButton->installEventFilter(this);
ui.pushButton_2->installEventFilter(this);

bool QtTest::eventFilter(QObject *w, QEvent *event)
{
    QMouseEvent *ev = static_cast<QMouseEvent *>(event);    //事件类型转换
    if (ev->type() == QEvent::MouseButtonPress)                //事件类型
    {
        if(ev->button() == Qt::LeftButton)                    //鼠标按键
        {
            QString a = w->objectName();
        }
        
        return true;
    }

    QWidget::eventFilter(watched, event);
}