轻量级多级菜单控制框架程序（C语言）

1、前言

作为嵌入式软件开发，可能经常会使用命令行或者显示屏等设备实现人机交互的功能，功能中通常情况都包含 UI 菜单设计；很多开发人员都会有自己的菜单框架模块，防止重复造轮子，网上有很多这种菜单框架的代码，但是大多耦合性太强，无法独立出来适配不同的菜单设计。

本文介绍一个降低了耦合性，完全独立的菜单框架，菜单显示风格和显示平台完全由自己根据需求设计，而菜单操作统一由菜单模块处理即可，提高程序的移植性。

2、介绍

菜单框架代码主要特点有：

• 采用链表方式实现多级菜单（通过配置选择采用动态分配或者数组实现）
• 菜单框架作为独立模块，拒绝和按键模块、显示模块进行耦合
• 在十分独立的情况下，也保证不受菜单的显示风格和显示平台影响，可自由选择设计显示风格和显示平台
• 快捷菜单操作等
• 可以采用表驱动的方式初始化菜单，提高代码的可读性

3、代码功能

源文件部分代码如下：

/**
  * @brief      菜单初始化
  *
  * @param[in]  pMainMenu    主菜单注册信息
  * @param[in]  num          主菜单数目
  * @param[in]  fpnShowMenu  主菜单显示效果函数
  * @return     0,成功; -1,失败
  */
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;
}

头文件部分代码如下：

/**
  * @brief 菜单信息注册结构体
  *
  */
typedef struct MenuRegister
{
    const char     *pszDesc;            /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x4E2D;&#x6587;&#x5B57;&#x7B26;&#x4E32;&#x63CF;&#x8FF0; */

    const char     *pszEnDesc;          /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x82F1;&#x6587;&#x5B57;&#x7B26;&#x4E32;&#x63CF;&#x8FF0; */

    menusize_t      subMenuNum;         /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x5B50;&#x83DC;&#x5355;&#x6570;&#x76EE;, &#x5B50;&#x83DC;&#x5355;&#x6570;&#x76EE;&#x4E3A;0&#x5219;&#x8868;&#x793A;&#x4E0B;&#x4E00;&#x7EA7;&#x975E;&#x83DC;&#x5355;&#x754C;&#x9762;, &#x4F1A;&#x6267;&#x884C;&#x975E;&#x83DC;&#x5355;&#x529F;&#x80FD;&#x51FD;&#x6570; */

    struct MenuRegister *pSubMenu;      /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x5B50;&#x83DC;&#x5355;&#x5185;&#x5BB9; */

    ShowMenuCallFun_f pfnShowMenuFun;   /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x5B50;&#x83DC;&#x5355;&#x663E;&#x793A;&#x6548;&#x679C;&#x51FD;&#x6570;, &#x4E3A;NULL&#x5219;&#x5EF6;&#x7EED;&#x4E0A;&#x7EA7;&#x83DC;&#x5355;&#x663E;&#x793A;&#x6548;&#x679C; */

    MenuCallFun_f     pfnEnterCallFun;  /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x786E;&#x5B9A;&#x8FDB;&#x5165;&#x65F6;&#x9700;&#x8981;&#x6267;&#x884C;&#x7684;&#x51FD;&#x6570;, &#x4E3A;NULL&#x4E0D;&#x6267;&#x884C; */

    MenuCallFun_f     pfnExitCallFun;   /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x8FDB;&#x5165;&#x540E;&#x5728;&#x9000;&#x51FA;&#x65F6;&#x9700;&#x8981;&#x6267;&#x884C;&#x7684;&#x51FD;&#x6570;, &#x4E3A;NULL&#x4E0D;&#x6267;&#x884C; */

    MenuCallFun_f     pfnRunCallFun;    /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x975E;&#x83DC;&#x5355;&#x529F;&#x80FD;&#x51FD;&#x6570;, &#x53EA;&#x6709;&#x5F53;&#x83DC;&#x5355;&#x6570;&#x76EE;&#x4E3A;0&#x6709;&#x6548;, &#x4E3A;NULL&#x4E0D;&#x6267;&#x884C; */

    void             *pExtendData;      /*!< &#x5F53;&#x524D;&#x9009;&#x9879;&#x7684;&#x83DC;&#x5355;&#x663E;&#x793A;&#x6548;&#x679C;&#x51FD;&#x6570;&#x6269;&#x5C55;&#x6570;&#x636E;&#x5165;&#x53C2;, &#x53EF;&#x81EA;&#x884C;&#x8BBE;&#x7F6E;&#x8BE5;&#x5185;&#x5BB9; */
}MenuRegister_t;

/* Exported constants ------------------------------------------------------------------------------------------------*/
/* Exported macro ----------------------------------------------------------------------------------------------------*/

#define GET_MENU_NUM(X)    (sizeof(X) / sizeof(MenuRegister_t))

/* Exported functions ------------------------------------------------------------------------------------------------*/

/* &#x83DC;&#x5355;&#x521D;&#x59CB;&#x5316;&#x548C;&#x53CD;&#x521D;&#x59CB;&#x5316; */
extern int Menu_Init(MenuRegister_t *pMainMenu, uint8_t num, ShowMenuCallFun_f fpnShowMenu);
extern int Menu_DeInit(void);

/* &#x83DC;&#x5355;&#x529F;&#x80FD;&#x8BBE;&#x7F6E; */
extern menubool Menu_IsEnglish(void);
extern int Menu_SetEnglish(menubool isEnable);

/* &#x83DC;&#x5355;&#x9009;&#x9879;&#x663E;&#x793A;&#x65F6;&#x9700;&#x8981;&#x4F7F;&#x7528;&#x7684;&#x529F;&#x80FD;&#x6269;&#x5C55;&#x51FD;&#x6570; */
extern int Menu_UpdateShowBase(MenuShow_t *ptMenuShow, menusize_t showNum);

/* &#x83DC;&#x5355;&#x72B6;&#x6001;&#x83B7;&#x53D6;&#x51FD;&#x6570; */
extern menubool Menu_IsRun(void);
extern menubool Menu_IsMainMenu(void);
extern menubool Menu_IsAtMenu(void);

/* &#x83DC;&#x5355;&#x64CD;&#x4F5C; */
extern int Menu_Reset(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);

/* &#x83DC;&#x5355;&#x8F6E;&#x8BE2;&#x5904;&#x7406;&#x4EFB;&#x52A1; */
extern int Menu_Task(void);

4、示例代码显示效果

示例代码采用的平台是命令行输出输入显示效果

demo中提供了如何实现图形菜单（主菜单有点粗糙）、普通列表菜单、右侧弹窗菜单（更多设置）等效果演示，菜单样式可自由扩展，足够自由；快捷菜单操作、中英文切换演示。（windows中编译需要将 demo.c转 GBK 编码，Linux 转 utf8 编码，不然可能出现汉字乱码的问题）

以下是通过单片机驱动 OLED 显示的菜单界面显示效果

5、示例代码获取链接

下载链接点击：轻量级菜单框架（最新的功能可切换 develop 分支）

Original: https://www.cnblogs.com/const-zpc/p/16364420.html
Author: 大橙子疯
Title: 轻量级多级菜单控制框架程序（C语言）