自制的Arduino多级菜单类

因为要做一个小应用，里面有些参数需要在运行时设置，需要用户在OLED屏上做一些简单的设定，我本想在网上找一些支持菜单开发的库，但找了很久都找不到，在论坛里也只是一些十分简单的例子，全部都是代码写死了菜单，把菜单的显示逻辑、按键响应、菜单的显示样式、菜单的内容完成写成固定的了，我觉得实在有点难看，也不利于之后的再次利用，因此，花了几天的时间写了一个菜单类库。这个库有以下的特点（好象有点自吹自擂了）：实现的功能
1.无限制菜单项目、参数项目数量，无限制级联菜单。
2.极简捷菜单项目定义；
3.通过旋转编码器可快速选取菜单项目（可使用两个按键代替旋转编码器）;
4.通过旋转编码器可快速调整参数项目值（同上）;
5.参数项目的值可以设定为 整数 或 候选列表（返回值也是整数）；
6.采用回调函数的方式（类似C#的委托）实现客户化显示，可方便调整成自己需要的显示样式；
7.支持运行期间设定及读取参数项目的值。
8.支持调整菜单时自动触发对应事件，事件与参数项目对应绑定。
9.理论上可支持多种字体，理化上支持中文，但未测试；
10.与u8g2库只是轻度耦合，稍作调整即可切换成其它第三方显示库。

待改进
1.采用C++编写，好像运行效率并无C语言的高。
2.代码量稍多，9KB。
3.运行内存占用稍多。若要同时实现多种功能，建议使用大内存的Arduino板子。

例如，要构建以下的菜单：

Main Menu(主菜单，名字可改)
-menu1 Value
  -menu11
   -value111 （参数，整型）
-menu2 Cities
  -China Cities（参数，列表参数，候选列表内容为 psCitiesChina 。）
  -USA Cities（参数，列表参数，候选列表内容为 psCitiesUSA 。）
-menu3 Animals
  -Animal Type （参数，列表参数，候选列表内容为 psAnimals 。）
-MENU4
  -MENU41
   -MENU411
    -MENU4111
     -MENU41111
-MENU5
-MENU6
-MENU7
-MENU8
-MENU9
-MENU0
-value00（参数，整型）
 

使用起来的代码如下：

#include "flexmenu.h"
#include "flexmisc.h"
#include <Arduino.h>
#include <U8g2lib.h>
 
U8G2_SSD1306_128X64_NONAME_1_4W_SW_SPI u8g2(U8G2_R0, /*DO clock=*/ 13, /*DI data=*/ 11, /*CS cs=*/ 10, /*DC dc=*/ 9, /* RES reset=*/ 8);
 
TFlexMenu FlexMenu; //我自己写的菜单类 
TFlexRotaryEncoder re(2, 3, 4); //我自己写的旋转编码器类，可参看这个贴子：https://www.arduino.cn/thread-86535-1-1.html
 
char *psCitiesChina[6] ={"Beijing", "Shanghai", "Guangzhou", "Shenzhen","Tianjin", "Hangzhou"};
char *psCitiesUSA[4] ={"NewYork", "Manhattan", "Washington", "Seattle"};
char *psAnimals[5] ={"dog", "cat", "mouse", "pig", "cow"};
 
void reRotateEvent(int direct)
{
    if (direct == -1) FlexMenu.clickUp();
    if (direct == 1)  FlexMenu.clickDown();
}
 
void Int0Event()
{
  re.checkState();
}
 
void fmOnDisplayTiltle(char *content, int ttype) //显示标题
{
    u8g2.setFont(u8g2_font_unifont_t_chinese1);
    u8g2.drawUTF8(0, 15, content);
    u8g2.drawLine(0, 16, 128, 16);
}
 
void fmOnDisplayContent(int idx, char *content, int ctype) //显示菜单内容
{
    if (ctype == 1)  // 需显示的是：一般菜单项
    {
        u8g2.drawUTF8(5, (idx + 1) * 16,content);
    }
    else if (ctype == 2) //需显示的是：光标指示的一般菜单项
    {
        u8g2.drawUTF8(5, (idx + 1) * 16,content);
        u8g2.drawTriangle(0, 8 + idx * 16, 0, 16 + idx * 16, 4, 12+ idx * 16);
    }
    else if (ctype == 3) //需显示的是：待调整的值
    {
       int ll = strlen(content) * 8;
       int sp = (128 - ll) / 2;
       u8g2.drawUTF8(sp, 3 * 16, content);
    }
}
 
void fmOnAdjustValueEvent(int id, int value, int upDown)
{
   String s = "fmOnAdjustValueEvent: id: " + id ;
   s = s + " value: " + value;
   s = s + " UpDown: " + upDown;
   //Serial.println(s);  
}
 
void fmOnOKValueEvent(int id, int value)
{
 // Serial.println("fmOnOKValueEvent: id:%d, value: %d ", id, value);  
}
 
void initMenu()
{
    TFlexMenuItem *mi1, *mi2; // 创建两个临时变量，用于创建层级菜单。
 
 
    //在根菜单下增加一个菜单，名为“menu1 Value”，NULL指的是没有父菜单项目，addMenuItem返回的是增加后该菜单项目的句柄（地址）
    mi1 = FlexMenu.addMenuItem("menu1 Value", NULL);
 
    //在“menu1 Value“菜单下增加一个菜单，名为“menu11”，mi1 传入的是menu1 Value的句柄
    mi2 = FlexMenu.addMenuItem("menu11", mi1);
 
    //增加一个整数型参数，这个参数的名字叫“value111”，id是 1（用于在运行时设置及读取），最大值是 200， 最小值是3，默认值是 100，
    FlexMenu.addMenuValue(1,"value111", mi2, 100, 200, 3);
    
    mi1 = FlexMenu.addMenuItem("menu2 Cities", NULL);
 
 
    //增加一个列表型参数，这个参数的名字叫“China Cities”，id是 2（用于在运行时设置及读取），候选的列表是psCitiesChina，默认是选第1个， 共6个候选值
    FlexMenu.addMenuValueList(2,"China Cities", mi1, 0, 6, psCitiesChina);
 
    //增加一个列表型参数，这个参数的名字叫“USA Cities”，id是 3（用于在运行时设置及读取），候选的列表是psCitiesUSA，默认是选第1个， 共4个候选值
    FlexMenu.addMenuValueList(3,"USA Cities", mi1, 0, 4, psCitiesUSA);
    
    mi1 = FlexMenu.addMenuItem("menu3 Animals", NULL);
    FlexMenu.addMenuValueList(4,"Animal Type", mi1, 0, 5, psAnimals);
    
    mi1 = FlexMenu.addMenuItem("MENU4", NULL);
    mi1 = FlexMenu.addMenuItem("MENU41", mi1);
    mi1 = FlexMenu.addMenuItem("MENU411", mi1);
    mi1 = FlexMenu.addMenuItem("MENU4111", mi1);
    mi1 = FlexMenu.addMenuItem("MENU41111", mi1);
    
    mi1 = FlexMenu.addMenuItem("menu5", NULL);
    mi1 = FlexMenu.addMenuItem("menu6", NULL);
    mi1 = FlexMenu.addMenuItem("menu7", NULL);
    mi1 = FlexMenu.addMenuItem("menu8", NULL);
    mi1 = FlexMenu.addMenuItem("menu9", NULL);
    mi1 = FlexMenu.addMenuItem("menu0", NULL);
    
    FlexMenu.addMenuValue(100,"value00", NULL, 9, 1000, 3);
    
    FlexMenu.init();
}
 
void setup()
{
    //Serial.begin (9600);
 
    FlexMenu.pU8G2 = &u8g2;
    FlexMenu.pageRow = 3;
    FlexMenu.attachDisplayTitle(fmOnDisplayTiltle);
    FlexMenu.attachDisplayContent(fmOnDisplayContent);
    FlexMenu.attachAdjustValueEvent(fmOnAdjustValueEvent);
    FlexMenu.attachOKValueEvent(fmOnOKValueEvent);
    
    initMenu();
    
    re.attachRotateEvent(reRotateEvent);
    re.setClickResetCount(true);
 
    u8g2.begin();
    attachInterrupt(0, Int0Event, CHANGE);
}
 
void loop()
{
    FlexMenu.display();
    
    if (re.isClick()){ FlexMenu.clickOK();};
}