Files
Terminal.Gui/Terminal.Gui/Views/Menu.cs
2020-11-25 23:09:09 +00:00

1597 lines
43 KiB
C#
Raw Blame History

//
// 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;
namespace Terminal.Gui {
/// <summary>
/// Specifies how a <see cref="MenuItem"/> shows selection state.
/// </summary>
[Flags]
public enum MenuItemCheckStyle {
/// <summary>
/// The menu item will be shown normally, with no check indicator.
/// </summary>
NoCheck = 0b_0000_0000,
/// <summary>
/// The menu item will indicate checked/un-checked state (see <see cref="Checked"/>.
/// </summary>
Checked = 0b_0000_0001,
/// <summary>
/// The menu item is part of a menu radio group (see <see cref="Checked"/> and will indicate selected state.
/// </summary>
Radio = 0b_0000_0010,
};
/// <summary>
/// A <see cref="MenuItem"/> has a title, an associated help text, and an action to execute on activation.
/// </summary>
public class MenuItem {
ustring title;
ShortcutHelper shortcutHelper;
/// <summary>
/// Initializes a new instance of <see cref="MenuItem"/>
/// </summary>
public MenuItem (Key shortcut = Key.Null)
{
Title = "";
Help = "";
shortcutHelper = new ShortcutHelper ();
if (shortcut != Key.Null) {
shortcutHelper.Shortcut = shortcut;
}
}
/// <summary>
/// Initializes a new instance of <see cref="MenuItem"/>.
/// </summary>
/// <param name="title">Title for the menu item.</param>
/// <param name="help">Help text to display.</param>
/// <param name="action">Action to invoke when the menu item is activated.</param>
/// <param name="canExecute">Function to determine if the action can currently be executed.</param>
/// <param name="parent">The <see cref="Parent"/> of this menu item.</param>
/// <param name="shortcut">The <see cref="Shortcut"/> keystroke combination.</param>
public MenuItem (ustring title, ustring help, Action action, Func<bool> canExecute = null, MenuItem parent = null, Key shortcut = Key.Null)
{
Title = title ?? "";
Help = help ?? "";
Action = action;
CanExecute = canExecute;
Parent = parent;
shortcutHelper = new ShortcutHelper ();
if (shortcut != Key.Null) {
shortcutHelper.Shortcut = shortcut;
}
}
/// <summary>
/// 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
/// </summary>
public Rune HotKey;
/// <summary>
/// This is the global setting that can be used as a global <see cref="ShortcutHelper.Shortcut"/> to invoke the action on the menu.
/// </summary>
public Key Shortcut {
get => shortcutHelper.Shortcut;
set {
if (shortcutHelper.Shortcut != value && (ShortcutHelper.PostShortcutValidation (value) || value == Key.Null)) {
shortcutHelper.Shortcut = value;
}
}
}
/// <summary>
/// The keystroke combination used in the <see cref="ShortcutHelper.ShortcutTag"/> as string.
/// </summary>
public ustring ShortcutTag => ShortcutHelper.GetShortcutTag (shortcutHelper.Shortcut);
/// <summary>
/// Gets or sets the title.
/// </summary>
/// <value>The title.</value>
public ustring Title {
get { return title; }
set {
if (title != value) {
title = value;
GetHotKey ();
}
}
}
/// <summary>
/// Gets or sets the help text for the menu item.
/// </summary>
/// <value>The help text.</value>
public ustring Help { get; set; }
/// <summary>
/// Gets or sets the action to be invoked when the menu is triggered
/// </summary>
/// <value>Method to invoke.</value>
public Action Action { get; set; }
/// <summary>
/// Gets or sets the action to be invoked if the menu can be triggered
/// </summary>
/// <value>Function to determine if action is ready to be executed.</value>
public Func<bool> CanExecute { get; set; }
/// <summary>
/// Shortcut to check if the menu item is enabled
/// </summary>
public bool IsEnabled ()
{
return CanExecute == null ? true : CanExecute ();
}
internal int Width => Title.RuneCount + Help.RuneCount + 1 + 2 +
(Checked || CheckType.HasFlag (MenuItemCheckStyle.Checked) || CheckType.HasFlag (MenuItemCheckStyle.Radio) ? 2 : 0) +
(ShortcutTag.RuneCount > 0 ? ShortcutTag.RuneCount + 2 : 0);
/// <summary>
/// Sets or gets whether the <see cref="MenuItem"/> shows a check indicator or not. See <see cref="MenuItemCheckStyle"/>.
/// </summary>
public bool Checked { set; get; }
/// <summary>
/// Sets or gets the type selection indicator the menu item will be displayed with.
/// </summary>
public MenuItemCheckStyle CheckType { get; set; }
/// <summary>
/// Gets or sets the parent for this <see cref="MenuItem"/>.
/// </summary>
/// <value>The parent.</value>
public MenuItem Parent { get; internal set; }
/// <summary>
/// Gets if this <see cref="MenuItem"/> is from a sub-menu.
/// </summary>
internal bool IsFromSubMenu { get {return Parent != null; } }
/// <summary>
/// Merely a debugging aid to see the interaction with main
/// </summary>
public MenuItem GetMenuItem ()
{
return this;
}
/// <summary>
/// Merely a debugging aid to see the interaction with main
/// </summary>
public bool GetMenuBarItem ()
{
return IsFromSubMenu;
}
void GetHotKey ()
{
bool nextIsHot = false;
foreach (var x in title) {
if (x == '_') {
nextIsHot = true;
} else {
if (nextIsHot) {
HotKey = Char.ToUpper ((char)x);
break;
}
nextIsHot = false;
HotKey = default;
}
}
}
}
/// <summary>
/// A <see cref="MenuBarItem"/> contains <see cref="MenuBarItem"/>s or <see cref="MenuItem"/>s.
/// </summary>
public class MenuBarItem : MenuItem {
/// <summary>
/// Initializes a new <see cref="MenuBarItem"/> as a <see cref="MenuItem"/>.
/// </summary>
/// <param name="title">Title for the menu item.</param>
/// <param name="help">Help text to display.</param>
/// <param name="action">Action to invoke when the menu item is activated.</param>
/// <param name="canExecute">Function to determine if the action can currently be executed.</param>
/// <param name="parent">The parent <see cref="MenuItem"/> of this if exist, otherwise is null.</param>
public MenuBarItem (ustring title, ustring help, Action action, Func<bool> canExecute = null, MenuItem parent = null) : base (title, help, action, canExecute, parent)
{
SetTitle (title ?? "");
Children = null;
}
/// <summary>
/// Initializes a new <see cref="MenuBarItem"/>.
/// </summary>
/// <param name="title">Title for the menu item.</param>
/// <param name="children">The items in the current menu.</param>
/// <param name="parent">The parent <see cref="MenuItem"/> of this if exist, otherwise is null.</param>
public MenuBarItem (ustring title, MenuItem [] children, MenuItem parent = null)
{
if (children == null) {
throw new ArgumentNullException (nameof (children), "The parameter cannot be null. Use an empty array instead.");
}
SetTitle (title ?? "");
if (parent != null) {
Parent = parent;
}
SetChildrensParent (children);
Children = children;
}
/// <summary>
/// Initializes a new <see cref="MenuBarItem"/>.
/// </summary>
/// <param name="children">The items in the current menu.</param>
public MenuBarItem (MenuItem [] children) : this ("", children) { }
/// <summary>
/// Initializes a new <see cref="MenuBarItem"/>.
/// </summary>
public MenuBarItem () : this (children: new MenuItem [] { }) { }
//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 SetChildrensParent (MenuItem [] childrens)
{
foreach (var child in childrens) {
if (child != null && child.Parent == null) {
child.Parent = this;
}
}
}
/// <summary>
/// Check if the children parameter is a <see cref="MenuBarItem"/>.
/// </summary>
/// <param name="children"></param>
/// <returns>Returns a <see cref="MenuBarItem"/> or null otherwise.</returns>
public MenuBarItem SubMenu (MenuItem children)
{
return children as MenuBarItem;
}
/// <summary>
/// Check if the <see cref="MenuItem"/> parameter is a child of this.
/// </summary>
/// <param name="menuItem"></param>
/// <returns>Returns <c>true</c> if it is a child of this. <c>false</c> otherwise.</returns>
public bool IsSubMenuOf (MenuItem menuItem)
{
foreach (var child in Children) {
if (child == menuItem && child.Parent == menuItem.Parent) {
return true;
}
}
return false;
}
/// <summary>
/// Get the index of the <see cref="MenuItem"/> parameter.
/// </summary>
/// <param name="children"></param>
/// <returns>Returns a value bigger than -1 if the <see cref="MenuItem"/> is a child of this.</returns>
public int GetChildrenIndex (MenuItem children)
{
if (Children?.Length == 0) {
return -1;
}
int i = 0;
foreach (var child in Children) {
if (child == children) {
return i;
}
i++;
}
return -1;
}
void SetTitle (ustring title)
{
if (title == null)
title = "";
Title = title;
}
int GetMenuBarItemLength (ustring title)
{
int len = 0;
foreach (var ch in title) {
if (ch == '_')
continue;
len++;
}
return len;
}
///// <summary>
///// Gets or sets the title to display.
///// </summary>
///// <value>The title.</value>
//public ustring Title { get; set; }
/// <summary>
/// Gets or sets an array of <see cref="MenuItem"/> objects that are the children of this <see cref="MenuBarItem"/>
/// </summary>
/// <value>The children.</value>
public MenuItem [] Children { get; set; }
internal int TitleLength => GetMenuBarItemLength (Title);
internal bool IsTopLevel { get => Parent == null && (Children == null || Children.Length == 0) && Action != null; }
}
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 bounds)
{
Driver.SetAttribute (ColorScheme.Normal);
DrawFrame (bounds, 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.SubMenu(barItems.Children [i]) != null)
Driver.AddRune (Driver.RightArrow);
else
Driver.AddRune (' ');
if (item == null) {
Move (Frame.Right - 1, i + 1);
Driver.AddRune (Driver.RightTee);
continue;
}
ustring textToDraw;
var checkChar = Driver.Selected;
var uncheckedChar = Driver.UnSelected;
if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked)) {
checkChar = Driver.Checked;
uncheckedChar = Driver.UnChecked;
}
// Support Checked even though CheckType wasn't set
if (item.Checked) {
textToDraw = ustring.Make (new Rune [] { checkChar, ' ' }) + item.Title;
} else if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked) || item.CheckType.HasFlag (MenuItemCheckStyle.Radio)) {
textToDraw = ustring.Make (new Rune [] { uncheckedChar, ' ' }) + item.Title;
} else {
textToDraw = item.Title;
}
Move (2, i + 1);
if (!item.IsEnabled ())
DrawHotString (textToDraw, ColorScheme.Disabled, ColorScheme.Disabled);
else
DrawHotString (textToDraw,
i == current ? ColorScheme.HotFocus : ColorScheme.HotNormal,
i == current ? ColorScheme.Focus : ColorScheme.Normal);
// The help string
var l = item.ShortcutTag.RuneCount == 0 ? item.Help.RuneCount : item.Help.RuneCount + item.ShortcutTag.RuneCount + 2;
Move (Frame.Width - l - 2, 1 + i);
Driver.AddStr (item.Help);
// The shortcut tag string
if (!item.ShortcutTag.IsEmpty) {
l = item.ShortcutTag.RuneCount;
Move (Frame.Width - l - 2, 1 + i);
Driver.AddStr (item.ShortcutTag);
}
}
PositionCursor ();
}
public override void PositionCursor ()
{
if (host == null || host.IsMenuOpen)
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 OnLeave (View view)
{
return host.OnLeave (view);
}
public override bool OnKeyDown (KeyEvent keyEvent)
{
if (keyEvent.IsAlt) {
host.CloseAllMenus ();
return true;
}
return false;
}
public override bool ProcessHotKey (KeyEvent keyEvent)
{
// To ncurses simulate a AltMask key pressing Alt+Space because
// it can<61>t detect an alone special key down was pressed.
if (keyEvent.IsAlt && keyEvent.Key == Key.AltMask) {
OnKeyDown (keyEvent);
return true;
}
return false;
}
public override bool ProcessKey (KeyEvent kb)
{
switch (kb.Key) {
case Key.Tab:
host.CleanUp ();
return true;
case Key.CursorUp:
return MoveUp ();
case Key.CursorDown:
return MoveDown ();
case Key.CursorLeft:
host.PreviousMenu (true);
return true;
case Key.CursorRight:
host.NextMenu (barItems.IsTopLevel || (barItems.Children != null && current > -1 && current < barItems.Children.Length && barItems.Children [current].IsFromSubMenu) ? true : false);
return true;
case Key.Esc:
Application.UngrabMouse ();
host.CloseAllMenus ();
return true;
case Key.Enter:
if (barItems.IsTopLevel) {
Run (barItems.Action);
} else if (current > -1) {
Run (barItems.Children [current].Action);
}
return true;
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 false;
}
bool MoveDown ()
{
if (barItems.IsTopLevel) {
return true;
}
bool disabled;
do {
current++;
if (current >= barItems.Children.Length) {
current = 0;
}
if (this != host.openCurrentMenu && barItems.Children [current].IsFromSubMenu && host.selectedSub > -1) {
host.PreviousMenu (true);
host.SelectEnabledItem (barItems.Children, current, out current);
host.openCurrentMenu = this;
}
var item = barItems.Children [current];
if (item?.IsEnabled () != true) {
disabled = true;
} else {
disabled = false;
}
if (host.UseKeysUpDownAsKeysLeftRight && barItems.SubMenu (barItems.Children [current]) != null &&
!disabled && host.IsMenuOpen) {
CheckSubMenu ();
break;
}
if (!host.IsMenuOpen) {
host.OpenMenu (host.selected);
}
} while (barItems.Children [current] == null || disabled);
SetNeedsDisplay ();
return true;
}
bool MoveUp ()
{
if (barItems.IsTopLevel || current == -1) {
return true;
}
bool disabled;
do {
current--;
if (host.UseKeysUpDownAsKeysLeftRight) {
if ((current == -1 || this != host.openCurrentMenu) && barItems.Children [current + 1].IsFromSubMenu && host.selectedSub > -1) {
current++;
host.PreviousMenu (true);
if (current > 0) {
current--;
host.openCurrentMenu = this;
}
break;
}
}
if (current < 0)
current = barItems.Children.Length - 1;
if (!host.SelectEnabledItem (barItems.Children, current, out current, false)) {
current = 0;
if (!host.SelectEnabledItem (barItems.Children, current, out current)) {
host.CloseMenu ();
}
break;
}
var item = barItems.Children [current];
if (item?.IsEnabled () != true) {
disabled = true;
} else {
disabled = false;
}
if (host.UseKeysUpDownAsKeysLeftRight && barItems.SubMenu (barItems.Children [current]) != null &&
!disabled && host.IsMenuOpen) {
CheckSubMenu ();
break;
}
} while (barItems.Children [current] == null || disabled);
SetNeedsDisplay ();
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) {
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.Button1DoubleClicked ||
me.Flags == MouseFlags.Button1TripleClicked || me.Flags == MouseFlags.ReportMousePosition ||
me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition)) {
disabled = false;
if (me.Y < 1 || 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;
CheckSubMenu ();
return true;
}
return false;
}
internal void CheckSubMenu ()
{
if (current == -1 || barItems.Children [current] == null) {
return;
}
var subMenu = barItems.SubMenu (barItems.Children [current]);
if (subMenu != null) {
int pos = -1;
if (host.openSubMenu != null) {
pos = host.openSubMenu.FindIndex (o => o?.barItems == subMenu);
}
if (pos == -1 && this != host.openCurrentMenu && subMenu.Children != host.openCurrentMenu.barItems.Children) {
host.CloseMenu (false, true);
}
host.Activate (host.selected, pos, subMenu);
} else if (host.openSubMenu?.Last ().barItems.IsSubMenuOf (barItems.Children [current]) == false) {
host.CloseMenu (false, true);
} else {
SetNeedsDisplay ();
}
}
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;
}
}
/// <summary>
/// The MenuBar provides a menu for Terminal.Gui applications.
/// </summary>
/// <remarks>
/// <para>
/// The <see cref="MenuBar"/> appears on the first row of the terminal.
/// </para>
/// <para>
/// The <see cref="MenuBar"/> provides global hotkeys for the application.
/// </para>
/// </remarks>
public class MenuBar : View {
/// <summary>
/// Gets or sets the array of <see cref="MenuBarItem"/>s for the menu. Only set this when the <see cref="MenuBar"/> is vislble.
/// </summary>
/// <value>The menu array.</value>
public MenuBarItem [] Menus { get; set; }
internal int selected;
internal int selectedSub;
Action action;
/// <summary>
/// Used for change the navigation key style.
/// </summary>
public bool UseKeysUpDownAsKeysLeftRight { get; set; } = true;
static ustring shortcutDelimiter = "+";
/// <summary>
/// Used for change the shortcut delimiter separator.
/// </summary>
public static ustring ShortcutDelimiter {
get => shortcutDelimiter;
set {
if (shortcutDelimiter != value) {
shortcutDelimiter = value == ustring.Empty ? " " : value;
}
}
}
/// <summary>
/// Initializes a new instance of the <see cref="MenuBar"/>.
/// </summary>
public MenuBar () : this (new MenuBarItem [] { }) { }
/// <summary>
/// Initializes a new instance of the <see cref="MenuBar"/> class with the specified set of toplevel menu items.
/// </summary>
/// <param name="menus">Individual menu items; a null item will result in a separator being drawn.</param>
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;
IsMenuOpen = false;
}
bool openedByAltKey;
bool isCleaning;
///<inheritdoc/>
public override bool OnLeave (View view)
{
if ((!(view is MenuBar) && !(view is Menu) || !(view is MenuBar) && !(view is Menu) && openMenu != null) && !isCleaning && !reopen) {
CleanUp ();
return true;
}
return false;
}
///<inheritdoc/>
public override bool OnKeyDown (KeyEvent keyEvent)
{
if (keyEvent.IsAlt) {
openedByAltKey = true;
SetNeedsDisplay ();
openedByHotKey = false;
}
return false;
}
///<inheritdoc/>
public override bool OnKeyUp (KeyEvent keyEvent)
{
if (keyEvent.IsAlt) {
// User pressed Alt - this may be a precursor to a menu accelerator (e.g. Alt-F)
if (!keyEvent.IsCtrl && openedByAltKey && !IsMenuOpen && openMenu == null && ((uint)keyEvent.Key & (uint)Key.CharMask) == 0) {
// 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);
//StartMenu ();
IsMenuOpen = true;
selected = 0;
CanFocus = true;
lastFocused = SuperView.MostFocused;
SetFocus ();
SetNeedsDisplay ();
Application.GrabMouse (this);
} else if (!openedByHotKey) {
// There's an open menu. If this Alt key-up is a pre-cursor to an accelerator
// we don't want to close the menu because it'll flash.
// How to deal with that?
CleanUp ();
}
return true;
}
return false;
}
internal void CleanUp ()
{
isCleaning = true;
if (openMenu != null) {
CloseAllMenus ();
}
openedByAltKey = false;
IsMenuOpen = false;
selected = -1;
CanFocus = false;
if (lastFocused != null) {
lastFocused.SetFocus ();
}
SetNeedsDisplay ();
Application.UngrabMouse ();
isCleaning = false;
}
///<inheritdoc/>
public override void Redraw (Rect bounds)
{
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 if (openedByAltKey) {
hotColor = ColorScheme.HotNormal;
normalColor = ColorScheme.Normal;
} else {
hotColor = ColorScheme.Normal;
normalColor = ColorScheme.Normal;
}
DrawHotString (menu.Help.IsEmpty ? $" {menu.Title} " : $" {menu.Title} {menu.Help} ", hotColor, normalColor);
pos += 1 + menu.TitleLength + (menu.Help.Length > 0 ? menu.Help.Length + 2 : 0) + 2;
}
PositionCursor ();
}
///<inheritdoc/>
public override void PositionCursor ()
{
int pos = 0;
for (int i = 0; i < Menus.Length; i++) {
if (i == selected) {
pos++;
if (IsMenuOpen)
Move (pos + 1, 0);
else {
Move (pos + 1, 0);
}
return;
} else if (IsMenuOpen) {
pos += 1 + Menus [i].TitleLength + (Menus [i].Help.Length > 0 ? Menus [i].Help.Length + 2 : 0) + 2;
} else {
pos += 2 + Menus [i].TitleLength + (Menus [i].Help.Length > 0 ? Menus [i].Help.Length + 2 : 0) + 1;
}
}
//Move (0, 0);
}
void Selected (MenuItem item)
{
// TODO: Running = false;
action = item.Action;
}
/// <summary>
/// Raised as a menu is opening.
/// </summary>
public event Action MenuOpening;
/// <summary>
/// Raised when a menu is closing.
/// </summary>
public event Action MenuClosing;
internal Menu openMenu;
internal Menu openCurrentMenu;
internal List<Menu> openSubMenu;
View previousFocused;
internal bool isMenuOpening;
internal bool isMenuClosing;
/// <summary>
/// True if the menu is open; otherwise false.
/// </summary>
public bool IsMenuOpen { get; protected set; }
/// <summary>
/// Virtual method that will invoke the <see cref="MenuOpening"/>
/// </summary>
public virtual void OnMenuOpening ()
{
MenuOpening?.Invoke ();
}
/// <summary>
/// Virtual method that will invoke the <see cref="MenuClosing"/>
/// </summary>
public virtual void OnMenuClosing ()
{
MenuClosing?.Invoke ();
}
View lastFocused;
/// <summary>
/// Get the lasted focused view before open the menu.
/// </summary>
public View LastFocused { get; private set; }
internal void OpenMenu (int index, int sIndex = -1, MenuBarItem subMenu = null)
{
isMenuOpening = true;
OnMenuOpening ();
int pos = 0;
switch (subMenu) {
case null:
lastFocused = lastFocused ?? SuperView.MostFocused;
if (openSubMenu != null)
CloseMenu (false, true);
if (openMenu != null) {
SuperView.Remove (openMenu);
openMenu.Dispose ();
}
for (int i = 0; i < index; i++)
pos += Menus [i].Title.RuneCount + (Menus [i].Help.RuneCount > 0 ? Menus [i].Help.RuneCount + 2 : 0) + 2;
openMenu = new Menu (this, pos, 1, Menus [index]);
openCurrentMenu = openMenu;
openCurrentMenu.previousSubFocused = openMenu;
SuperView.Add (openMenu);
openMenu.SetFocus ();
break;
default:
if (openSubMenu == null)
openSubMenu = new List<Menu> ();
if (sIndex > -1) {
RemoveSubMenu (sIndex);
} else {
var last = openSubMenu.Count > 0 ? openSubMenu.Last () : openMenu;
openCurrentMenu = new Menu (this, last.Frame.Left + last.Frame.Width, last.Frame.Top + 1 + last.current, subMenu);
openCurrentMenu.previousSubFocused = last.previousSubFocused;
openSubMenu.Add (openCurrentMenu);
SuperView.Add (openCurrentMenu);
}
selectedSub = openSubMenu.Count - 1;
if (selectedSub > -1 && SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current)) {
openCurrentMenu.SetFocus ();
}
break;
}
isMenuOpening = false;
IsMenuOpen = true;
}
/// <summary>
/// Opens the current Menu programatically.
/// </summary>
public void OpenMenu ()
{
if (openMenu != null)
return;
selected = 0;
SetNeedsDisplay ();
previousFocused = SuperView.Focused;
OpenMenu (selected);
if (!SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current)) {
CloseMenu ();
}
openCurrentMenu.CheckSubMenu ();
Application.GrabMouse (this);
}
// Activates the menu, handles either first focus, or activating an entry when it was already active
// For mouse events.
internal void Activate (int idx, int sIdx = -1, MenuBarItem subMenu = null)
{
selected = idx;
selectedSub = sIdx;
if (openMenu == null)
previousFocused = SuperView.Focused;
OpenMenu (idx, sIdx, subMenu);
if (!SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current)) {
if (subMenu == null) {
CloseMenu ();
}
}
SetNeedsDisplay ();
}
internal bool SelectEnabledItem (IEnumerable<MenuItem> chldren, int current, out int newCurrent, bool forward = true)
{
if (chldren == null) {
newCurrent = -1;
return true;
}
IEnumerable<MenuItem> childrens;
if (forward) {
childrens = chldren;
} else {
childrens = chldren.Reverse ();
}
int count;
if (forward) {
count = -1;
} else {
count = childrens.Count ();
}
foreach (var child in childrens) {
if (forward) {
if (++count < current) {
continue;
}
} else {
if (--count > current) {
continue;
}
}
if (child == null || !child.IsEnabled ()) {
if (forward) {
current++;
} else {
current--;
}
} else {
newCurrent = current;
return true;
}
}
newCurrent = -1;
return false;
}
/// <summary>
/// Closes the current Menu programatically, if open.
/// </summary>
public void CloseMenu ()
{
CloseMenu (false, false);
}
bool reopen;
internal void CloseMenu (bool reopen = false, bool isSubMenu = false)
{
isMenuClosing = true;
this.reopen = reopen;
OnMenuClosing ();
switch (isSubMenu) {
case false:
if (openMenu != null) {
SuperView?.Remove (openMenu);
}
SetNeedsDisplay ();
if (previousFocused != null && previousFocused is Menu && openMenu != null && previousFocused.ToString () != openCurrentMenu.ToString ())
previousFocused.SetFocus ();
openMenu?.Dispose ();
openMenu = null;
if (lastFocused is Menu || lastFocused is MenuBar) {
lastFocused = null;
}
LastFocused = lastFocused;
lastFocused = null;
if (LastFocused != null) {
if (!reopen) {
selected = -1;
}
LastFocused.SetFocus ();
} else {
SetFocus ();
PositionCursor ();
}
IsMenuOpen = false;
break;
case true:
selectedSub = -1;
SetNeedsDisplay ();
RemoveAllOpensSubMenus ();
openCurrentMenu.previousSubFocused.SetFocus ();
openSubMenu = null;
IsMenuOpen = true;
break;
}
this.reopen = false;
isMenuClosing = false;
}
void RemoveSubMenu (int index)
{
if (openSubMenu == null)
return;
for (int i = openSubMenu.Count - 1; i > index; i--) {
isMenuClosing = true;
if (openSubMenu.Count - 1 > 0)
openSubMenu [i - 1].SetFocus ();
else
openMenu.SetFocus ();
if (openSubMenu != null) {
var menu = openSubMenu [i];
SuperView.Remove (menu);
openSubMenu.Remove (menu);
menu.Dispose ();
}
RemoveSubMenu (i);
}
if (openSubMenu.Count > 0)
openCurrentMenu = openSubMenu.Last ();
//if (openMenu.Subviews.Count == 0)
// return;
//if (index == 0) {
// //SuperView.SetFocus (previousSubFocused);
// FocusPrev ();
// return;
//}
//for (int i = openMenu.Subviews.Count - 1; i > index; i--) {
// isMenuClosing = true;
// if (openMenu.Subviews.Count - 1 > 0)
// SuperView.SetFocus (openMenu.Subviews [i - 1]);
// else
// SuperView.SetFocus (openMenu);
// if (openMenu != null) {
// Remove (openMenu.Subviews [i]);
// openMenu.Remove (openMenu.Subviews [i]);
// }
// RemoveSubMenu (i);
//}
isMenuClosing = false;
}
internal void RemoveAllOpensSubMenus ()
{
if (openSubMenu != null) {
foreach (var item in openSubMenu) {
SuperView.Remove (item);
item.Dispose ();
}
}
}
internal void CloseAllMenus ()
{
if (!isMenuOpening && !isMenuClosing) {
if (openSubMenu != null)
CloseMenu (false, true);
CloseMenu ();
if (LastFocused != null && LastFocused != this)
selected = -1;
}
IsMenuOpen = false;
openedByHotKey = false;
openedByAltKey = false;
}
View FindDeepestMenu (View view, ref int count)
{
count = count > 0 ? count : 0;
foreach (var menu in view.Subviews) {
if (menu is Menu) {
count++;
return FindDeepestMenu ((Menu)menu, ref count);
}
}
return view;
}
internal void PreviousMenu (bool isSubMenu = false)
{
switch (isSubMenu) {
case false:
if (selected <= 0)
selected = Menus.Length - 1;
else
selected--;
if (selected > -1)
CloseMenu (true, false);
OpenMenu (selected);
if (!SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current, false)) {
openCurrentMenu.current = 0;
if (!SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current)) {
CloseMenu ();
}
break;
}
break;
case true:
if (selectedSub > -1) {
selectedSub--;
RemoveSubMenu (selectedSub);
SetNeedsDisplay ();
} else
PreviousMenu ();
break;
}
}
internal void NextMenu (bool isSubMenu = false)
{
switch (isSubMenu) {
case false:
if (selected == -1)
selected = 0;
else if (selected + 1 == Menus.Length)
selected = 0;
else
selected++;
if (selected > -1)
CloseMenu (true);
OpenMenu (selected);
SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current);
break;
case true:
if (UseKeysUpDownAsKeysLeftRight) {
CloseMenu (false, true);
NextMenu ();
} else {
var subMenu = openCurrentMenu.barItems.SubMenu (openCurrentMenu.barItems.Children [openCurrentMenu.current]);
if ((selectedSub == -1 || openSubMenu == null || openSubMenu?.Count == selectedSub) && subMenu == null) {
if (openSubMenu != null)
CloseMenu (false, true);
NextMenu ();
} else if (subMenu != null ||
!openCurrentMenu.barItems.Children [openCurrentMenu.current].IsFromSubMenu)
selectedSub++;
else
return;
SetNeedsDisplay ();
openCurrentMenu.CheckSubMenu ();
}
break;
}
}
bool openedByHotKey;
internal bool FindAndOpenMenuByHotkey (KeyEvent kb)
{
//int pos = 0;
var c = ((uint)kb.Key & (uint)Key.CharMask);
for (int i = 0; i < Menus.Length; i++) {
// TODO: this code is duplicated, hotkey should be part of the MenuBarItem
var mi = Menus [i];
int p = mi.Title.IndexOf ('_');
if (p != -1 && p + 1 < mi.Title.RuneCount) {
if (Char.ToUpperInvariant ((char)mi.Title [p + 1]) == c) {
ProcessMenu (i, mi);
return true;
}
}
}
return false;
}
internal bool FindAndOpenMenuByShortcut (KeyEvent kb, MenuItem [] children = null)
{
if (children == null) {
children = Menus;
}
var key = kb.KeyValue;
var keys = ShortcutHelper.GetModifiersKey (kb);
key |= (int)keys;
for (int i = 0; i < children.Length; i++) {
var mi = children [i];
if (mi == null) {
continue;
}
if ((!(mi is MenuBarItem mbiTopLevel) || mbiTopLevel.IsTopLevel) && mi.Shortcut != Key.Null && mi.Shortcut == (Key)key) {
var action = mi.Action;
if (action != null) {
Application.MainLoop.AddIdle (() => {
action ();
return false;
});
}
return true;
}
if (mi is MenuBarItem menuBarItem && !menuBarItem.IsTopLevel && FindAndOpenMenuByShortcut (kb, menuBarItem.Children)) {
return true;
}
}
return false;
}
private void ProcessMenu (int i, MenuBarItem mi)
{
if (mi.IsTopLevel) {
var menu = new Menu (this, i, 0, mi);
menu.Run (mi.Action);
menu.Dispose ();
} else {
openedByHotKey = true;
Application.GrabMouse (this);
selected = i;
OpenMenu (i);
if (!SelectEnabledItem (openCurrentMenu.barItems.Children, openCurrentMenu.current, out openCurrentMenu.current)) {
CloseMenu ();
}
openCurrentMenu.CheckSubMenu ();
}
}
///<inheritdoc/>
public override bool ProcessHotKey (KeyEvent kb)
{
if (kb.Key == Key.F9) {
if (!IsMenuOpen)
OpenMenu ();
else
CloseAllMenus ();
return true;
}
// To ncurses simulate a AltMask key pressing Alt+Space because
// it can<61>t detect an alone special key down was pressed.
if (kb.IsAlt && kb.Key == Key.AltMask && openMenu == null) {
OnKeyDown (kb);
OnKeyUp (kb);
return true;
} else if (kb.IsAlt && !kb.IsCtrl && !kb.IsShift) {
if (FindAndOpenMenuByHotkey (kb)) return true;
}
//var kc = kb.KeyValue;
return base.ProcessHotKey (kb);
}
///<inheritdoc/>
public override bool ProcessKey (KeyEvent kb)
{
switch (kb.Key) {
case Key.CursorLeft:
selected--;
if (selected < 0)
selected = Menus.Length - 1;
break;
case Key.CursorRight:
selected = (selected + 1) % Menus.Length;
break;
case Key.Esc:
case Key.C | Key.CtrlMask:
//TODO: Running = false;
CloseMenu ();
if (openedByAltKey) {
openedByAltKey = false;
LastFocused?.SetFocus ();
}
break;
case Key.CursorDown:
case Key.Enter:
if (selected > -1) {
ProcessMenu (selected, Menus [selected]);
}
break;
default:
var key = kb.KeyValue;
if ((key >= 'a' && key <= 'z') || (key >= 'A' && key <= 'Z') || (key >= '0' && key <= '9')) {
char c = Char.ToUpper ((char)key);
if (selected == -1 || Menus [selected].IsTopLevel)
return false;
foreach (var mi in Menus [selected].Children) {
if (mi == null)
continue;
int p = mi.Title.IndexOf ('_');
if (p != -1 && p + 1 < mi.Title.RuneCount) {
if (mi.Title [p + 1] == c) {
Selected (mi);
return true;
}
}
}
}
return false;
}
SetNeedsDisplay ();
return true;
}
///<inheritdoc/>
public override bool ProcessColdKey (KeyEvent kb)
{
return FindAndOpenMenuByShortcut (kb);
}
///<inheritdoc/>
public override bool MouseEvent (MouseEvent me)
{
if (!handled && !HandleGrabView (me, this)) {
return false;
}
handled = false;
if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags == MouseFlags.Button1Clicked ||
(me.Flags == MouseFlags.ReportMousePosition && selected > -1) ||
(me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition) && selected > -1)) {
int pos = 1;
int cx = me.X;
for (int i = 0; i < Menus.Length; i++) {
if (cx >= pos && cx < pos + 1 + Menus [i].TitleLength + Menus [i].Help.RuneCount + 2) {
if (me.Flags == MouseFlags.Button1Clicked) {
if (Menus [i].IsTopLevel) {
var menu = new Menu (this, i, 0, Menus [i]);
menu.Run (Menus [i].Action);
menu.Dispose ();
}
} else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked) {
if (IsMenuOpen && !Menus [i].IsTopLevel) {
CloseAllMenus ();
} else if (!Menus [i].IsTopLevel) {
Activate (i);
}
} else if (selected != i && selected > -1 && (me.Flags == MouseFlags.ReportMousePosition ||
me.Flags == MouseFlags.Button1Pressed && me.Flags == MouseFlags.ReportMousePosition)) {
if (IsMenuOpen) {
CloseMenu (true, false);
Activate (i);
}
} else {
if (IsMenuOpen)
Activate (i);
}
return true;
}
pos += 1 + Menus [i].TitleLength + 2;
}
}
return false;
}
internal bool handled;
internal bool HandleGrabView (MouseEvent me, View current)
{
if (Application.mouseGrabView != null) {
if (me.View is MenuBar || me.View is Menu) {
if (me.View != current) {
Application.UngrabMouse ();
var v = me.View;
Application.GrabMouse (v);
var newxy = v.ScreenToView (me.X, me.Y);
var nme = new MouseEvent () {
X = newxy.X,
Y = newxy.Y,
Flags = me.Flags,
OfX = me.X - newxy.X,
OfY = me.Y - newxy.Y,
View = v
};
v.MouseEvent (nme);
return false;
}
} else if (!(me.View is MenuBar || me.View is Menu) && (me.Flags.HasFlag (MouseFlags.Button1Clicked) ||
me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked)) {
Application.UngrabMouse ();
CloseAllMenus ();
handled = false;
return false;
} else {
handled = false;
return false;
}
} else if (!IsMenuOpen && (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))) {
Application.GrabMouse (current);
} else if (IsMenuOpen && (me.View is MenuBar || me.View is Menu)) {
Application.GrabMouse (me.View);
} else {
handled = false;
return false;
}
//if (me.View != this && me.Flags != MouseFlags.Button1Pressed)
// return true;
//else if (me.View != this && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
// Application.UngrabMouse ();
// host.CloseAllMenus ();
// return true;
//}
//if (!(me.View is MenuBar) && !(me.View is Menu) && me.Flags != MouseFlags.Button1Pressed))
// return false;
//if (Application.mouseGrabView != null) {
// if (me.View is MenuBar || me.View is Menu) {
// me.X -= me.OfX;
// me.Y -= me.OfY;
// me.View.MouseEvent (me);
// return true;
// } else if (!(me.View is MenuBar || me.View is Menu) && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
// Application.UngrabMouse ();
// CloseAllMenus ();
// }
//} else if (!isMenuClosed && selected == -1 && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
// Application.GrabMouse (this);
// return true;
//}
//if (Application.mouseGrabView != null) {
// if (Application.mouseGrabView == me.View && me.View == current) {
// me.X -= me.OfX;
// me.Y -= me.OfY;
// } else if (me.View != current && me.View is MenuBar && me.View is Menu) {
// Application.UngrabMouse ();
// Application.GrabMouse (me.View);
// } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
// Application.UngrabMouse ();
// CloseMenu ();
// }
//} else if ((!isMenuClosed && selected > -1)) {
// Application.GrabMouse (current);
//}
handled = true;
return true;
}
}
}