39 lines
1.7 KiB
C
39 lines
1.7 KiB
C
/*
|
|
* 模块名称：UI Menu (菜单导航逻辑层)
|
|
* 模块功能：g_menu_tab 父子索引表驱动的横向级联菜单导航——持有导航状态
|
|
* （路径/选中/深度/滚动，共 17 B）与键语义（↑↓移选、→/ENTER 进、←/ESC 退），
|
|
* 单向驱动显示层 ui_menu_view 建/毁/刷新级联框；本层不持有任何 LVGL 对象
|
|
* 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
|
|
* 作者：王建锋
|
|
* 创建日期：2026-08-29
|
|
* 修改记录：
|
|
* 2026-08-29 王建锋 创建初始版本
|
|
* 2026-09-02 王建锋 弃用已废弃的 lv_menu 控件，改为基元控件页面导航
|
|
* 2026-09-04 王建锋 重构为"横向级联框"模型（菜单页面设计.md）：拆出显示层
|
|
* ui_menu_view 与数据层 ui_menu_tab；本层只留导航状态机
|
|
*/
|
|
#ifndef UI_MENU_H
|
|
#define UI_MENU_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* 函数功能：构建菜单（横向级联框：右贴靠 + 自适应宽 + 顶/底对齐）
|
|
* 入口参数：无
|
|
* 返回值：0 - 成功，其他 - 失败（菜单表自检失败或对象创建失败）
|
|
* 限定条件：ui_port_init()（或模拟器 sim_port_init）已成功调用，活动屏幕存在
|
|
* 函数说明： 1. 数据表自检（parent 下标均有效，捕获表内笔误）
|
|
* 2. 初始化显示层（样式/4 层持久容器/根框装饰与框体）
|
|
* 3. 各层容器加入默认输入组，按键由逻辑层统一分发（显示层纯渲染）
|
|
* 4. 构建根框（主界面 node 0 的子项）并置焦点
|
|
*/
|
|
int ui_menu_init(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* UI_MENU_H */
|