3. LVGL 事件处理机制：事件监听器、事件回调函数、事件冒泡与捕获

事件处理，说白了就是让屏幕上的按钮、滑块、列表这些东西，能听懂用户的操作。你点一下、滑一下、长按一下，系统得知道该干什么。LVGL 的事件机制设计得挺巧妙，既有嵌入式系统需要的轻量，又有类似 Web 前端的事件流概念。我个人觉得，搞懂这套机制，是写好交互逻辑的关键一步。

3.1 事件监听器：谁在听？

在 LVGL 里，每个对象（lv_obj_t）都可以挂载事件监听器。你可以把它理解成「给这个控件装了个耳朵」。监听器本身不干活，它只负责「听到」事件，然后转交给回调函数去处理。

核心概念：事件监听器是对象的一个属性，一个对象可以挂多个监听器，每个监听器对应一个回调函数。监听器可以监听所有事件类型，也可以只监听特定类型。

注册监听器的 API 很简单：

lv_obj_add_event_cb(obj, my_event_callback, LV_EVENT_CLICKED, user_data);

这里四个参数：

obj：你要监听谁？
my_event_callback：事件来了谁处理？
LV_EVENT_CLICKED：监听哪种事件？
user_data：你想顺便带点啥私货？

我在项目里经常用 user_data 传一个结构体指针，里面放着这个按钮对应的业务数据。比如一个菜单列表，每个按钮的 user_data 指向不同的菜单项 ID，回调里直接取出来用，省得写一堆 if-else。

3.2 事件回调函数：来了怎么处理？

回调函数的签名是固定的：

static void my_event_callback(lv_event_t * e)
{
    lv_obj_t * target = lv_event_get_target(e);
    lv_obj_t * current = lv_event_get_current_target(e);
    lv_event_code_t code = lv_event_get_code(e);
    
    switch(code) {
        case LV_EVENT_CLICKED:
            // 处理点击
            break;
        case LV_EVENT_VALUE_CHANGED:
            // 处理值变化
            break;
        default:
            break;
    }
}

这里有两个容易搞混的概念：target 和 current_target。target 是事件最初发生的对象，current_target 是当前正在处理事件的对象。在事件冒泡时，这两个值不一样。嗯，这个我们马上会讲到。

我的习惯：回调函数里尽量只做逻辑判断和业务分发，不要在里面做耗时操作。比如读写 Flash、网络请求这些，扔到任务队列里去做。我曾经在一个点击回调里直接写了个延时，结果整个 UI 卡死了，排查了半天才发现是回调阻塞了事件循环。

3.3 事件类型：都有哪些？

LVGL 预定义了一大堆事件类型，我挑几个常用的列出来：

事件类型	触发时机	常见用途
`LV_EVENT_CLICKED`	点击后释放	按钮确认、菜单选择
`LV_EVENT_PRESSING`	按下过程中持续触发	长按加速、进度反馈
`LV_EVENT_VALUE_CHANGED`	值发生变化	滑块拖动、开关切换
`LV_EVENT_KEY`	物理按键按下	键盘导航、遥控器输入
`LV_EVENT_DRAW_PART_BEGIN`	绘制某部分开始前	自定义绘制、动画注入

你想想看，一个滑块拖动时，LV_EVENT_PRESSING 会疯狂触发，而 LV_EVENT_VALUE_CHANGED 只在值真正变化时才触发。选对事件类型，能省不少 CPU。

3.4 事件冒泡与捕获：事件怎么跑？

这是 LVGL 事件机制里最值得玩味的地方。它借鉴了 DOM 事件流，但做了嵌入式风格的简化。

事件传播分三个阶段：

捕获阶段（Capture）：事件从根对象向下传播到目标对象。
目标阶段（Target）：事件到达目标对象本身。
冒泡阶段（Bubble）：事件从目标对象向上传播回根对象。

默认情况下，LVGL 只走目标阶段和冒泡阶段。捕获阶段需要你主动开启：

lv_obj_add_event_cb(parent, capture_cb, LV_EVENT_CLICKED, NULL);
lv_obj_add_flag(parent, LV_OBJ_FLAG_EVENT_BUBBLE);

等等，这里有个坑——LV_OBJ_FLAG_EVENT_BUBBLE 是让父对象能收到子对象冒上来的事件，不是开启捕获。捕获需要你在注册回调时指定 LV_EVENT_CLICKED 并配合 lv_obj_set_event_cb_filter 或者直接在父对象上监听，事件系统会自动先走捕获再走冒泡。

我曾经踩过的坑：在一个列表项里放了删除按钮，点击删除按钮时，列表项的点击事件也触发了。原因就是事件冒泡到了父对象。解决方案是在删除按钮的回调里调用 lv_event_stop_bubble(e)，阻止事件继续往上冒。

阻止冒泡的代码：

static void delete_btn_cb(lv_event_t * e)
{
    // 处理删除逻辑
    lv_event_stop_bubble(e);  // 到此为止，别往上冒了
}

3.5 事件处理流程图

下面这张图展示了事件从触摸到回调的完整路径：

3.6 实际项目中的事件处理策略

我在做智能家居面板时，总结了一套事件处理的分层策略：

底层控件（按钮、滑块）：只处理自身交互事件，不关心业务逻辑。
中间容器（页面、面板）：监听子控件冒泡上来的事件，做页面级别的逻辑分发。
顶层屏幕：处理全局事件，比如返回键、休眠唤醒。

这样做的好处是，每个层级的职责清晰，代码好维护。你想想看，如果所有逻辑都写在按钮的回调里，那改一个需求得翻遍几十个文件。

避坑指南：不要在回调里删除或移动正在处理事件的对象。比如点击按钮后直接 lv_obj_del(btn)，这会导致事件系统崩溃。正确的做法是用 lv_async_call 延迟执行删除操作。

3.7 小结

事件监听器是注册机制，回调函数是处理逻辑，冒泡和捕获决定了事件怎么传播。这三者配合起来，能写出很灵活的交互逻辑。我个人建议，刚开始用 LVGL 时，先只用目标阶段和冒泡阶段，等熟悉了再碰捕获。毕竟，大多数场景下冒泡就够用了。

📚 课程目录

3. LVGL 事件处理机制：事件监听器、事件回调函数、事件冒泡与捕获

3.1 事件监听器：谁在听？

3.2 事件回调函数：来了怎么处理？

3.3 事件类型：都有哪些？

3.4 事件冒泡与捕获：事件怎么跑？

3.5 事件处理流程图

3.6 实际项目中的事件处理策略

3.7 小结