Qt事件系统:事件过滤器和事件的发送

Qt提供了事件过滤器来实现在一个部件中监控其他多个部件的事件。事件过滤器与其他部件不同，它不是一个类，只是由两个函数组成的一种操作，用来完成一个部件对其他部件的事件的监视。这两个函数分别是 installEventFilter() 和 eventFilter()，都是QObject类中的函数。下面通过具体的例子来讲解。

新建Qt Gui应用，将项目名称更改为myEventFilter，基类选择QWidget，类名保持Widget不变。完成后在设计模式中向界面上拖入一个QTextEdit和一个QSpinBox。在widget.h文件中添加函数声明：

//事件过滤器
bool eventFilter(QObject *obj, QEvent *event);

在构造函数中添加代码：

//为textEdit和spinBox在本窗口上安装事件过滤器
ui->textEdit->installEventFilter(this);
ui->spinBox->installEventFilter(this);

要对一个部件使用事件过滤器，那么就要先使用installEventFilter() 函数为该部件安装事件过滤器，这个函数的参数表明了监视对象。比如这里就是为textEdit部件和spinBox部件安装了事件过滤器，其参数this表明要在本部件即Widget中监视textEdit和spinBox的事件。这样，就需要重新实现Widget类的eventFilter()函数，在其中截获并处理两个子部件的事件。

//事件过滤器
bool Widget::eventFilter(QObject *obj, QEvent *event)
{
    if (obj == ui->textEdit)
    {
        if (event->type() == QEvent::Wheel)
        {
            // 将event强制转换为发生的事件的类型
            QWheelEvent *wheelEvent = static_cast<QWheelEvent*>(event);
            // 缩放textEdit
            if (wheelEvent->delta() > 0)
                ui->textEdit->zoomIn();
            else
                ui->textEdit->zoomOut();
        }
    }
    else if (obj == ui->spinBox)
    {
        if (event->type() == QEvent::KeyPress)
        {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            if (keyEvent->key() == Qt::Key_Space)
                ui->spinBox->setValue(0);
        }
    }

    return QWidget::eventFilter(obj, event);
}

在这个事件过滤器中先判断部件的类型，然后再判断事件的类型，如果是我们需要的事件就将其进行强制类型转换，然后进行相应的处理。这里需要说明，如果要对一个 特定的事件进行处理，而且不希望它在后面的传递过程中再被处理，那么就返回true, 否则返回false。这个函数中实现了在textEdit部件中使用滚轮进行内容的放大或缩小，在spinBox部件中使用空格来使数值设置为0。

可以看到，使用事件过滤器可以很容易地处理多个部件的多个事件，如果不使用它，我们就得分别子类化各个部件，然后重新实现它们对应的各个事件处理函数，那样就会很麻烦了。

Qt也提供发送一个事件的功能，由 QCoreApplication 类的 sendEvent() 函数或者 postEvent() 函数来实现。这两个函数的主要区别是：sendEvent() 会立即处理给定的事件，而 postEvem() 则会将事件放到等待调度队列中，当下一次Qt的主事件循环运行时才会处理它。

这两个函数还有其他一些区别，比如 sendEvent() 中的QEvent对象参数在事件发送完成后无法自动删除，所以需要在栈上创建QEvent对象；而 postEvent() 中的QEvent对象参数必须在堆上进行创建（例如使用new),当事件被发送后事件队列会自动删除它。

下面在widget.cpp文件中的构造函数里添加代码来向spinBox部件发送一个向上方向键被按下的事件：

//向spinBox发送一个向上按钮触发键盘事件，所以可以看到最开始spinBox的值不是0，而是1
QKeyEvent myEvent(QEvent::KeyPress, Qt::Key_Up, Qt::NoModifier);
qApp->sendEvent(ui->spinBox, &myEvent); //qApp是Application对象的全局指针

这里使用了 sendEvent() 函数，其中 QKeyEvent 类对象是在栈上创建的。其中的qApp是Q Application对象的全局指针，每一个应用程序中只能使用一个QApplica-tion 对象，这里等价于使用 QApplication:: sendEvent()。 现在运行程序可以发现 spinBox部件中初始值变为了1，这说明已经在这个部件上按下了向上方向键。

滚轮放大前后的对比图如下：

Qt开发必备技术栈学习路线和资料