LVGL下拉列表lv_ddlist全API详解与嵌入式实战

37.2 lv_ddlist 下拉列表框的 API 接口详解与工程实践

下拉列表框（Dropdown List，lv_ddlist_t）是 LittlevGL 中最常用且交互逻辑相对复杂的控件之一。它不仅承担着选项展示与用户选择的核心功能，其展开/收缩行为、动画控制、样式定制、事件响应等机制，也集中体现了 LVGL 控件系统的设计哲学：状态驱动 + 事件回调 + 样式分离。本节将完全脱离视频演示语境，以嵌入式工程师的视角，系统性地剖析lv_ddlist的全部 15 个核心 API 接口，明确每个接口的工程目的、参数设计原理、底层机制，并结合正点原子 STM32 平台的实际项目经验，给出可直接复用的配置逻辑与避坑指南。

37.2.1 状态控制类 API：理解“展开”与“收缩”的本质

在 LVGL 中，“展开”（Expanded）与“收缩”（Collapsed）并非简单的布尔开关，而是控件内部状态机的两个关键节点。lv_ddlist的状态切换会触发一系列连锁反应：尺寸重计算、子对象（下拉菜单）的创建/销毁、坐标重定位、动画启动、以及最终的屏幕刷新。因此，所有状态控制 API 的设计，都围绕着对这一状态机的精确干预。

37.2.1.1lv_ddlist_set_auto_close(lv_obj_t * ddlist, bool en)

工程目的：禁用或启用“选择后自动收缩”这一默认行为。

原理阐释