事件注册与绑定：lv_obj_add_event_cb 函数详解
上一章我们聊了事件系统的基本概念。说白了，事件就是用户和屏幕之间的「对话」。但对话怎么建立？你得告诉 LVGL：「这个按钮被点击时，去执行我写的那个函数。」
这个「告诉」的过程，就是事件注册与绑定。今天我们就来拆解这个核心操作。
lv_obj_add_event_cb —— 绑定的入口
这个函数是事件绑定的唯一入口。我刚开始用 LVGL 时，总觉得它参数多、记不住。后来发现，其实就四个参数，记住一个口诀就行：
「给谁、什么事件、调谁、传什么」
来看原型：
lv_res_t lv_obj_add_event_cb(lv_obj_t * obj,
lv_event_cb_t event_cb,
lv_event_code_t filter,
void * user_data);| 参数 | 含义 | 我的经验 |
|---|---|---|
obj |
目标对象指针 | 就是你要监听的那个控件 |
event_cb |
回调函数指针 | 事件发生时，LVGL 会调用这个函数 |
filter |
事件类型过滤 | 只监听你关心的事件，比如点击、长按 |
user_data |
用户自定义数据 | 传个结构体指针，非常实用 |
user_data 传一个结构体指针，里面放上下文信息。比如按钮的 ID、状态标志等。这样回调函数里就能知道「是哪个按钮被按了」。
事件回调函数原型
回调函数长什么样？很简单：
void my_event_cb(lv_event_t * e);就一个参数：lv_event_t *。这个指针就是事件对象，里面装着所有你需要的信息。
你想想看，LVGL 怎么知道该调用哪个函数？其实就是通过函数指针。你把 my_event_cb 的地址传进去，事件发生时 LVGL 就拿着这个地址去调用。
核心要点： 回调函数的返回值是 void，但你可以通过 lv_event_t 对象来获取事件信息、修改事件行为。比如阻止事件继续传播。
事件对象 lv_event_t 介绍
lv_event_t 是事件系统的「信使」。它把事件发生时的一切信息打包好，递到你的回调函数里。
我把它比作一个「快递包裹」。里面有什么？
- 事件目标：哪个控件触发了事件？用
lv_event_get_target(e)获取。 - 当前对象：事件当前正在处理哪个控件？用
lv_event_get_current_obj(e)获取。 - 事件代码：具体是什么事件？点击、释放、长按？用
lv_event_get_code(e)获取。 - 用户数据：你当初绑定时传的
user_data，用lv_event_get_user_data(e)取回来。 - 事件参数：某些事件会携带额外参数，比如滚轮事件的滚动距离。
lv_event_t 的成员，结果导致事件传播异常。记住：lv_event_t 是只读的，你只能通过 API 函数来读取信息，不要直接操作它的内部结构。
事件注册的完整流程
我们来看一个实际例子。假设你有一个按钮，点击它时改变标签的文字：
// 1. 创建控件
lv_obj_t * btn = lv_btn_create(lv_scr_act());
lv_obj_t * label = lv_label_create(btn);
lv_label_set_text(label, "点我");
// 2. 注册事件
lv_obj_add_event_cb(btn, btn_click_cb, LV_EVENT_CLICKED, NULL);
// 3. 实现回调
static void btn_click_cb(lv_event_t * e) {
lv_obj_t * target = lv_event_get_target(e);
lv_obj_t * label = lv_obj_get_child(target, 0);
lv_label_set_text(label, "已点击");
}这个流程我用了无数次。注意看：回调函数里通过 lv_event_get_target 拿到了按钮本身，然后找到它的子对象——标签，修改了文字。
user_data 传进去。这样回调函数里就不用到处找控件了，代码更清晰。
事件过滤器的妙用
filter 参数可以让你只监听特定事件。比如：
LV_EVENT_CLICKED：点击完成LV_EVENT_PRESSING：正在按下LV_EVENT_LONG_PRESSED：长按LV_EVENT_VALUE_CHANGED：值改变
你想想看，如果每个事件都触发回调，那性能就浪费了。所以一定要精确过滤。
重要： 同一个控件可以注册多个回调函数，监听不同的事件。LVGL 内部会按注册顺序依次调用。但要注意，如果某个回调函数调用了 lv_event_stop_bubbling(e)，后续的回调就不会再执行了。
事件注册的核心逻辑图
下面这张图展示了事件注册到触发的完整流程。我画的时候特意把关键节点标出来了：
从图中可以看到，整个流程是线性的：创建控件 → 注册事件 → 等待触发 → 回调执行。每一步都很清晰。
常见问题与避坑
- 回调函数不执行？ 检查
filter参数是否正确。我曾经把LV_EVENT_CLICKED写成了LV_EVENT_PRESSED，结果点击按钮死活没反应。 - user_data 丢失？ 确保你传的指针在回调执行时仍然有效。如果传了局部变量的地址，函数返回后指针就悬空了。
- 多次注册同一个事件？ 同一个控件可以注册多个回调，但要注意执行顺序。如果不想让某个回调执行，可以用
lv_event_stop_bubbling阻止。
好了，事件注册与绑定的核心内容就这些。记住那个口诀：「给谁、什么事件、调谁、传什么」。下次写代码时，心里默念一遍，保证不会错。