Qt：事件系统

向右看齐 2022-11-17 05:23 193阅读 0赞

在Qt中，事件是从抽象`QEvent`类派生的对象，它表示发生在应用程序内部或应用程序需要了解的外部活动的结果。事件可以由`QObject`子类的任何实例接收和处理，它们与小部件尤其相关。本文档介绍了在典型应用程序中如何传递和处理事件

# 事件如何传递 #

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

此功能不处理事件本身；根据所传递事件的类型，它为该特定类型的事件调用**事件处理程序**，并根据该事件被接收还是被忽略发送响应。

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

# 事件类型 #

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

一些类支持不止一种实际事件类型。QMouseEvent支持鼠标按键按下，双击，移动和其他相关操作。

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

由于程序需要以各种复杂的方式做出反应，因此Qt的事件传递机制非常灵活。[QCoreApplication::notify()][QCoreApplication_notify]的文档简明地讲述了整个机制;Qt的季刊《[另一种看待事件][Link 1]》(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);
        }
    }

如果要替换基类的功能，则必须自己实现所有功能。但是，如果只想扩展基类的功能，则可以实现所需的功能，并调用基类以获取您不想处理的任何情况下的默认行为。

有时，没有此类特定于事件的功能，或者特定于事件的功能还不够。最常见的示例涉及Tab键的按下。通常，QWidget会拦截这些以移动键盘焦点，但是一些小部件需要自己使用Tab键。

这些对象可以重新实现通用事件处理程序QObject::event()，并在通常处理之前或之后进行事件处理，或者它们可以完全替换函数。一个既解释Tab又具有特定于应用程序的自定义事件的非常不寻常的小部件可能包含以下event()函数:

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值会阻止事件上的其他对象被发送。

# 事件过滤器 #

有时，一个对象需要查看并可能拦截交付给另一个对象的事件。例如，对话框通常希望过滤一些小部件的按键;例如，修改返回键处理。

`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对象上安装事件过滤器，还可以过滤整个应用程序的所有事件。此类全局事件过滤器在特定于对象的过滤器之前被调用。这是非常强大的功能，但是它也会减慢整个应用程序中每个事件的事件传递速度。通常应使用所讨论的其他技术来代替。

# 发送事件 #

许多应用程序都希望创建和发送它们自己的事件。通过构造合适的事件对象并使用`QCoreApplication::sendEvent()`和`QCoreApplication::postEvent()`发送事件，你可以用与Qt自己的事件循环完全相同的方式发送事件。

*  `sendEvent()`立即处理事件。当它返回时，事件过滤器和/或对象本身已经处理了事件。对于许多事件类，都有一个名为`isAccepted()`的函数，它告诉您事件是被最后调用的处理程序接受还是拒绝。  
    \-`postEvent()`将事件发送到队列中以供以后调度。下一次Qt的主事件循环运行时，它会分发所有发布的事件，并进行一些优化。例如，如果有几个调整大小事件，则将它们压缩为一个。同样的情况也适用于绘制事件:`QWidget::update()`调用`postEvent()`，它通过避免多次重绘来消除闪烁并提高速度。

\-`postEvent()`也会在对象初始化期间使用，因为在对象初始化完成后，post的事件通常会很快被分派。在实现小部件时，重要的是要认识到事件可以在其生命周期的早期交付，因此在其构造函数中，确保尽早初始化成员变量，在它可能接收到事件之前。

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

[QCoreApplication_notify]: https://doc.qt.io/qt-6/qcoreapplication.html#notify
[Link 1]: http://doc.qt.io/archives/qq/qq11-events.html
[QEvent]: https://doc.qt.io/qt-6/qevent.html