3. 核心机制解析：LVGL的对象模型、父子关系、事件驱动机制、屏幕与图层概念

好，咱们今天来啃一块硬骨头。LVGL 的核心机制，说白了就是它的「骨架」和「神经」。你如果只是照着例程画几个按钮，那永远只能停留在表面。我刚开始接触 LVGL 时，也踩过不少坑，比如为什么这个控件点不动？为什么那个弹窗被挡住了？搞懂今天这几个概念，这些问题就迎刃而解了。

3.1 对象模型：一切皆对象

LVGL 里，所有可见的东西都是对象。按钮是对象，标签是对象，滑块是对象，甚至连屏幕本身也是一个对象。这个设计思路，其实跟很多现代 GUI 框架很像。

每个对象都有一个类型，比如 lv_btn、lv_label。它们都继承自一个基类——lv_obj_t。你可以把 lv_obj_t 想象成一个「空壳子」，它定义了所有对象共有的属性：位置、大小、父对象、样式、事件回调等等。

核心要点：LVGL 的对象模型是「基于类的继承」结构。你创建一个按钮，本质上就是创建了一个 lv_obj_t 实例，然后给它附加了按钮的行为和外观。

我在项目中遇到过一个问题：我想让一个自定义的图形也支持点击事件。当时我直接创建了一个 lv_obj_t，然后给它画了个圆。结果发现，点击事件根本不触发。为什么？因为 lv_obj_t 本身没有「点击区域」的概念，你需要手动设置它的点击范围。嗯，这个坑我替你们踩过了。

3.2 父子关系：控件的「家族树」

LVGL 里，对象之间是有「辈分」的。每个对象都有一个父对象，也可以有多个子对象。这就形成了一棵树——我们叫它「对象树」。

举个例子：

lv_obj_t *scr = lv_scr_act();  // 当前活动屏幕，是根节点
lv_obj_t *btn = lv_btn_create(scr);  // 按钮的父对象是屏幕
lv_obj_t *label = lv_label_create(btn);  // 标签的父对象是按钮

这棵树有什么意义？

  • 位置是相对的：子对象的位置是相对于父对象的。你移动父对象，所有子对象跟着动。我刚开始做仪表盘时，把一组控件放在一个容器里，然后移动容器，所有控件自动对齐——省了不少事。
  • 显示层级：子对象永远显示在父对象之上。但注意，同级的子对象，后创建的会覆盖先创建的。
  • 事件传递：事件会沿着父子关系向上冒泡。你点击一个按钮，按钮先处理，如果没处理完，事件会传给它的父对象。

小技巧：如果你想让一组控件同时隐藏或移动，把它们放在同一个父容器下。我经常用 lv_obj_create(parent) 创建一个透明的容器，然后往里面塞东西。这样管理起来特别清爽。

3.3 事件驱动机制：LVGL 的「神经反射」

LVGL 是事件驱动的。什么意思？就是它一直在「监听」——触摸、按键、定时器、甚至自定义信号。一旦有事件发生，它就调用你注册的回调函数。

事件注册很简单：

lv_obj_add_event_cb(btn, my_button_callback, LV_EVENT_CLICKED, NULL);

void my_button_callback(lv_event_t *e) {
    lv_obj_t *btn = lv_event_get_target(e);
    LV_LOG_USER("按钮被点击了！");
}

这里有几个关键点：

  • 事件类型：LVGL 定义了很多事件类型，比如 LV_EVENT_CLICKED、LV_EVENT_PRESSING、LV_EVENT_VALUE_CHANGED 等等。你想想看，一个滑块拖动时，它触发的是 LV_EVENT_VALUE_CHANGED，而不是点击事件。
  • 事件目标：通过 lv_event_get_target(e) 获取触发事件的对象。注意，有时候事件是从子对象冒泡上来的，你可以用 lv_event_get_current_target(e) 获取当前处理事件的对象。
  • 事件冒泡：默认情况下，事件会从子对象向父对象传递。如果你不想让事件继续往上冒，可以调用 lv_event_stop_bubbling(e)。

注意：我曾经犯过一个错误——在回调函数里直接删除触发事件的对象。结果程序直接崩溃。为什么？因为事件处理还没完成，对象就被销毁了。正确的做法是用 lv_async_call 延迟删除，或者设置一个标志位，在主循环里处理。

3.4 屏幕与图层概念：你的「画布」和「图层」

屏幕，就是 LVGL 的「画布」。每个屏幕都是一个 lv_obj_t 对象，但它比较特殊——它是对象树的根节点。你创建的所有控件，最终都要挂到某个屏幕上。

LVGL 支持多个屏幕。你可以创建多个屏幕，然后在它们之间切换：

lv_obj_t *scr1 = lv_obj_create(NULL);  // 创建新屏幕
lv_obj_t *scr2 = lv_obj_create(NULL);

lv_scr_load(scr1);  // 切换到 scr1
// 稍后
lv_scr_load(scr2);  // 切换到 scr2

但这里有个容易混淆的概念——图层。

每个屏幕其实有多个图层：

图层名称 说明 典型用途
活动层 你创建控件时默认所在的层 普通 UI 控件
顶层 显示在活动层之上 弹窗、提示框、下拉菜单
系统层 显示在最顶层，且不随屏幕切换而改变 状态栏、导航栏、系统通知

你想想看，为什么你的弹窗会被其他控件挡住？很可能是因为你把弹窗放在了活动层，而其他控件后创建，覆盖了它。正确的做法是把弹窗放在顶层：

lv_obj_t *popup = lv_obj_create(lv_layer_top());  // 放在顶层

或者，如果你想让某个控件始终显示在最前面，比如一个「返回」按钮，可以把它放在系统层：

lv_obj_t *back_btn = lv_btn_create(lv_layer_sys());  // 放在系统层

重要：系统层的内容不会随屏幕切换而消失。我做过一个项目，需要在所有页面都显示一个「电量」图标。一开始我每个屏幕都加了一个，后来发现用系统层，只加一次，省了不少内存。

3.5 总结与避坑

好，咱们来捋一捋今天的内容：

  • 对象模型：一切皆对象，继承自 lv_obj_t。
  • 父子关系：形成对象树，位置相对，事件冒泡。
  • 事件驱动：注册回调，处理各种事件，注意不要删除正在处理事件的对象。
  • 屏幕与图层：屏幕是根节点，图层控制显示层级，系统层不随屏幕切换。

最后，再分享一个我踩过的坑。有一次，我在一个屏幕上创建了上百个控件，结果切换屏幕时卡顿了。后来发现，是因为我没有及时删除不需要的控件。LVGL 不会自动清理对象，你需要手动调用 lv_obj_del()。嗯，内存管理这件事，任何时候都不能掉以轻心。

下一章，咱们会深入讲解 LVGL 的样式系统。到时候你会发现，原来给控件「化妆」也可以这么优雅。

← 上一章 📖 返回目录 下一章 →