//
// Menu.cs: application menus and submenus
//
// Authors:
// Miguel de Icaza (miguel@gnome.org)
//
// TODO:
// Add accelerator support, but should also support chords (ShortCut in MenuItem)
// Allow menus inside menus
using System;
using NStack;
using System.Linq;
using System.Collections.Generic;
using System.Reflection;
namespace Terminal.Gui {
///
/// A menu item has a title, an associated help text, and an action to execute on activation.
///
public class MenuItem {
public MenuItem ()
{
Title = "";
Help = "";
}
///
/// Initializes a new .
///
/// Title for the menu item.
/// Help text to display.
/// Action to invoke when the menu item is activated.
/// Function to determine if the action can currently be executred.
public MenuItem (ustring title, string help, Action action, Func canExecute = null)
{
Title = title ?? "";
Help = help ?? "";
Action = action;
CanExecute = canExecute;
bool nextIsHot = false;
foreach (var x in Title) {
if (x == '_')
nextIsHot = true;
else {
if (nextIsHot) {
HotKey = Char.ToUpper ((char)x);
break;
}
nextIsHot = false;
}
}
}
///
/// Initializes a new .
///
/// Title for the menu item.
/// The menu sub-menu.
public MenuItem (ustring title, MenuBarItem subMenu) : this (title, "", null)
{
SubMenu = subMenu;
IsFromSubMenu = true;
}
//
//
///
/// The hotkey is used when the menu is active, the shortcut can be triggered when the menu is not active.
/// For example HotKey would be "N" when the File Menu is open (assuming there is a "_New" entry
/// if the ShortCut is set to "Control-N", this would be a global hotkey that would trigger as well
///
public Rune HotKey;
///
/// This is the global setting that can be used as a global shortcut to invoke the action on the menu.
///
public Key ShortCut;
///
/// Gets or sets the title.
///
/// The title.
public ustring Title { get; set; }
///
/// Gets or sets the help text for the menu item.
///
/// The help text.
public ustring Help { get; set; }
///
/// Gets or sets the action to be invoked when the menu is triggered
///
/// Method to invoke.
public Action Action { get; set; }
///
/// Gets or sets the action to be invoked if the menu can be triggered
///
/// Function to determine if action is ready to be executed.
public Func CanExecute { get; set; }
///
/// Shortcut to check if the menu item is enabled
///
public bool IsEnabled ()
{
return CanExecute == null ? true : CanExecute ();
}
internal int Width => Title.Length + Help.Length + 1 + 2;
///
/// Gets or sets the parent for this MenuBarItem
///
/// The parent.
internal MenuBarItem SubMenu { get; set; }
internal bool IsFromSubMenu { get; set; }
///
/// Merely a debugging aid to see the interaction with main
///
public MenuItem GetMenuItem ()
{
return this;
}
///
/// Merely a debugging aid to see the interaction with main
///
public bool GetMenuBarItem ()
{
return IsFromSubMenu;
}
}
///
/// A menu bar item contains other menu items.
///
public class MenuBarItem : MenuItem {
///
/// Initializes a new as a .
///
/// Title for the menu item.
/// Help text to display.
/// Action to invoke when the menu item is activated.
/// Function to determine if the action can currently be executred.
public MenuBarItem (ustring title, string help, Action action, Func canExecute = null) : base (title, help, action, canExecute)
{
SetTitle (title ?? "");
Children = null;
}
///
/// Initializes a new .
///
/// Title for the menu item.
/// The items in the current menu.
public MenuBarItem (ustring title, MenuItem [] children)
{
SetTitle (title ?? "");
Children = children;
}
///
/// Initializes a new .
///
/// The items in the current menu.
public MenuBarItem (MenuItem [] children) : this (new string (' ', GetMaxTitleLength (children)), children)
{
}
static int GetMaxTitleLength (MenuItem [] children)
{
int maxLength = 0;
foreach (var item in children) {
int len = GetMenuBarItemLength (item.Title);
if (len > maxLength)
maxLength = len;
item.IsFromSubMenu = true;
}
return maxLength;
}
void SetTitle (ustring title)
{
if (title == null)
title = "";
Title = title;
TitleLength = GetMenuBarItemLength (Title);
}
static int GetMenuBarItemLength (ustring title)
{
int len = 0;
foreach (var ch in title) {
if (ch == '_')
continue;
len++;
}
return len;
}
///
/// Gets or sets the title to display.
///
/// The title.
//public ustring Title { get; set; }
///
/// Gets or sets the children for this MenuBarItem
///
/// The children.
public MenuItem [] Children { get; set; }
internal int TitleLength { get; private set; }
internal bool IsTopLevel { get => (Children == null || Children.Length == 0); }
}
class Menu : View {
internal MenuBarItem barItems;
MenuBar host;
internal int current;
internal View previousSubFocused;
static Rect MakeFrame (int x, int y, MenuItem [] items)
{
if (items == null || items.Length == 0) {
return new Rect ();
}
int maxW = items.Max (z => z?.Width) ?? 0;
return new Rect (x, y, maxW + 2, items.Length + 2);
}
public Menu (MenuBar host, int x, int y, MenuBarItem barItems) : base (MakeFrame (x, y, barItems.Children))
{
this.barItems = barItems;
this.host = host;
if (barItems.IsTopLevel) {
// This is a standalone MenuItem on a MenuBar
ColorScheme = Colors.Menu;
CanFocus = true;
} else {
current = -1;
for (int i = 0; i < barItems.Children.Length; i++) {
if (barItems.Children [i] != null) {
current = i;
break;
}
}
ColorScheme = Colors.Menu;
CanFocus = true;
WantMousePositionReports = host.WantMousePositionReports;
}
}
internal Attribute DetermineColorSchemeFor (MenuItem item, int index)
{
if (item != null) {
if (index == current) return ColorScheme.Focus;
if (!item.IsEnabled ()) return ColorScheme.Disabled;
}
return ColorScheme.Normal;
}
public override void Redraw (Rect region)
{
Driver.SetAttribute (ColorScheme.Normal);
DrawFrame (region, padding: 0, fill: true);
for (int i = 0; i < barItems.Children.Length; i++) {
var item = barItems.Children [i];
Driver.SetAttribute (item == null ? ColorScheme.Normal : i == current ? ColorScheme.Focus : ColorScheme.Normal);
if (item == null) {
Move (0, i + 1);
Driver.AddRune (Driver.LeftTee);
} else
Move (1, i + 1);
Driver.SetAttribute (DetermineColorSchemeFor (item, i));
for (int p = 0; p < Frame.Width - 2; p++)
if (item == null)
Driver.AddRune (Driver.HLine);
else if (p == Frame.Width - 3 && barItems.Children [i].SubMenu != null)
Driver.AddRune ('>');
else
Driver.AddRune (' ');
if (item == null) {
Move (Frame.Right - 1, i + 1);
Driver.AddRune (Driver.RightTee);
continue;
}
Move (2, i + 1);
if (!item.IsEnabled ())
DrawHotString (item.Title, ColorScheme.Disabled, ColorScheme.Disabled);
else
DrawHotString (item.Title,
i == current ? ColorScheme.HotFocus : ColorScheme.HotNormal,
i == current ? ColorScheme.Focus : ColorScheme.Normal);
// The help string
var l = item.Help.Length;
Move (Frame.Width - l - 2, 1 + i);
Driver.AddStr (item.Help);
}
PositionCursor ();
}
public override void PositionCursor ()
{
if (host == null || !host.isMenuClosed)
if (barItems.IsTopLevel) {
host.PositionCursor ();
} else
Move (2, 1 + current);
else
host.PositionCursor ();
}
public void Run (Action action)
{
if (action == null)
return;
Application.UngrabMouse ();
host.CloseAllMenus ();
Application.Refresh ();
Application.MainLoop.AddIdle (() => {
action ();
return false;
});
}
public override bool ProcessKey (KeyEvent kb)
{
bool disabled;
switch (kb.Key) {
case Key.CursorUp:
if (barItems.IsTopLevel || current == -1)
break;
do {
disabled = false;
current--;
if (host.UseKeysUpDownAsKeysLeftRight) {
if (current == -1 && barItems.Children [current + 1].IsFromSubMenu && host.selectedSub > -1) {
current++;
host.PreviousMenu (true);
break;
}
}
if (current < 0)
current = barItems.Children.Length - 1;
var item = barItems.Children [current];
if (item == null || !item.IsEnabled ()) disabled = true;
} while (barItems.Children [current] == null || disabled);
SetNeedsDisplay ();
break;
case Key.CursorDown:
if (barItems.IsTopLevel) {
break;
}
do {
current++;
disabled = false;
if (current == barItems.Children.Length)
current = 0;
var item = barItems.Children [current];
if (item == null || !item.IsEnabled ()) disabled = true;
if (host.UseKeysUpDownAsKeysLeftRight && barItems.Children [current]?.SubMenu != null &&
!disabled && !host.isMenuClosed) {
CheckSubMenu ();
break;
}
if (host.isMenuClosed)
host.OpenMenu (host.selected);
} while (barItems.Children [current] == null || disabled);
SetNeedsDisplay ();
break;
case Key.CursorLeft:
host.PreviousMenu (true);
break;
case Key.CursorRight:
host.NextMenu (barItems.IsTopLevel || barItems.Children [current].IsFromSubMenu ? true : false);
break;
case Key.Esc:
Application.UngrabMouse ();
host.CloseAllMenus ();
break;
case Key.Enter:
if (barItems.IsTopLevel) {
Run (barItems.Action);
} else {
CheckSubMenu ();
Run (barItems.Children [current].Action);
}
break;
default:
// TODO: rune-ify
if (barItems.Children != null && Char.IsLetterOrDigit ((char)kb.KeyValue)) {
var x = Char.ToUpper ((char)kb.KeyValue);
foreach (var item in barItems.Children) {
if (item == null) continue;
if (item.IsEnabled () && item.HotKey == x) {
host.CloseMenu ();
Run (item.Action);
return true;
}
}
}
break;
}
return true;
}
public override bool MouseEvent (MouseEvent me)
{
if (!host.handled && !host.HandleGrabView (me, this)) {
return false;
}
host.handled = false;
bool disabled;
if (me.Flags == MouseFlags.Button1Clicked || me.Flags == MouseFlags.Button1Released) {
disabled = false;
if (me.Y < 1)
return true;
var meY = me.Y - 1;
if (meY >= barItems.Children.Length)
return true;
var item = barItems.Children [meY];
if (item == null || !item.IsEnabled ()) disabled = true;
if (item != null && !disabled)
Run (barItems.Children [meY].Action);
return true;
} else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.ReportMousePosition) {
disabled = false;
if (me.Y < 1)
return true;
if (me.Y - 1 >= barItems.Children.Length)
return true;
var item = barItems.Children [me.Y - 1];
if (item == null || !item.IsEnabled ()) disabled = true;
if (item != null && !disabled)
current = me.Y - 1;
HasFocus = true;
SetNeedsDisplay ();
CheckSubMenu ();
return true;
}
return false;
}
internal void CheckSubMenu ()
{
if (barItems.Children [current] == null)
return;
var subMenu = barItems.Children [current].SubMenu;
if (subMenu != null) {
int pos = -1;
if (host.openSubMenu != null)
pos = host.openSubMenu.FindIndex (o => o?.barItems == subMenu);
host.Activate (host.selected, pos, subMenu);
} else if (host.openSubMenu != null && !barItems.Children [current].IsFromSubMenu)
host.CloseMenu (false, true);
}
int GetSubMenuIndex (MenuBarItem subMenu)
{
int pos = -1;
if (this != null && Subviews.Count > 0) {
Menu v = null;
foreach (var menu in Subviews) {
if (((Menu)menu).barItems == subMenu)
v = (Menu)menu;
}
if (v != null)
pos = Subviews.IndexOf (v);
}
return pos;
}
}
///
/// A menu bar for your application.
///
public class MenuBar : View {
///
/// The menus that were defined when the menubar was created. This can be updated if the menu is not currently visible.
///
/// The menu array.
public MenuBarItem [] Menus { get; set; }
internal int selected;
internal int selectedSub;
Action action;
///
/// Used for change the navigation key style.
///
public bool UseKeysUpDownAsKeysLeftRight { get; set; } = true;
///
/// Initializes a new instance of the class with the specified set of toplevel menu items.
///
/// Individual menu items, if one of those contains a null, then a separator is drawn.
public MenuBar (MenuBarItem [] menus) : base ()
{
X = 0;
Y = 0;
Width = Dim.Fill ();
Height = 1;
Menus = menus;
CanFocus = true;
selected = -1;
selectedSub = -1;
ColorScheme = Colors.Menu;
WantMousePositionReports = true;
isMenuClosed = true;
}
public override bool KeyDown (KeyEvent keyEvent)
{
if (keyEvent.IsAlt) {
openedByHotKey = false;
}
return false;
}
///
/// Track Alt key-up events. On Windows, when a user releases Alt (without another key), the menu gets focus but doesn't open.
/// We mimic that behavior here.
///
///
///
public override bool KeyUp (KeyEvent keyEvent)
{
if (keyEvent.IsAlt) {
// User pressed Alt - this may be a precursor to a menu accellerator (e.g. Alt-F)
if (openMenu == null) {
// There's no open menu, the first menu item should be highlight.
// The right way to do this is to SetFocus(MenuBar), but for some reason
// that faults.
Activate (0);
SetNeedsDisplay ();
} else {
// There's an open menu. If this Alt key-up is a pre-cursor to an acellerator
// we don't want to close the menu because it'll flash.
// How to deal with that?
if (!openedByHotKey) {
CloseAllMenus ();
}
}
return true;
}
return false;
}
public override void Redraw (Rect region)
{
Move (0, 0);
Driver.SetAttribute (Colors.Menu.Normal);
for (int i = 0; i < Frame.Width; i++)
Driver.AddRune (' ');
Move (1, 0);
int pos = 1;
for (int i = 0; i < Menus.Length; i++) {
var menu = Menus [i];
Move (pos, 0);
Attribute hotColor, normalColor;
if (i == selected) {
hotColor = i == selected ? ColorScheme.HotFocus : ColorScheme.HotNormal;
normalColor = i == selected ? ColorScheme.Focus : ColorScheme.Normal;
} else {
hotColor = ColorScheme.HotNormal;
normalColor = ColorScheme.Normal;
}
DrawHotString ($" {menu.Title} ", hotColor, normalColor);
pos += 1 + menu.TitleLength + 2;
}
PositionCursor ();
}
public override void PositionCursor ()
{
int pos = 0;
for (int i = 0; i < Menus.Length; i++) {
if (i == selected) {
pos++;
if (!isMenuClosed)
Move (pos + 1, 0);
else
Move (pos + 1, 0);
return;
} else {
if (!isMenuClosed)
pos += 1 + Menus [i].TitleLength + 2;
else
pos += 2 + Menus [i].TitleLength + 1;
}
}
//Move (0, 0);
}
void Selected (MenuItem item)
{
// TODO: Running = false;
action = item.Action;
}
public event EventHandler OnOpenMenu;
public event EventHandler OnCloseMenu;
internal Menu openMenu;
Menu openCurrentMenu;
internal List