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;            /*!< 當前選項的中文字串描述 */

    const char     *pszEnDesc;          /*!< 當前選項的英文字串描述 */

    menusize_t      subMenuNum;         /*!< 當前選項的子選單數目, 子選單數目為0則表示下一級非選單界面, 會執行非選單功能函式 */

    struct MenuRegister *pSubMenu;      /*!< 當前選項的子選單內容 */

    ShowMenuCallFun_f pfnShowMenuFun;   /*!< 當前選項的子選單顯示效果函式, 為NULL則延續上級選單顯示效果 */

    MenuCallFun_f     pfnEnterCallFun;  /*!< 當前選項確定進入時需要執行的函式, 為NULL不執行 */

    MenuCallFun_f     pfnExitCallFun;   /*!< 當前選項進入后在退出時需要執行的函式, 為NULL不執行 */

    MenuCallFun_f     pfnRunCallFun;    /*!< 當前選項的非選單功能函式, 只有當選單數目為0有效, 為NULL不執行 */

    void             *pExtendData;      /*!< 當前選項的選單顯示效果函式擴展資料入參, 可自行設定該內容 */
}MenuRegister_t;

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

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

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

/* 選單初始化和反初始化 */
extern int Menu_Init(MenuRegister_t *pMainMenu, uint8_t num, ShowMenuCallFun_f fpnShowMenu);
extern int Menu_DeInit(void);

/* 選單功能設定 */
extern menubool Menu_IsEnglish(void);
extern int Menu_SetEnglish(menubool isEnable);

/* 選單選項顯示時需要使用的功能擴展函式 */
extern int Menu_UpdateShowBase(MenuShow_t *ptMenuShow, menusize_t showNum);

/* 選單狀態獲取函式 */
extern menubool Menu_IsRun(void);
extern menubool Menu_IsMainMenu(void);
extern menubool Menu_IsAtMenu(void);

/* 選單操作 */
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);

/* 選單輪詢處理任務 */
extern int Menu_Task(void);