lvgl 焦点

### 关于 LVGL 中焦点管理的实现 #### 焦点事件机制 在 LVGL 框架中，焦点管理主要依赖于事件处理机制。当对象获得或失去焦点时，可以通过绑定特定的事件来响应这些状态变化。以下是常用的焦点相关事件及其作用： - **LV_EVENT_FOCUSED**: 当对象获得焦点时触发此事件[^1]。这通常用于高亮显示当前被选中的对象。 - **LV_EVENT_DEFOCUSED**: 当对象失去焦点时触发此事件。 通过注册上述事件，开发者可以自定义对象的行为，例如更改样式、更新数据或其他交互逻辑。 #### 示例代码：设置焦点事件回调函数 以下是一个简单的示例，展示如何为按钮对象设置 `LV_EVENT_FOCUSED` 和 `LV_EVENT_DEFOCUSED` 的回调函数。 ```c #include "lvgl/lvgl.h" static void btn_focused_event_cb(lv_event_t *e) { lv_obj_t *obj = lv_event_get_current_target(e); lv_obj_add_state(obj, LV_STATE_FOCUSED); // 添加聚焦状态 } static void btn_defocused_event_cb(lv_event_t *e) { lv_obj_t *obj = lv_event_get_current_target(e); lv_obj_clear_state(obj, LV_STATE_FOCUSED); // 移除聚焦状态 } void setup_focus_events() { lv_obj_t *btn = lv_btn_create(lv_scr_act()); lv_obj_set_size(btn, 100, 50); lv_obj_align(btn, LV_ALIGN_CENTER, 0, 0); lv_obj_add_event_cb(btn, btn_focused_event_cb, LV_EVENT_FOCUSED, NULL); lv_obj_add_event_cb(btn, btn_defocused_event_cb, LV_EVENT_DEFOCUSED, NULL); } ``` #### 网格导航功能 除了基本的焦点事件外，LVGL 还提供了更高级别的网格导航（Grid Navigation）功能[^2]。该功能允许用户通过键盘的方向键在多个子对象之间切换焦点，特别适合复杂的 UI 场景。 ##### 特性概述 - **方向键导航**：基于对象的位置坐标（x 和 y 轴），按下方向键即可移动到最近的对象。 - **灵活布局支持**：无论是手动布置还是使用 Flex/Grid 布局，都可以无缝集成。 - **滚动同步**：如果容器是可滚动的，则会自动调整视图以保持焦点对象可见。 - **键盘快捷键**：支持 `LV_KEY_NEXT` 和 `LV_KEY_PREV` 来快速跳转至下一个或上一个控件。 ##### 示例代码：启用网格导航 下面展示了如何在一个容器内启用网格导航并配置按键行为。 ```c #include "lvgl/lvgl.h" void enable_grid_navigation() { lv_obj_t *container = lv_obj_create(lv_scr_act()); lv_obj_set_size(container, 300, 200); lv_obj_set_layout(container, LV_LAYOUT_GRID); // 设置为网格布局 lv_group_t *group = lv_group_create(); lv_indev_set_group(lv_indev_get_next(NULL), group); // 将输入设备关联到分组 for (int i = 0; i < 6; ++i) { // 创建六个按钮 lv_obj_t *btn = lv_btn_create(container); lv_obj_set_width(btn, 80); lv_obj_set_height(btn, 40); lv_obj_set_grid_cell(btn, LV_GRID_ALIGN_STRETCH, i % 3, 1, LV_GRID_ALIGN_STRETCH, i / 3, 1); lv_group_add_obj(group, btn); // 将按钮加入分组 } } ``` #### 总结 LVGL 提供了丰富的工具集来管理和操作界面元素的焦点状态。从基础的事件监听器到高级的网格导航功能，开发人员可以根据具体需求选择合适的方案。以上内容涵盖了焦点管理的核心概念以及实际应用案例。 ---