Qt事件处理机制，就像取快递_qt 冒泡事件-优快云博客

本文链接：https://blog.youkuaiyun.com/treehan/article/details/147279813

一、Qt事件处理机制

1. 事件从哪里来？

想象你开了一个快递站（Qt应用程序），每天会有各种快递（事件）送过来，比如：

鼠标快递（点击、移动）
键盘快递（按键按下、释放）
窗口快递（窗口大小变化、关闭请求）
定时器快递（定时触发的任务）

这些快递都是由 Qt系统（快递总公司） 统一派发到你的快递站的。

2. 事件怎么被处理？

你的快递站（QObject/QWidget）处理快递的流程是这样的：

(1) 前台签收：`event()` 函数

所有快递先送到 前台（event()函数），前台会拆开包裹，看看是什么类型的快递（e->type()）。//其中，参数e是事件对象，通过e->type()就可以得到事件的具体类型。
前台根据快递类型，决定是：
- 自己处理（比如鼠标事件交给 mouseMoveEvent()，键盘事件交给 keyPressEvent()）
- 或者拒收（ignore()，让上级处理，比如父窗口）
- 或者签收（accept()，表示这个快递我处理了，别人不用管了）

(2) 具体部门处理

如果前台决定自己处理，就会把快递交给对应的 部门（具体事件处理函数）：

鼠标部 → mousePressEvent(), mouseMoveEvent()
键盘部 → keyPressEvent(), keyReleaseEvent()
绘画部 → paintEvent()（负责窗口绘制）
窗口管理部 → resizeEvent(), closeEvent()

每个部门都是 虚函数，你可以自己培训员工（重写这些函数），定制你的快递站服务！

3. 事件的传递链（冒泡机制）

如果某个部门说 “这个快递不归我管”（ignore()），快递就会退回到上一级（比如父窗口），直到有人处理或者被丢弃。

例子：

你点击了一个按钮，但按钮的 mousePressEvent() 说 ignore()，那么事件会传给按钮的父窗口（比如对话框），看看它要不要处理。

4. 你也可以拦截快递！

如果你重写 event() 函数，相当于 雇佣了一个超级前台，它可以：

拦截所有快递，先检查再决定是否分发（比如过滤某些事件）。
修改快递内容（比如改变事件类型或参数）。
直接拒收（return true 表示处理了，不再往下传）。

5. 实际例子

场景：你想让窗口在鼠标移动时打印坐标。
做法：不用管 event()，直接培训 鼠标部（重写 mouseMoveEvent()）：

void MyWidget::mouseMoveEvent(QMouseEvent *event) {
    qDebug() << "鼠标位置：" << event->pos();  // 打印坐标
    event->accept();  // 签收快递，表示处理了
}

总结：Qt事件处理就像快递站

Qt 概念	快递站比喻	关键点
`QEvent`	快递包裹	包含事件类型（鼠标、键盘等）
`event()`	前台总台	先接收所有事件，再分发给具体部门
`xxxEvent()`	具体部门（鼠标部、键盘部）	处理特定类型事件
`accept()`/`ignore()`	签收/拒收	决定事件是否继续传递
事件冒泡	快递退回上级	父窗口可能处理子窗口忽略的事件

这样是不是清楚多了？

二、Qt 典型事件处理函数

下面我们用「点外卖」 的场景来比喻 Qt 典型事件处理函数 的使用方法。

1. 先记住一个核心规则

Qt 的每个 事件处理函数（比如 mousePressEvent）就像一家餐厅的 「处理订单的部门」。
你（程序员）可以 「接管」 某个部门，自定义它的工作流程（重写函数）。
如果不接管，Qt 会用默认的方式处理（就像餐厅默认的流水线操作）。

2. 常用事件函数 & 实战例子

(1) 鼠标事件 → 处理「顾客点击」

函数：

mousePressEvent() → 鼠标按下（比如左键点击）
mouseReleaseEvent() → 鼠标释放
mouseMoveEvent() → 鼠标移动
wheelEvent() → 鼠标滚轮滚动

场景：

你想在点击窗口时，打印一句 “你点了我！”，并获取点击位置。

void MyWidget::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {  // 判断是否是左键
        qDebug() << "你点了我！位置：" << event->pos(); 
    }
    // 默认处理（比如按钮的高亮效果）
    QWidget::mousePressEvent(event);  
}

(2) 键盘事件 → 处理「键盘输入」

函数：

keyPressEvent() → 按键按下
keyReleaseEvent() → 按键释放

场景：

按下 Esc 键时关闭窗口。

代码：

void MyWidget::keyPressEvent(QKeyEvent *event) {
    if (event->key() == Qt::Key_Escape) {  // 判断是否是 Esc 键
        this->close();  // 关闭窗口
    } else {
        QWidget::keyPressEvent(event);  // 其他键交给默认处理
    }
}

(3) 绘制事件 → 自定义「窗口外观」

函数：

paintEvent() → 窗口需要绘制时触发（比如首次显示、窗口大小变化）

场景：

给窗口画一个渐变背景色。

代码：

void MyWidget::paintEvent(QPaintEvent *event) {
    QPainter painter(this);  // 创建画家，指定画在 this（当前窗口）上

    // 设置渐变（从左上角红色到右下角蓝色）
    QLinearGradient gradient(0, 0, width(), height());
    gradient.setColorAt(0, Qt::red);
    gradient.setColorAt(1, Qt::blue);

    painter.fillRect(rect(), gradient);  // 填充整个窗口
}

(4) 窗口事件 → 处理「窗口变化」

函数：

resizeEvent() → 窗口大小改变
closeEvent() → 窗口即将关闭（可以拦截关闭操作）

场景：

窗口调整大小时，打印新尺寸；关闭时弹窗确认。

代码：

// 窗口大小变化
void MyWidget::resizeEvent(QResizeEvent *event) {
    qDebug() << "新尺寸：" << event->size();
}

// 拦截关闭事件
void MyWidget::closeEvent(QCloseEvent *event) {
    QMessageBox::StandardButton reply;
    reply = QMessageBox::question(this, "确认", "真的要关闭吗？", 
                                QMessageBox::Yes | QMessageBox::No);
    if (reply == QMessageBox::Yes) {
        event->accept();  // 允许关闭
    } else {
        event->ignore();  // 阻止关闭
    }
}

(5) 定时器事件 → 处理「周期性任务」

函数：

timerEvent() → 定时器触发（需先调用 startTimer()）

场景：

每隔 1 秒打印一次 “时间到！”。

代码：

// 在构造函数里启动定时器（返回定时器ID）
MyWidget::MyWidget() {
    m_timerId = startTimer(1000);  // 1000ms = 1秒
}

// 定时器触发
void MyWidget::timerEvent(QTimerEvent *event) {
    if (event->timerId() == m_timerId) {  // 判断是否是我们的定时器
        qDebug() << "时间到！";
    }
}

3. 总结：事件处理就像餐厅接单

事件类型	比喻	关键函数	典型用途
鼠标事件	顾客点击屏幕	`mousePressEvent()`	点击按钮、拖拽元素
键盘事件	顾客按键盘	`keyPressEvent()`	快捷键、游戏控制
绘制事件	餐厅装修	`paintEvent()`	自定义界面（背景、图表）
窗口事件	餐厅调整大小或关门	`resizeEvent()`	响应窗口变化、拦截关闭
定时器事件	厨房定时检查菜品	`timerEvent()`	轮播动画、自动刷新数据