1. LVGL 事件系统概述：事件驱动模型、事件类型分类、事件注册与注销机制

各位同学，咱们今天正式开讲 LVGL 的事件系统。说实话，我刚开始接触 LVGL 的时候，觉得这玩意儿不就是个 GUI 库嘛，画几个按钮、显示几行文字就完事了。结果第一次做项目，客户要求“点击按钮后弹窗，弹窗消失后再执行一个动画”，我愣是折腾了两天才把事件链理清楚。从那以后，我算是彻底明白了——事件系统是 LVGL 的灵魂，搞不懂它，你写出来的界面就是“死”的。

1.1 事件驱动模型：你的 UI 为什么能“活”起来？

先问大家一个问题：你按下触摸屏的那一刻，LVGL 是怎么知道该响应哪个按钮的？

答案就是事件驱动模型。说白了，LVGL 内部维护了一个事件队列。用户触摸、按键、定时器超时这些“事情”发生以后，LVGL 会把这些事情包装成事件对象，扔进队列里。主循环（lv_timer_handler()）每次执行时，都会从队列里取出事件，然后分发给对应的对象去处理。

核心流程：

  1. 硬件产生输入（触摸、按键等）
  2. LVGL 底层驱动捕获输入，生成事件
  3. 事件进入队列
  4. 主循环分发事件到目标对象
  5. 对象调用注册的回调函数

我个人习惯把这个模型叫做“三要素模型”：事件源（谁触发的）、事件类型（发生了什么）、事件目标（谁来处理）。你想想看，只要把这三个要素搞清楚了，整个事件系统的脉络就清晰了。

下面这张图是我自己画的，把事件驱动模型的核心流程展示出来了：

LVGL 事件驱动模型核心流程 事件源 触摸屏 / 按键 / 定时器 事件生成 lv_event_t 对象 事件队列 FIFO 排队 主循环分发 lv_timer_handler() 事件目标 对象回调函数 回调执行 💡 关键点 事件队列是异步的 回调执行是同步的

我的经验：很多初学者以为事件是“实时响应”的，其实不是。LVGL 的事件处理是在主循环里轮询的。如果你的 lv_timer_handler() 调用频率太低，触摸响应就会有延迟。我一般建议在 while(1) 里每 5ms 调用一次，这样手感最跟手。

1.2 事件类型分类：LVGL 到底能响应哪些事？

LVGL 把事件分成了好几大类。我刚开始学的时候，觉得分类太多记不住。后来做项目多了，发现其实就三大类最常用：输入事件、状态事件、绘制事件。其他的属于“高级玩法”，用到的时候再查文档就行。

下面这个表格是我整理的，把最常用的事件类型列出来了：

事件宏 触发时机 常用场景
LV_EVENT_CLICKED 点击完成后（按下+释放） 按钮点击、菜单选择
LV_EVENT_PRESSED 对象被按下瞬间 按下反馈（变色、震动）
LV_EVENT_RELEASED 对象被释放瞬间 释放动画触发
LV_EVENT_VALUE_CHANGED 对象的值发生变化 滑块拖动、开关切换
LV_EVENT_LONG_PRESSED 长按超过设定时间 长按删除、快捷操作
LV_EVENT_KEY 物理按键按下 键盘导航、遥控器操作
LV_EVENT_DRAW_MAIN_BEGIN 开始绘制对象主体前 自定义绘制背景
LV_EVENT_DRAW_MAIN_END 绘制对象主体完成后 叠加额外图形

我曾经踩过的坑：注意 LV_EVENT_CLICKED 和 LV_EVENT_RELEASED 的区别。CLICKED 是“按下+释放”的完整动作，而 RELEASED 只是“手指离开屏幕”那一瞬间。如果你在 RELEASED 里做弹窗，用户手指还没离开屏幕，弹窗就出来了，体验很怪。我建议：按钮操作用 CLICKED，触摸反馈用 PRESSED/RELEASED。

1.3 事件注册与注销机制：怎么让对象“听”你的话？

好，现在我们知道事件是怎么来的、有哪些类型了。下一步就是——怎么让一个按钮响应点击？

答案就是注册回调函数。LVGL 提供了两个核心 API：

  • lv_obj_add_event_cb(obj, callback, event_code, user_data) —— 注册事件
  • lv_obj_remove_event_cb(obj, callback) —— 注销事件

咱们直接看代码，我写一个最典型的按钮点击示例：

// 回调函数定义
static void btn_click_cb(lv_event_t * e)
{
    lv_obj_t * btn = lv_event_get_target(e);
    lv_obj_t * label = lv_obj_get_child(btn, 0);
    lv_label_set_text(label, "Clicked!");
    LV_LOG_USER("Button clicked!");
}

// 创建按钮并注册事件
lv_obj_t * btn = lv_btn_create(lv_scr_act());
lv_obj_set_size(btn, 120, 50);
lv_obj_center(btn);

lv_obj_t * label = lv_label_create(btn);
lv_label_set_text(label, "Click Me");
lv_obj_center(label);

// 注册点击事件
lv_obj_add_event_cb(btn, btn_click_cb, LV_EVENT_CLICKED, NULL);

这段代码很简单，但我得强调几个细节：

  1. 回调函数的参数：lv_event_t * e 包含了事件的所有信息。你可以通过 lv_event_get_target() 拿到触发事件的对象，通过 lv_event_get_user_data() 拿到注册时传入的自定义数据。
  2. 同一个对象可以注册多个事件：比如一个按钮既响应 CLICKED，又响应 LONG_PRESSED，完全没问题。
  3. 同一个事件可以注册多个回调：按注册顺序依次执行。

注销事件的正确姿势：

// 注销指定回调
lv_obj_remove_event_cb(btn, btn_click_cb);

// 注销对象上的所有事件（慎用）
lv_obj_remove_event_cb(btn, NULL);

我建议：删除对象前，先注销它的事件。虽然 LVGL 在删除对象时会自动清理，但如果你在回调函数里删除了对象本身，可能会触发野指针。我曾经因为这个 bug 排查了一整天……

1.4 事件传递机制：事件是怎么“跑”到对象身上的？

这里有个概念很重要——事件冒泡（Bubbling）。默认情况下，事件会从目标对象开始，逐级向上传递给父对象，直到根屏幕。

举个例子：你点击了一个按钮，按钮的父容器是一个面板。事件传递顺序是：

  1. 先触发按钮上的回调
  2. 再触发面板上的回调
  3. 最后触发屏幕上的回调

如果你不想让事件继续往上冒泡，可以在回调里调用 lv_event_stop_bubbling(e)。我一般在做“模态弹窗”的时候会用到这个——点击弹窗外部时，只关闭弹窗，不触发底层按钮的事件。

我的习惯：在复杂的 UI 里，我会利用事件冒泡来做“统一处理”。比如一个页面有 10 个按钮，我不想给每个按钮都注册回调，而是给它们的父容器注册一个回调，然后通过 lv_event_get_target() 判断具体是哪个按钮被点击了。这样代码更简洁，维护起来也方便。

1.5 本章小结

好了，咱们把 LVGL 事件系统的骨架搭起来了。总结一下今天的内容：

  • 事件驱动模型：事件源 → 事件生成 → 事件队列 → 主循环分发 → 回调执行
  • 事件类型：最常用的是 CLICKED、PRESSED、RELEASED、VALUE_CHANGED
  • 注册与注销：lv_obj_add_event_cb() 和 lv_obj_remove_event_cb()
  • 事件冒泡：默认向上传递，可以用 lv_event_stop_bubbling() 阻止
← 上一章 📖 返回目录 下一章 →