Qt事件系统详解

一、Qt事件系统概述

Qt事件系统是Qt框架中处理用户输入、窗口交互、定时器、异步操作等机制的核心。所有事件均继承自QEvent类，并通过事件循环（Event Loop）分发到目标对象。

事件系统基本概念

• 事件(Event)：描述应用程序内部或外部发生的动作（如鼠标点击、键盘输入等）
• 事件循环(Event Loop)：Qt应用程序的主循环，负责接收和分发事件
• 事件过滤器(Event Filter)：可以拦截和处理其他对象的事件的机制

事件类型

常见事件类型包括：

• 用户输入事件：QMouseEvent（鼠标）、QKeyEvent（键盘）等。
• 窗口事件：QResizeEvent（窗口大小变化）、QCloseEvent（关闭窗口）等。
• 定时器事件：QTimerEvent，由QObject::startTimer()触发。
• 自定义事件：通过继承QEvent实现，用于跨线程通信或特定逻辑。

二、事件处理流程

1. 事件生成
   事件由系统（如用户操作）或应用程序内部（如QTimer）产生，被封装为QEvent子类对象。

2. 事件分发
   事件通过QCoreApplication::sendEvent()或QCoreApplication::postEvent()发送到目标QObject。sendEvent同步处理，postEvent异步加入事件队列。

3. 事件过滤
   通过QObject::installEventFilter()可监控其他对象的事件，在eventFilter()方法中拦截或修改事件。

4. 事件处理
   目标对象通过重写QObject::event()或特定事件处理函数（如mousePressEvent()）响应事件。默认情况下，未处理的事件会传递给父对象。

示例代码

// 自定义事件类型
class CustomEvent : public QEvent {
public:
    static const QEvent::Type Type = static_cast<QEvent::Type>(1000);
    CustomEvent() : QEvent(Type) {}
};

// 事件处理对象
class MyObject : public QObject {
protected:
    bool event(QEvent *ev) override {
        if (ev->type() == CustomEvent::Type) {
            qDebug() << "CustomEvent received";
            return true;
        }
        return QObject::event(ev);
    }
};

// 发送自定义事件
MyObject obj;
QCoreApplication::postEvent(&obj, new CustomEvent());

三、事件处理方式

1. 重写事件处理器

class MyWidget : public QWidget {
protected:
    void mousePressEvent(QMouseEvent *event) override {
        if (event->button() == Qt::LeftButton) {
            qDebug() << "左键按下位置:" << event->pos();
        }
    }
    
    void keyPressEvent(QKeyEvent *event) override {
        if (event->key() == Qt::Key_Escape) {
            qDebug() << "ESC键被按下";
            close();
        }
    }
};

2. 安装事件过滤器

class FilterObject : public QObject {
protected:
    bool eventFilter(QObject *obj, QEvent *event) override {
        if (event->type() == QEvent::KeyPress) {
            QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
            qDebug() << "过滤到按键:" << keyEvent->key();
            returntrue; // 拦截事件
        }
        returnfalse; // 继续传递事件
    }
};

// 使用事件过滤器
MyWidget widget;
FilterObject filter;
widget.installEventFilter(&filter);

3. 发送自定义事件

// 定义自定义事件类型
const QEvent::Type MyEventType = static_cast<QEvent::Type>(QEvent::User + 1);

class MyEvent :public QEvent {
public:
    MyEvent(const QString &message) 
        : QEvent(MyEventType), m_message(message) {}
    QString message() const { return m_message; }
private:
    QString m_message;
};

// 发送自定义事件
QApplication::postEvent(receiver, new MyEvent("自定义消息"));

// 处理自定义事件
bool MyWidget::event(QEvent *event) {
    if (event->type() == MyEventType) {
        MyEvent *myEvent = static_cast<MyEvent*>(event);
        qDebug() << "收到自定义事件:" << myEvent->message();
        returntrue;
    }
    return QWidget::event(event);
}

四、事件与信号槽的区别

以下是Qt中事件（Event）与信号槽（Signal/Slot）机制的对比表格：

事件与信号槽的区别

关键代码示例

// 事件处理（继承QWidget）
void CustomWidget::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        qDebug() << "Left button pressed";
        event->accept();
    } else {
        event->ignore();
    }
}

// 信号槽连接
QObject::connect(button, &QPushButton::clicked, this, &MyClass::handleClick);

五、总结

Qt的事件系统提供了灵活而强大的机制来处理各种用户交互和系统事件。通过：

• 理解事件产生和派发流程
• 掌握各种事件处理方法
• 合理使用事件过滤器和自定义事件
• 了解事件传播机制

开发者可以创建响应迅速、交互丰富的GUI应用程序。事件系统与信号槽机制相辅相成，共同构成了Qt应用程序的基础通信框架。

六、实例展示

1、效果展示

2、源码

#include "mainwindow.h"
#include "ui_mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    connect(this->ui->pushButton,&QPushButton::clicked,this,
            []()
            {
                qDebug()<<"btn clicked!";
            });
    this->ui->pushButton->installEventFilter(this);
}

MainWindow::~MainWindow()
{
    delete ui;
}

bool MainWindow::eventFilter(QObject *object, QEvent *event)
{
    if(object == this->ui->pushButton)
    {
        qDebug()<<event->type();
    }
    return QMainWindow::eventFilter(object, event);
}