4、事件冒泡机制：事件的传递路径、LV_EVENT_PREPROCESS与LV_EVENT_POSTPROCESS的区别、如何阻止冒泡。
好，咱们来聊聊事件冒泡。这个概念，说白了就是事件在对象树里“向上传递”的过程。你想想看，你点击了一个按钮，这个点击事件不光按钮自己知道，它的父容器、父容器的父容器……理论上都能感知到。这就是冒泡。
我在做智能家居面板项目时，就遇到过这么个坑。一个复杂的仪表盘，上面叠了好几层控件。点击某个子控件时，父容器也响应了，结果触发了两次刷新。当时排查了半天，最后发现就是事件冒泡没处理好。所以，理解透这个机制，能帮你省下不少调试时间。
事件的传递路径
LVGL 的事件传递，不是简单的一步到位。它走的是“先捕获，再冒泡”的路径。具体来说，分三个阶段：
- 捕获阶段（Capture Phase）：事件从最顶层的对象（比如屏幕），一路向下传递到目标对象。这个阶段，只有注册了
LV_EVENT_PREPROCESS的监听器才能收到。 - 目标阶段（Target Phase）：事件到达目标对象本身。你平时注册的
LV_EVENT_CLICKED、LV_EVENT_PRESSED等，都是在这个阶段触发的。 - 冒泡阶段（Bubble Phase）：事件从目标对象，再一路向上传递回顶层对象。这个阶段，注册了
LV_EVENT_POSTPROCESS的监听器会收到通知。
我习惯把这个过程想象成“扔石头到水里”。石头落水点是目标，涟漪向外扩散就是冒泡。而捕获阶段，就像是提前在水面下放好网，等着石头落下来。
LV_EVENT_PREPROCESS 与 LV_EVENT_POSTPROCESS 的区别
这两个事件类型，是控制冒泡行为的关键。很多人容易搞混，我帮你理清楚。
| 特性 | LV_EVENT_PREPROCESS | LV_EVENT_POSTPROCESS |
|---|---|---|
| 触发时机 | 事件到达目标对象 之前（捕获阶段） | 事件离开目标对象 之后（冒泡阶段） |
| 传递方向 | 从顶层向目标对象传递 | 从目标对象向顶层传递 |
| 典型用途 | 全局拦截、预处理、修改事件数据 | 后处理、统计、清理工作 |
| 能否阻止冒泡 | 可以，在回调中调用 lv_event_stop_bubbling |
可以，但此时事件已经冒泡到当前对象 |
举个例子你就明白了。假设你有一个屏幕（screen），上面有一个容器（cont），容器里有一个按钮（btn）。
- 如果你在 屏幕 上注册了
LV_EVENT_PREPROCESS，那么点击按钮时，屏幕会 最先 收到通知，然后事件才传给容器，最后传给按钮。 - 如果你在 屏幕 上注册了
LV_EVENT_POSTPROCESS，那么点击按钮时，按钮先处理，然后容器处理，最后屏幕才收到通知。
我个人习惯用 LV_EVENT_PREPROCESS 来做“全局拦截器”。比如，我想让整个界面在某个状态下禁止点击，直接在屏幕的 PREPROCESS 回调里判断一下，然后阻止冒泡，所有子控件就都点不了了。省事！
核心区别一句话总结：PREPROCESS 是“事件还没到，我先截胡”；POSTPROCESS 是“事件处理完了，我来收尾”。
如何阻止冒泡
阻止冒泡，就是不让事件继续向上传递。LVGL 提供了专门的 API：lv_event_stop_bubbling(event)。
调用这个函数后，当前对象处理完事件，事件就不会再传给它的父对象了。注意，它不会阻止当前对象自身的处理，只是切断向上传递的路径。
我曾经在一个嵌套列表的项目里用过这个。列表项里有个删除按钮，点击删除按钮时，我希望只执行删除操作，而不触发列表项的点击事件（比如跳转详情页）。解决办法就是在删除按钮的事件回调里，调用 lv_event_stop_bubbling。
看代码：
static void delete_btn_event_cb(lv_event_t * e) {
lv_event_code_t code = lv_event_get_code(e);
if (code == LV_EVENT_CLICKED) {
// 执行删除逻辑
lv_obj_t * btn = lv_event_get_target(e);
lv_obj_t * list_item = lv_obj_get_parent(btn);
lv_obj_del(list_item);
// 阻止事件冒泡，父容器不会收到 CLICKED 事件
lv_event_stop_bubbling(e);
}
}
// 创建删除按钮时注册回调
lv_obj_add_event_cb(delete_btn, delete_btn_event_cb, LV_EVENT_CLICKED, NULL);
注意：lv_event_stop_bubbling 只对当前事件有效。如果你在 PREPROCESS 回调里调用它，那么事件根本不会到达目标对象。如果你在 POSTPROCESS 回调里调用它，那么事件不会再继续向上冒泡，但已经处理过的父对象不会受影响。
还有一个细节：阻止冒泡不会影响同级的其他对象。比如，你阻止了按钮 A 的冒泡，按钮 B 的事件依然会正常向上传递。它们互不干扰。
小技巧：调试冒泡问题时，我习惯在每个对象的回调里加个 LV_LOG_USER 打印一下对象名和事件码。这样一眼就能看出事件传递到了哪一层，有没有被拦截。比如：
LV_LOG_USER("Event %d received by %s", code, lv_obj_get_user_data(obj));嗯，关于事件冒泡，核心就是这些。记住传递路径、用好 PREPROCESS 和 POSTPROCESS、关键时刻调用 lv_event_stop_bubbling。掌握了这些，你就能精准控制事件在 UI 树中的流动，避免很多莫名其妙的 bug。