作为嵌入式软件开发,可能经常会使用命令行或者显示屏等设备实现人机交互的功能,功能中通常情况都包含 UI 菜单设计;很多开发人员都会有自己的菜单框架模块,防止重复造轮子,网上有很多这种菜单框架的代码,但是大多耦合性太强,无法独立出来适配不同的菜单设计。
本文介绍一个降低了耦合性,完全独立的菜单框架,菜单显示风格和显示平台完全由自己根据需求设计,而菜单操作统一由菜单模块处理即可,提高程序的移植性。
2、介绍
菜单框架代码主要特点有:
- 采用链表或数组的方式实现多级菜单(通过配置选择)
- 菜单框架作为独立模块,拒绝和按键模块和显示模块耦合
- 在十分独立的情况下,也保证不受菜单的显示风格和显示平台影响,可自由选择设计显示风格和显示平台
- 可以采用表驱动的方式初始化菜单,提高代码的可读性
3、代码功能
源文件部分代码如下:
int Menu_Init(MenuRegister_t *pMainMenu, uint8_t num, ShowMenuCallFun_f fpnShowMenu)
{
MenuCtrl_t *pMenuCtrl = NULL;
#if MENU_MAX_DEPTH != 0
sg_currMenuDepth = 0;
#endif
if ((pMenuCtrl = NewMenu()) != NULL)
{
pMenuCtrl->pLastMenuCtrl = NULL;
pMenuCtrl->pfnShowMenuFun = fpnShowMenu;
pMenuCtrl->pMenuInfo = pMainMenu;
pMenuCtrl->menuNum = num;
pMenuCtrl->currPos = 0;
pMenuCtrl->isRunCallback = 0;
sg_tMenuManage.pCurrMenuCtrl = pMenuCtrl;
return 0;
}
return -1;
}
头文件部分代码如下:
typedef struct MenuRegister
{
const char *pszDesc;
menusize_t subMenuNum;
struct MenuRegister *pSubMenu;
ShowMenuCallFun_f pfnShowMenuFun;
MenuCallFun_f pfnMenuCallFun;
}MenuRegister_t;
#define GET_MENU_NUM(X) (sizeof(X) / sizeof(MenuRegister_t))
extern int Menu_Init(MenuRegister_t *pMainMenu, uint8_t num, ShowMenuCallFun_f fpnShowMenu);
extern int Menu_ResetMainMenu(void);
extern int Menu_Enter(void);
extern int Menu_Exit(uint8_t isReset);
extern int Menu_SelectPrevious(uint8_t isAllowRoll);
extern int Menu_SelectNext(uint8_t isAllowRoll);
extern int Menu_Task(void);
4、示例代码显示效果
示例代码采用的平台是命令行输出输入显示效果(可自由选择显示平台和显示风格)
以下是通过单片机驱动 OLED 显示的菜单界面显示效果
5、示例代码获取链接
下载链接点击:轻量级菜单框架(最新的功能可切换 develop 分支)



