Based upon the Meadow.Foundation project sample, MicroLayoutMenu.
This implments a Multi-level Menu System with menu Up/Down as well as [Select] (choose item and move to next menu level) and [Back] (go back one menu level).
Latest: Added a new project Hierarchical that has hierarchical menu navigation.
Selection determines the next menu level options.
MultiMenu just has cascading menus. The same at each level regardless.
Update 2: [Bug fix] Remove 2nd instantiation of menus that causes menu handlers to be called twice.
Update 1: [Bug Fix] App had been renamed so path to image needed change.
Update 1.1: Also Long Click (1.5s) on left resets menu to top level with no previous selections.
The WILDERNESS LABS Project Lab V3 board
- Previous repository: Meadow.ProjectLab.Extensions
- Original Meadow.ProjectLab MicroLayoutMenu Project
- As previous:
The original MicroLayoutMenu project has a bug that, if ShowMenuScreen is uncommented, the textual scxreen fails to be drawn.
- In
MeadowApp.cschange:
public override Task Run()
{
ShowDemoScreen();
//ShowMenuScreen();
return base.Run();
}- To:
public override Task Run()
{
ShowDemoScreen();
// Move to Menu after 5sec
Thread.Sleep(5000);
_screen.Controls.Clear(); // <-This IS needed!
ShowMenuScreen();
return base.Run();
}This implements the clearing of the Demo screen controls before the textual menu is drawn.
When it runs, the demo screen shows.
After a period the first level of the menu shows.
The blue buttons are, bottom right, used to navigate the menu. The top and bottom buttons are used to move up and down the menu. The right button is used to select an item and move to the next level. The left button is used to go back to the previous menu level. The Demo screen suggests this navigation scenario but the drawn buttons there aren't actionable.
When a menu item is selected, it is pushed onto the Stack with other data for that menu level. The menu is then cleared and the next level is drawn. When [Back] is selected and the previous menu level is redrawn, the previous menu menu data is recovered from the Stack and the item previously selected there is reselected.
The menu data is held in a List<MenuItem> and is defined in MenuItem.cs. The MenuData class defines the data for each menu level:
public class MenuData
{
public string Title { get; set; }
public string Items { get; set; }
}That is, there is a Title for each level as well as a CSV list of items for that level.
To add or remove menu levels, simply add instantiated MenuData items in the List<MenuData> in MenuData.cs, or remove them.
Each menu level requires a corresponding method in MultiMenu.cs to handle the menu level of the form:
private void Action3(object sender, EventArgs e)
{
int actionNo = 3;
int index = _menu.SelectedRow;
//Do Whatever for previous menu
MenuData md = AppSettings.MenuDataList[actionNo];
ShowMenuScreen(md.Title, md.Items, Action4);
}For each additional level, replace the 3 in the method code with the order for the level in the list, that is numbered from zero.
Any additional menu method need to be linked in the previous method via the last arguement in ShowMenuScreen(). In the case above, the next level is Action4.
Any functionality based upon a menu selection at a level would be inserted below //Do Whatever for previous menu in the next level method.