# 函数指针多级菜单

**Repository Path**: AdamLoong/Embedded_Menu_Simple

## Basic Information

- **Project Name**: 函数指针多级菜单
- **Description**: 这是一个使用函数指针实现的多级菜单
- **Primary Language**: C
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 72
- **Forks**: 18
- **Created**: 2024-04-28
- **Last Updated**: 2025-05-22

## Categories & Tags

**Categories**: desktop-ui

**Tags**: None

## README

/*
# 多级菜单v2.0
### 作者:Adam
#
*   这是一个使用函数指针实现的多级菜单
```c
typedef struct _MENU_OptionTypeDef // 选项结构体
{
    char *String;       // 选项字符串
    void (*func)(void); // 选项功能 函数指针
} MENU_OptionTypeDef;
```

* ## 使用方法
#### 1. 创建选项列表,并直接初始化, 每个选项对应其名字和功能(直接填写函数名), 例如:
 ```c
static MENU_OptionTypeDef MENU_OptionList[] = {{"<<<", NULL},                     // 固定格式, 用于退出
                                                {"Tools", MENU_RunToolsMenu},      // 工具
                                                {"Games", MENU_RunGamesMenu},      // 游戏
                                                {"Setting", MENU_RunSettingMenu},  // 设置
                                                {"Information", MENU_Information}, // 信息
                                                {"..", NULL}};                     // 固定格式, 用于计算选项列表长度和退出                                          
 ```
#### 2. 调用 MENU_RunMenu() 运行菜单, 参数为选项列表

```c
MENU_RunMenu(MENU_OptionList);
```
 
#### 3. 为了实现多级菜单, 可使用一个函数来封装 第1 第2 步, 封装好的函数可作为功能被其他菜单调用, 以此实现不限层级多级菜单, 例如:
```c
void MENU_RunMainMenu(void)
{
    static MENU_OptionTypeDef MENU_OptionList[] = {{"<<<"},
                                                   {"Tools", MENU_RunToolsMenu},      // 工具
                                                   {"Games", MENU_RunGamesMenu},      // 游戏
                                                   {"Setting", NULL},                 // 设置
                                                   {"Information", MENU_Information}, // 信息
                                                   {".."}};
    MENU_RunMenu(MENU_OptionList);
}

void MENU_RunToolsMenu(void)
{
    static MENU_OptionTypeDef MENU_OptionList[] = {{"<<<"},
                                                   {"Seria", NULL},         // 串口
                                                   {"Oscilloscope ", NULL}, // 示波器
                                                   {"PWM Output", NULL},    // PWM 输出
                                                   {"PWM Input", NULL},     // PWM 输入
                                                   {"ADC Input", NULL},     // ADC 输入
                                                   {".."}};
    MENU_RunMenu(MENU_OptionList);
}
```
 *例如以上 `void MENU_RunToolsMenu(void)` 被选项 `{"Tools", MENU_RunToolsMenu}` 调用;
# 
* ## 移植方法
*注: 显示器驱动需要使用缓冲区机制, 如 u8g2
#### 1. 配置菜单宏定义, 兼容不同显示器及布局, 例如:
```c
    #define MENU_WIDTH 128 // 菜单宽度
    #define MENU_HEIGHT 64 // 菜单高度
```

#### 2. 实现 menu_command_callback() 对应的指令功能以完成移植, 例如:

```c
    case BUFFER_DISPLAY:
        OLED_Update();
        break;
```
    有些指令是有参数的, 参数已经提取好, 按需使用参数即可, 例如: 
```c
    case SHOW_STRING:
        {
            /* 提取参数列表 */
            int *arg_list = ((int *)&command) + 1;
            int show_x = arg_list[0];
            int show_y = arg_list[1];
            char *show_string = (char *)arg_list[2];

            /* 按需使用参数 */
            OLED_Printf(show_x, show_y, MENU_FONT_W, show_string);
            break;
        }
```
#
 * 代码下载
  百度网盘:https://pan.baidu.com/s/1bZPWCKaiNbb-l1gpAv6QNg?pwd=KYWS 
  GitHub:https://github.com/AdamLoong/Embedded_MENU_Simple
    

 * 视频讲解: https://www.bilibili.com/video/BV1Y94y1g7mu?p=2
*  B站UP:加油哦大灰狼
* ### 如果此程序对你有帮助记得给个一键三连哦! ( •̀ ω •́ )✧
  */