Qt事件处理和传递流程

事件系统的概述

事件的类型

Qt 支持多种事件类型，每种类型代表不同的用户交互或系统事件。常见的事件类型包括：

• 输入事件：如鼠标事件（QMouseEvent）、键盘事件（QKeyEvent）。
• 窗口事件：如窗口大小变化事件（QResizeEvent）、窗口关闭事件（QCloseEvent）。
• 定时器事件：如定时器超时事件（QTimerEvent）。
• 绘图事件：如绘图事件（QPaintEvent）。
• 自定义事件：可以通过继承 QEvent 类创建自定义事件。

QEvent 类

QEvent 类是所有事件的基类。每个事件类型都继承自 QEvent 并扩展了特定的功能。常见的事件类型及其子类有：

• QMouseEvent：处理鼠标相关事件，如鼠标点击、移动、释放等。
• QKeyEvent：处理键盘输入事件，如按键按下和释放。
• QResizeEvent：处理窗口大小变化事件。
• QCloseEvent：处理窗口关闭事件。
• QPaintEvent：处理绘图事件。
• QTimerEvent：处理定时器超时事件。

自定义事件

可以创建自定义事件类型，通过继承 QEvent 类并定义自己的数据和处理逻辑。

class MyCustomEvent : public QEvent {
public:
static const QEvent::Type MyEventType = static_cast<QEvent::Type>(QEvent::User + 1);

MyCustomEvent() : QEvent(MyEventType) {}

// 自定义数据和方法
QString message;
};

事件处理机制

事件处理函数（event handlers）

每个 QWidget 子类都有一个 event() 方法，它处理所有传递给该对象的事件。Qt 提供了特定类型事件的处理函数，例如 mousePressEvent()、keyPressEvent() 等。这些特定的处理函数通常在 event() 函数中被调用。

void MyWidget::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        // 处理鼠标左键按下事件
    }
}

信号与槽机制

信号与槽机制是 Qt 的核心特性之一，它提供了一种对象之间通信的方式，非常适合用于实现观察者模式。

信号

信号是由对象在特定情况下发出的消息。例如，当按钮被点击时，QPushButton 对象会发出 clicked() 信号。

槽

槽是一个可以被信号连接的函数。当信号被发出时，所有连接到该信号的槽都会被调用。槽可以是任意的成员函数、静态函数，甚至是 lambda 表达式。

连接信号与槽

使用 QObject::connect() 方法将信号连接到槽：

connect(button, &QPushButton::clicked, this, &MyWidget::onButtonClicked);

void MyWidget::onButtonClicked() {
    // 处理按钮点击事件
}

事件传递和处理过程

事件循环

事件循环是 Qt 应用程序的核心部分。它负责调度和分发事件，使得应用程序能够响应用户输入和其他事件。

Qt 应用程序的事件循环由 QCoreApplication::exec() 方法启动。该方法进入一个无限循环，等待事件发生，并将其分发到合适的处理函数。

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    MyWidget w;
    w.show();
    return app.exec();
}

事件在父子窗口之间的传递遵循对象的层次结构。以下是详细的过程：

事件生成：

• 事件（如鼠标点击、键盘输入等）由操作系统或 Qt 自身生成，并加入事件队列。

事件分发：

• QCoreApplication::notify 将事件分发给目标对象（子窗口或父窗口）。

事件过滤器：

• 在 event() 函数中，事件首先传递给事件过滤器。如果事件过滤器处理了事件，则事件传递过程结束。

子窗口处理事件：

• 如果事件首先传递给子窗口，子窗口的 event() 函数会尝试处理该事件。如果子窗口处理了该事件，则事件传递过程结束。

传递给父窗口：

• 如果子窗口未处理该事件，事件会传递给父窗口。父窗口的 event() 函数会尝试处理该事件，或者进一步传递给父窗口的事件过滤器。

逐层传递：

• 这一过程会逐层向上，直到事件被处理或到达顶层窗口（即没有父窗口的窗口）。

notify 函数

notify 函数是事件传递的核心，它在事件循环中被调用，用于将事件分发到相应的对象。

bool QCoreApplication::notify(QObject *receiver, QEvent *event) {
    if (receiver == nullptr) {
        qWarning("QCoreApplication::notify: Unexpected null receiver");
        return false;
    }

    // Before delivering the event, we pass it through the event filters
    if (receiver->isWidgetType() && static_cast<QWidget*>(receiver)->testAttribute(Qt::WA_SetCursor)) {
        // Special handling for widgets with set cursor attribute
    }

    // Call the event filters
    if (receiver->d_func()->sendThroughObjectEventFilters(receiver, event)) {
        return true;
    }

    // Deliver the event
    return receiver->event(event);
}

在 notify 函数中，事件传递过程如下：

事件过滤器：

• 首先，事件被传递给目标对象的事件过滤器。
• 通过 sendThroughObjectEventFilters 方法调用所有安装在目标对象上的事件过滤器。
• 如果任何一个事件过滤器处理了事件并返回 true，事件传递过程就会终止，notify 返回 true。

事件分发：

• 如果事件过滤器没有处理事件，则调用目标对象的 event 函数。
• 具体的事件处理函数（如 mousePressEvent、keyPressEvent 等）在 event 函数内部被调用。

事件过滤器filter

事件过滤器允许对象在事件到达其目标对象之前对其进行拦截和处理。事件传递过程中，事件过滤器是一个重要的环节。通过在父窗口上安装事件过滤器，可以拦截和处理传递给子窗口的事件。

class MyFilter : public QObject {
Q_OBJECT
protected:
bool eventFilter(QObject *obj, QEvent *event) override {
    if (event->type() == QEvent::MouseButtonPress) {
        // 处理鼠标按下事件
        qDebug() << "Mouse button pressed in object:" << obj;
        return true;  // 事件已被处理，不再传递
    }
    return QObject::eventFilter(obj, event);  // 传递给默认处理程序
}
};

// 在父窗口上安装事件过滤器
MyFilter *filter = new MyFilter;
parentWidget->installEventFilter(filter);

event() 函数处理

每个 QWidget 都有一个 event() 函数，它处理传递给这个窗口部件的所有事件。这个函数会根据事件的类型调用相应的事件处理函数。

bool QWidget::event(QEvent *event) {
    switch (event->type()) {
        case QEvent::MouseButtonPress:
            mousePressEvent(static_cast<QMouseEvent *>(event));
            break;
        case QEvent::KeyPress:
            keyPressEvent(static_cast<QKeyEvent *>(event));
            break;
        // 处理其他事件类型
        default:
            return QObject::event(event);
    }
    return true;
}

事件处理函数Handler

事件处理函数是用户能够控制的的，最底层的事件处理流程，Qt默认实现了很多事件处理函数，用户可以在子类重写这些事件处理函数。

处理鼠标事件

通过重载 mousePressEvent 方法处理鼠标点击事件。

void MyWidget::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        qDebug() << "Left mouse button pressed at" << event->pos();
    }
}

处理键盘事件

通过重载 keyPressEvent 方法处理键盘按键事件。

void MyWidget::keyPressEvent(QKeyEvent *event) {
    if (event->key() == Qt::Key_Escape) {
        qDebug() << "Escape key pressed";
        close();  // 关闭窗口
    }
}

总结

在 Qt 中，事件在父子窗口之间的传递和处理过程遵循对象的层次结构，通过 notify 函数、事件过滤器和 event() 函数进行管理。事件可以从子窗口传递到父窗口，也可以在父窗口中拦截和处理，确保事件能够在适当的地方被正确处理。