Qt源码解析 索引

在Qt中，事件是由抽象类QEvent派生而来的对象，它表示应用程序内部发生的事情或应用程序需要知道的外部活动的结果。QObject子类的任何实例都可以接收和处理事件，但它们与小部件特别相关。本文档描述了在典型应用程序中如何交付和处理事件。

1、如何传递事件

当一个事件发生时，Qt 通过构造一个适当的QEvent子类的实例来创建一个事件对象来表示它，并通过调用它的event()函数将它传递给一个特定的QObject实例（或其子类之一） 。

该函数不处理事件本身；根据传递的事件类型，它为该特定类型的事件调用事件处理程序，并根据事件是被接受还是被忽略来发送响应。

一些事件，例如QMouseEvent和QKeyEvent，来自窗口系统；一些，例如QTimerEvent，来自其他来源；有些来自应用程序本身。

2、事件类型

大多数事件类型都有特殊的类，特别是QResizeEvent、QPaintEvent、QMouseEvent、QKeyEvent和QCloseEvent。每个类都是QEvent的子类，并添加特定于事件的函数。例如，QResizeEvent添加size()和oldSize()以使小部件能够发现它们的尺寸是如何更改的。

有些类支持一种以上的实际事件类型。QMouseEvent支持鼠标按键按下、双击、移动和其他相关操作。

每个事件都有一个关联的类型，定义在QEvent:: type中，它可以用作运行时类型信息的方便来源，以便快速确定给定事件对象是由哪个子类构造的。

由于程序需要以多种复杂的方式进行响应，Qt的事件交付机制非常灵活。QCoreApplication::notify()的文档简明地讲述了整个故事;Qt季刊的另一篇文章《Another Look at Events》对它进行了不那么简洁的重复。这里我们将对95%的应用进行足够的解释。

3、事件处理

传递事件的正常方式是调用虚函数。例如，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);
    }
}

如果你想替换基类的函数，你必须自己实现所有的东西。但是，如果您只想扩展基类的功能，那么您可以实现您想要的，并调用基类来获得您不想处理的任何情况的默认行为。

有时候，没有这样一个特定于事件的函数，或者特定于事件的函数是不够的。最常见的例子是按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) {
            // special tab handling here
            return true;
        }
    } else if (event->type() == MyCustomEventType) {
        MyCustomEvent *myEvent = static_cast<MyCustomEvent *>(event);
        // custom event handling here
        return true;
    }
​
    return QWidget::event(event);
}

注意，QWidget::event()仍然为所有未处理的情况调用，并且返回值指示是否处理了事件;true值防止事件被发送到其他对象。

4、事件过滤

有时，对象需要查看(可能还需要截取)交付给另一个对象的事件。例如，对话框通常想要过滤一些小部件的按键;例如，修改 Return-key 处理。

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) {
            // Special tab handling
            return true;
        } else
            return false;
    }
    return false;
}

上面的代码显示了拦截发送到特定目标小部件的Tab键按下事件的另一种方法。在这种情况下，过滤器处理相关事件并返回true以停止进一步处理它们。所有其他事件都被忽略，过滤器返回false，允许它们通过安装在目标小部件上的任何其他事件过滤器被发送到目标小部件。

通过在QApplication或QCoreApplication对象上安装一个事件过滤器，也可以过滤整个应用程序的所有事件。此类全局事件过滤器在特定于对象的过滤器之前调用。这是非常强大的，但它也减慢了整个应用程序中每个单个事件的事件交付;通常应该使用讨论过的其他技术。

5、发送事件

许多应用程序希望创建和发送自己的事件。你可以用和Qt自己的事件循环一样的方式发送事件，构造合适的事件对象，然后用QCoreApplication::sendEvent()和QCoreApplication::postEvent()发送它们。

sendEvent()立即处理事件。当它返回时，事件过滤器和/或对象本身已经处理了事件。对于许多事件类，都有一个名为isAccepted()的函数，它告诉您事件是被调用的最后一个处理程序接受还是拒绝。

postEvent()将事件发送到队列中，以便稍后调度。下一次Qt的主事件循环运行时，它将分派所有已发布的事件，并进行一些优化。例如，如果有多个resize事件，则将它们压缩为一个。这同样适用于绘制事件:QWidget::update()调用postEvent()，它消除了闪烁，并通过避免多次重绘来提高速度。

postEvent()也在对象初始化期间使用，因为发布的事件通常会在对象初始化完成后很快被分派。在实现小部件时，重要的是要意识到，事件可以在其生命周期的早期交付，因此，在其构造函数中，务必在早期初始化成员变量，以免它有任何机会接收事件。

要创建自定义类型的事件，您需要定义一个事件编号，它必须大于QEvent::User，并且您可能需要子类QEvent来传递关于您的自定义事件的特定信息。有关更多细节，请参阅QEvent文档。

标签：Qt,QEvent,源码,事件,过滤器,解析,event,函数
来源： https://blog.csdn.net/xinqingwuji/article/details/122588986