CSharp Console Menu

This library provides a way to quickly create the menu for your C# console app.

Overview

Classes

AbstractMenu

This is the abstract class you need to extend in your menus. It's constructor takes in a title which is displayed at the top of the menu. This should be called from your implementations constructor. Like so:

public MenuImplementation() : base("Menu Title") {}

Methods

• Init() this needs overridding in your implementations and is where you add the items to the menu.
• Display() this starts this menu. This only needs to be called on the root menu in your system, as all sub-menus are handled by this library.
• AddMenuItem(new MenuItem(id, description, subMenu or action)) this adds an item to the menu.
• AddHiddenMenuItem(new MenuItem(id, description, subMenu or action)) this is a helper method that adds a menu item, which is then hidden.
• UpdateMenuItems() this can be overriden per menu to update items based on changes to your application, such as showing hidden menu items if they're now needed.
• ShowMenuItem(id) this can be used to show hidden menu items, most commonly in the method above. This uses the unique id given to the menu item.
• HideMenuItem(id) this can be used to hide menu items.

MenuItem

This is the class used to define items for the menus in your system. It has two constructors one for if the item is a sub menu and another for if its an action. These should be called like this: new MenuItem(id, description, subMenu or action)

Methods

• Hide() which is used on menu items, to hide them from the list.
• Show() which is used on hidden menu items, to show them in the list.
• SetAsExitOption() which is used to set menu items as the exit option for a menu, either going to the parent menu, or exiting the application.

Example

Main Class

public class Program
{
    static void Main(string[] args)
    {
        var mainMenu = new MainMenu();
        mainMenu.Display();
    }
}

Main Menu Class

public class MainMenu extends AbstractMenu
{
    public MainMenu() : base("Welcome to the main menu") {}

    protected override void Init()
    {
        AddMenuItem(new MenuItem(100, "Exit menu").SetAsExitOption());
        AddMenuItem(new MenuItem(101, "Print Hello World", () => { Console.Writeln("Hello World!"); }));
    }
}

Output

Welcome to the main menu
0. Exit menu
1. Print Hello World
Select option: 1
Hello World!

Welcome to the main menu
0. Exit menu
1. Print Hello World
Select option: 0

Look in LibraryTest for a full example implementation of the library.