在 Qt 框架中，事件驱动是核心概念之一。通过灵活的事件系统，开发者可以实现用户输入处理、自定义交互逻辑以及复杂的事件传播机制。本文将详细讲解事件处理、自定义事件、鼠标和键盘事件处理，以及事件过滤与传播机制，辅以示例代码和实用场景，帮助你全面掌握 Qt 的事件系统。

一、事件处理和自定义事件

1.1 Qt 的事件模型概述

Qt 使用 事件对象（QEvent） 描述事件，所有事件对象派生自 QEvent 类。事件模型包括以下核心部分：

1. 事件对象（QEvent）：描述事件类型及相关信息。
2. 事件分派：通过 Qt 的 QCoreApplication::notify 方法分发事件。
3. 事件处理：通过重写 QObject::event 或专用事件处理方法处理事件。

1.2 自定义事件

如果默认事件无法满足需求，可以创建自定义事件。

自定义事件的实现

1. 定义自定义事件类：

#include <QEvent>

class MyCustomEvent : public QEvent {
public:
    static const QEvent::Type EventType;

    MyCustomEvent(const QString &message)
        : QEvent(EventType), m_message(message) {}

    QString message() const { return m_message; }

private:
    QString m_message;
};

// 注册事件类型
const QEvent::Type MyCustomEvent::EventType = static_cast<QEvent::Type>(QEvent::registerEventType());

2. 发送自定义事件：

使用 QCoreApplication::postEvent 或 QCoreApplication::sendEvent 发送事件。

#include <QCoreApplication>
#include "MyCustomEvent.h"

void sendCustomEvent(QObject *target) {
    MyCustomEvent *event = new MyCustomEvent("Hello, Custom Event!");
    QCoreApplication::postEvent(target, event);
}

3. 处理自定义事件：

重写目标对象的 event 方法：

#include <QObject>
#include <QDebug>
#include "MyCustomEvent.h"

class MyObject : public QObject {
protected:
    bool event(QEvent *event) override {
        if (event->type() == MyCustomEvent::EventType) {
            auto customEvent = static_cast<MyCustomEvent *>(event);
            qDebug() << "Custom event received with message:" << customEvent->message();
            return true; // 表示事件已处理
        }
        return QObject::event(event); // 默认处理
    }
};

二、鼠标和键盘事件处理

2.1 鼠标事件

Qt 提供了丰富的鼠标事件（QMouseEvent）支持，可以通过重写组件的 mousePressEvent、mouseMoveEvent 等方法处理。

示例：实现简单的鼠标拖拽

#include <QWidget>
#include <QMouseEvent>
#include <QPainter>

class DraggableWidget : public QWidget {
public:
    DraggableWidget(QWidget *parent = nullptr)
        : QWidget(parent), isDragging(false) {
        setFixedSize(400, 300);
    }

protected:
    void mousePressEvent(QMouseEvent *event) override {
        if (event->button() == Qt::LeftButton) {
            isDragging = true;
            lastPosition = event->pos();
        }
    }

    void mouseMoveEvent(QMouseEvent *event) override {
        if (isDragging) {
            move(pos() + event->pos() - lastPosition);
        }
    }

    void mouseReleaseEvent(QMouseEvent *event) override {
        if (event->button() == Qt::LeftButton) {
            isDragging = false;
        }
    }

private:
    bool isDragging;
    QPoint lastPosition;
};

运行效果：窗口可以通过拖拽鼠标移动。

2.2 键盘事件

键盘事件通过 QKeyEvent 类处理，通常重写 keyPressEvent 和 keyReleaseEvent 方法。

示例：实现键盘快捷键控制

#include <QWidget>
#include <QKeyEvent>
#include <QDebug>

class KeyEventWidget : public QWidget {
public:
    KeyEventWidget(QWidget *parent = nullptr) : QWidget(parent) {
        setFixedSize(300, 200);
    }

protected:
    void keyPressEvent(QKeyEvent *event) override {
        if (event->key() == Qt::Key_Space) {
            qDebug() << "Space key pressed!";
        } else if (event->key() == Qt::Key_Escape) {
            qDebug() << "Escape key pressed! Exiting...";
            close();
        }
    }
};

运行效果：按空格键输出提示，按 Esc 键关闭窗口。

三、Qt 事件过滤和事件传播机制

3.1 事件过滤

事件过滤器通过 QObject::installEventFilter 和 eventFilter 方法拦截并处理目标对象的事件。

示例：拦截按钮点击事件

#include <QWidget>
#include <QPushButton>
#include <QEvent>
#include <QDebug>

class EventFilterWidget : public QWidget {
public:
    EventFilterWidget(QWidget *parent = nullptr) : QWidget(parent) {
        auto button = new QPushButton("Click Me", this);
        button->setGeometry(100, 100, 100, 30);
        button->installEventFilter(this); // 安装事件过滤器
    }

protected:
    bool eventFilter(QObject *obj, QEvent *event) override {
        if (event->type() == QEvent::MouseButtonPress) {
            qDebug() << "Button clicked, event filtered!";
            return true; // 拦截事件
        }
        return QWidget::eventFilter(obj, event); // 默认处理
    }
};

运行效果：按钮点击事件被拦截，原有点击行为不会执行。

3.2 事件传播机制

事件从父对象传递到子对象时，可以通过事件传播机制拦截或改变行为。事件的传播路径依赖于对象的层次结构。

示例：父窗口处理子控件事件

#include <QWidget>
#include <QPushButton>
#include <QEvent>
#include <QDebug>

class ParentWidget : public QWidget {
public:
    ParentWidget(QWidget *parent = nullptr) : QWidget(parent) {
        setFixedSize(300, 200);

        auto button = new QPushButton("Child Button", this);
        button->setGeometry(50, 50, 100, 30);
    }

protected:
    bool event(QEvent *event) override {
        if (event->type() == QEvent::MouseButtonPress) {
            qDebug() << "Mouse press event handled by parent!";
            return true;
        }
        return QWidget::event(event);
    }
};

运行效果：鼠标点击事件被父控件拦截。

总结

Qt 的事件系统是开发中非常重要的一部分，其灵活性和强大功能让我们能够轻松处理用户交互逻辑和复杂事件场景。通过本文，我们详细了解了以下关键点：

1. 事件处理与自定义事件：
   • 使用 QEvent 和重写 event 方法自定义事件处理逻辑。
   • 实现和发送自定义事件。
2. 鼠标与键盘事件：
   • 鼠标拖拽、键盘快捷键等常见场景实现。
3. 事件过滤与传播机制：
   • 使用 eventFilter 拦截事件。
   • 掌握父子对象间的事件传播关系。

通过这些知识的掌握，你将能够轻松实现复杂的用户交互逻辑，为你的 Qt 项目提供更流畅、更丰富的用户体验！