完成一个主界面开发流程

2026-09-03 23:08:16 +08:00
parent 52d7dc7d4d
commit 89462d8aa1
21 changed files with 2177 additions and 198 deletions
@@ -1,11 +1,12 @@
 /*
 * 模块名称：UI Menu (菜单页面构建)
- * 模块功能：基于 lv_menu 复现 DTU-HMI 树形菜单，支持方向键导航与返回
+ * 模块功能：基于 LVGL 基元控件（页面导航）复现 DTU-HMI 树形菜单，支持方向键导航与返回
 * 适用平台：STM32F407ZGTx
 * 作者：王建锋
 * 创建日期：2026-08-29
 * 修改记录：
 *     2026-08-29  王建锋  创建初始版本
+ *     2026-09-02  王建锋  弃用已废弃的 lv_menu 控件，改为基元控件页面导航
 */
 #ifndef UI_MENU_H
 #define UI_MENU_H
@@ -15,13 +16,13 @@ extern "C" {
 #endif

 /*
- * 函数功能：构建菜单（lv_menu 页面树），复现参考项目菜单结构
+ * 函数功能：构建菜单（基元控件页面导航：页头返回按钮 + 页面切换）
 * 入口参数：无
 * 返回值：0 - 成功，其他 - 失败（对象创建失败）
 * 限定条件：ui_port_init() 已成功调用，活动屏幕存在
- * 函数说明：1. 依据紧凑节点表按层级生成 lv_menu 页面与返回栈
- *           2. 将菜单对象加入默认输入组，支持远端按键导航
- *           3. 叶子节点挂占位页，等待后续逐项填充具体功能
+ * 函数说明：1. 依据紧凑节点表按层级组织页面，ENTER 进入子页、ESC/LEFT 返回
+ *           2. 页面容器加入默认输入组，按键由当前页容器统一处理
+ *           3. 页面按需构建（进入时建、返回时毁），叶子节点为空白占位页
 */
 int ui_menu_init(void);