Menu.cs 35 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297
  1. //
  2. // Menu.cs: application menus and submenus
  3. //
  4. // Authors:
  5. // Miguel de Icaza ([email protected])
  6. //
  7. // TODO:
  8. // Add accelerator support, but should also support chords (ShortCut in MenuItem)
  9. // Allow menus inside menus
  10. using System;
  11. using NStack;
  12. using System.Linq;
  13. using System.Collections.Generic;
  14. namespace Terminal.Gui {
  15. /// <summary>
  16. /// Specifies how a <see cref="MenuItem"/> shows selection state.
  17. /// </summary>
  18. [Flags]
  19. public enum MenuItemCheckStyle {
  20. /// <summary>
  21. /// The menu item will be shown normally, with no check indicator.
  22. /// </summary>
  23. NoCheck = 0b_0000_0000,
  24. /// <summary>
  25. /// The menu item will indicate checked/un-checked state (see <see cref="Checked"/>.
  26. /// </summary>
  27. Checked = 0b_0000_0001,
  28. /// <summary>
  29. /// The menu item is part of a menu radio group (see <see cref="Checked"/> and will indicate selected state.
  30. /// </summary>
  31. Radio = 0b_0000_0010,
  32. };
  33. /// <summary>
  34. /// A <see cref="MenuItem"/> has a title, an associated help text, and an action to execute on activation.
  35. /// </summary>
  36. public class MenuItem {
  37. /// <summary>
  38. /// Initializes a new instance of <see cref="MenuItem"/>
  39. /// </summary>
  40. public MenuItem ()
  41. {
  42. Title = "";
  43. Help = "";
  44. }
  45. /// <summary>
  46. /// Initializes a new instance of <see cref="MenuItem"/>.
  47. /// </summary>
  48. /// <param name="title">Title for the menu item.</param>
  49. /// <param name="help">Help text to display.</param>
  50. /// <param name="action">Action to invoke when the menu item is activated.</param>
  51. /// <param name="canExecute">Function to determine if the action can currently be executred.</param>
  52. public MenuItem (ustring title, string help, Action action, Func<bool> canExecute = null)
  53. {
  54. Title = title ?? "";
  55. Help = help ?? "";
  56. Action = action;
  57. CanExecute = canExecute;
  58. bool nextIsHot = false;
  59. foreach (var x in Title) {
  60. if (x == '_')
  61. nextIsHot = true;
  62. else {
  63. if (nextIsHot) {
  64. HotKey = Char.ToUpper ((char)x);
  65. break;
  66. }
  67. nextIsHot = false;
  68. }
  69. }
  70. }
  71. /// <summary>
  72. /// Initializes a new instance of <see cref="MenuItem"/>
  73. /// </summary>
  74. /// <param name="title">Title for the menu item.</param>
  75. /// <param name="subMenu">The menu sub-menu.</param>
  76. public MenuItem (ustring title, MenuBarItem subMenu) : this (title, "", null)
  77. {
  78. SubMenu = subMenu;
  79. IsFromSubMenu = true;
  80. }
  81. /// <summary>
  82. /// The HotKey is used when the menu is active, the shortcut can be triggered when the menu is not active.
  83. /// For example HotKey would be "N" when the File Menu is open (assuming there is a "_New" entry
  84. /// if the ShortCut is set to "Control-N", this would be a global hotkey that would trigger as well
  85. /// </summary>
  86. public Rune HotKey;
  87. /// <summary>
  88. /// This is the global setting that can be used as a global shortcut to invoke the action on the menu.
  89. /// </summary>
  90. public Key ShortCut;
  91. /// <summary>
  92. /// Gets or sets the title.
  93. /// </summary>
  94. /// <value>The title.</value>
  95. public ustring Title { get; set; }
  96. /// <summary>
  97. /// Gets or sets the help text for the menu item.
  98. /// </summary>
  99. /// <value>The help text.</value>
  100. public ustring Help { get; set; }
  101. /// <summary>
  102. /// Gets or sets the action to be invoked when the menu is triggered
  103. /// </summary>
  104. /// <value>Method to invoke.</value>
  105. public Action Action { get; set; }
  106. /// <summary>
  107. /// Gets or sets the action to be invoked if the menu can be triggered
  108. /// </summary>
  109. /// <value>Function to determine if action is ready to be executed.</value>
  110. public Func<bool> CanExecute { get; set; }
  111. /// <summary>
  112. /// Shortcut to check if the menu item is enabled
  113. /// </summary>
  114. public bool IsEnabled ()
  115. {
  116. return CanExecute == null ? true : CanExecute ();
  117. }
  118. internal int Width => Title.RuneCount + Help.RuneCount + 1 + 2 +
  119. (Checked || CheckType.HasFlag (MenuItemCheckStyle.Checked) || CheckType.HasFlag (MenuItemCheckStyle.Radio) ? 2 : 0);
  120. /// <summary>
  121. /// Sets or gets whether the <see cref="MenuItem"/> shows a check indicator or not. See <see cref="MenuItemCheckStyle"/>.
  122. /// </summary>
  123. public bool Checked { set; get; }
  124. /// <summary>
  125. /// Sets or gets the type selection indicator the menu item will be displayed with.
  126. /// </summary>
  127. public MenuItemCheckStyle CheckType { get; set; }
  128. /// <summary>
  129. /// Gets or sets the parent for this <see cref="MenuItem"/>
  130. /// </summary>
  131. /// <value>The parent.</value>
  132. internal MenuBarItem SubMenu { get; set; }
  133. internal bool IsFromSubMenu { get; set; }
  134. /// <summary>
  135. /// Merely a debugging aid to see the interaction with main
  136. /// </summary>
  137. public MenuItem GetMenuItem ()
  138. {
  139. return this;
  140. }
  141. /// <summary>
  142. /// Merely a debugging aid to see the interaction with main
  143. /// </summary>
  144. public bool GetMenuBarItem ()
  145. {
  146. return IsFromSubMenu;
  147. }
  148. }
  149. /// <summary>
  150. /// A <see cref="MenuBarItem"/> contains <see cref="MenuBarItem"/>s or <see cref="MenuItem"/>s.
  151. /// </summary>
  152. public class MenuBarItem : MenuItem {
  153. /// <summary>
  154. /// Initializes a new <see cref="MenuBarItem"/> as a <see cref="MenuItem"/>.
  155. /// </summary>
  156. /// <param name="title">Title for the menu item.</param>
  157. /// <param name="help">Help text to display.</param>
  158. /// <param name="action">Action to invoke when the menu item is activated.</param>
  159. /// <param name="canExecute">Function to determine if the action can currently be executred.</param>
  160. public MenuBarItem (ustring title, string help, Action action, Func<bool> canExecute = null) : base (title, help, action, canExecute)
  161. {
  162. SetTitle (title ?? "");
  163. Children = null;
  164. }
  165. /// <summary>
  166. /// Initializes a new <see cref="MenuBarItem"/>.
  167. /// </summary>
  168. /// <param name="title">Title for the menu item.</param>
  169. /// <param name="children">The items in the current menu.</param>
  170. public MenuBarItem (ustring title, MenuItem [] children)
  171. {
  172. if (children == null)
  173. throw new ArgumentNullException (nameof (children), "The parameter cannot be null. Use an empty array instead.");
  174. SetTitle (title ?? "");
  175. Children = children;
  176. }
  177. /// <summary>
  178. /// Initializes a new <see cref="MenuBarItem"/>.
  179. /// </summary>
  180. /// <param name="children">The items in the current menu.</param>
  181. public MenuBarItem (MenuItem [] children) : this (new string (' ', GetMaxTitleLength (children)), children) { }
  182. /// <summary>
  183. /// Initializes a new <see cref="MenuBarItem"/>.
  184. /// </summary>
  185. public MenuBarItem () : this (children: new MenuItem [] { }) { }
  186. static int GetMaxTitleLength (MenuItem [] children)
  187. {
  188. int maxLength = 0;
  189. foreach (var item in children) {
  190. int len = GetMenuBarItemLength (item.Title);
  191. if (len > maxLength)
  192. maxLength = len;
  193. item.IsFromSubMenu = true;
  194. }
  195. return maxLength;
  196. }
  197. void SetTitle (ustring title)
  198. {
  199. if (title == null)
  200. title = "";
  201. Title = title;
  202. TitleLength = GetMenuBarItemLength (Title);
  203. }
  204. static int GetMenuBarItemLength (ustring title)
  205. {
  206. int len = 0;
  207. foreach (var ch in title) {
  208. if (ch == '_')
  209. continue;
  210. len++;
  211. }
  212. return len;
  213. }
  214. ///// <summary>
  215. ///// Gets or sets the title to display.
  216. ///// </summary>
  217. ///// <value>The title.</value>
  218. //public ustring Title { get; set; }
  219. /// <summary>
  220. /// Gets or sets an array of <see cref="MenuItem"/> objects that are the children of this <see cref="MenuBarItem"/>
  221. /// </summary>
  222. /// <value>The children.</value>
  223. public MenuItem [] Children { get; set; }
  224. internal int TitleLength { get; private set; }
  225. internal bool IsTopLevel { get => (Children == null || Children.Length == 0); }
  226. }
  227. class Menu : View {
  228. internal MenuBarItem barItems;
  229. MenuBar host;
  230. internal int current;
  231. internal View previousSubFocused;
  232. static Rect MakeFrame (int x, int y, MenuItem [] items)
  233. {
  234. if (items == null || items.Length == 0) {
  235. return new Rect ();
  236. }
  237. int maxW = items.Max (z => z?.Width) ?? 0;
  238. return new Rect (x, y, maxW + 2, items.Length + 2);
  239. }
  240. public Menu (MenuBar host, int x, int y, MenuBarItem barItems) : base (MakeFrame (x, y, barItems.Children))
  241. {
  242. this.barItems = barItems;
  243. this.host = host;
  244. if (barItems.IsTopLevel) {
  245. // This is a standalone MenuItem on a MenuBar
  246. ColorScheme = Colors.Menu;
  247. CanFocus = true;
  248. } else {
  249. current = -1;
  250. for (int i = 0; i < barItems.Children.Length; i++) {
  251. if (barItems.Children [i] != null) {
  252. current = i;
  253. break;
  254. }
  255. }
  256. ColorScheme = Colors.Menu;
  257. CanFocus = true;
  258. WantMousePositionReports = host.WantMousePositionReports;
  259. }
  260. }
  261. internal Attribute DetermineColorSchemeFor (MenuItem item, int index)
  262. {
  263. if (item != null) {
  264. if (index == current) return ColorScheme.Focus;
  265. if (!item.IsEnabled ()) return ColorScheme.Disabled;
  266. }
  267. return ColorScheme.Normal;
  268. }
  269. public override void Redraw (Rect bounds)
  270. {
  271. Driver.SetAttribute (ColorScheme.Normal);
  272. DrawFrame (bounds, padding: 0, fill: true);
  273. for (int i = 0; i < barItems.Children.Length; i++) {
  274. var item = barItems.Children [i];
  275. Driver.SetAttribute (item == null ? ColorScheme.Normal : i == current ? ColorScheme.Focus : ColorScheme.Normal);
  276. if (item == null) {
  277. Move (0, i + 1);
  278. Driver.AddRune (Driver.LeftTee);
  279. } else
  280. Move (1, i + 1);
  281. Driver.SetAttribute (DetermineColorSchemeFor (item, i));
  282. for (int p = 0; p < Frame.Width - 2; p++)
  283. if (item == null)
  284. Driver.AddRune (Driver.HLine);
  285. else if (p == Frame.Width - 3 && barItems.Children [i].SubMenu != null)
  286. Driver.AddRune (Driver.RightArrow);
  287. else
  288. Driver.AddRune (' ');
  289. if (item == null) {
  290. Move (Frame.Right - 1, i + 1);
  291. Driver.AddRune (Driver.RightTee);
  292. continue;
  293. }
  294. ustring textToDraw;
  295. var checkChar = Driver.Selected;
  296. var uncheckedChar = Driver.UnSelected;
  297. if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked)) {
  298. checkChar = Driver.Checked;
  299. uncheckedChar = Driver.UnChecked;
  300. }
  301. // Support Checked even though CHeckType wasn't set
  302. if (item.Checked) {
  303. textToDraw = ustring.Make (new Rune [] { checkChar, ' ' }) + item.Title;
  304. } else if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked) ||
  305. item.CheckType.HasFlag (MenuItemCheckStyle.Radio)) {
  306. textToDraw = ustring.Make (new Rune [] { uncheckedChar, ' ' }) + item.Title;
  307. } else {
  308. textToDraw = item.Title;
  309. }
  310. Move (2, i + 1);
  311. if (!item.IsEnabled ())
  312. DrawHotString (textToDraw, ColorScheme.Disabled, ColorScheme.Disabled);
  313. else
  314. DrawHotString (textToDraw,
  315. i == current ? ColorScheme.HotFocus : ColorScheme.HotNormal,
  316. i == current ? ColorScheme.Focus : ColorScheme.Normal);
  317. // The help string
  318. var l = item.Help.RuneCount;
  319. Move (Frame.Width - l - 2, 1 + i);
  320. Driver.AddStr (item.Help);
  321. }
  322. PositionCursor ();
  323. }
  324. public override void PositionCursor ()
  325. {
  326. if (host == null || host.IsMenuOpen)
  327. if (barItems.IsTopLevel) {
  328. host.PositionCursor ();
  329. } else
  330. Move (2, 1 + current);
  331. else
  332. host.PositionCursor ();
  333. }
  334. public void Run (Action action)
  335. {
  336. if (action == null)
  337. return;
  338. Application.UngrabMouse ();
  339. host.CloseAllMenus ();
  340. Application.Refresh ();
  341. Application.MainLoop.AddIdle (() => {
  342. action ();
  343. return false;
  344. });
  345. }
  346. public override bool OnKeyDown (KeyEvent keyEvent)
  347. {
  348. if (keyEvent.IsAlt) {
  349. host.CloseAllMenus ();
  350. return true;
  351. }
  352. return false;
  353. }
  354. public override bool ProcessHotKey (KeyEvent keyEvent)
  355. {
  356. // To ncurses simulate a AltMask key pressing Alt+Space because
  357. // it can�t detect an alone special key down was pressed.
  358. if (keyEvent.IsAlt && keyEvent.Key == Key.AltMask) {
  359. OnKeyDown (keyEvent);
  360. return true;
  361. }
  362. return false;
  363. }
  364. public override bool ProcessKey (KeyEvent kb)
  365. {
  366. bool disabled;
  367. switch (kb.Key) {
  368. case Key.CursorUp:
  369. if (barItems.IsTopLevel || current == -1)
  370. break;
  371. do {
  372. disabled = false;
  373. current--;
  374. if (host.UseKeysUpDownAsKeysLeftRight) {
  375. if (current == -1 && barItems.Children [current + 1].IsFromSubMenu && host.selectedSub > -1) {
  376. current++;
  377. host.PreviousMenu (true);
  378. break;
  379. }
  380. }
  381. if (current < 0)
  382. current = barItems.Children.Length - 1;
  383. var item = barItems.Children [current];
  384. if (item == null || !item.IsEnabled ()) disabled = true;
  385. } while (barItems.Children [current] == null || disabled);
  386. SetNeedsDisplay ();
  387. break;
  388. case Key.CursorDown:
  389. if (barItems.IsTopLevel) {
  390. break;
  391. }
  392. do {
  393. current++;
  394. disabled = false;
  395. if (current == barItems.Children.Length)
  396. current = 0;
  397. var item = barItems.Children [current];
  398. if (item == null || !item.IsEnabled ()) disabled = true;
  399. if (host.UseKeysUpDownAsKeysLeftRight && barItems.Children [current]?.SubMenu != null &&
  400. !disabled && host.IsMenuOpen) {
  401. CheckSubMenu ();
  402. break;
  403. }
  404. if (!host.IsMenuOpen)
  405. host.OpenMenu (host.selected);
  406. } while (barItems.Children [current] == null || disabled);
  407. SetNeedsDisplay ();
  408. break;
  409. case Key.CursorLeft:
  410. host.PreviousMenu (true);
  411. break;
  412. case Key.CursorRight:
  413. host.NextMenu (barItems.IsTopLevel || barItems.Children [current].IsFromSubMenu ? true : false);
  414. break;
  415. case Key.Esc:
  416. Application.UngrabMouse ();
  417. host.CloseAllMenus ();
  418. break;
  419. case Key.Enter:
  420. if (barItems.IsTopLevel) {
  421. Run (barItems.Action);
  422. } else {
  423. CheckSubMenu ();
  424. Run (barItems.Children [current].Action);
  425. }
  426. break;
  427. default:
  428. // TODO: rune-ify
  429. if (barItems.Children != null && Char.IsLetterOrDigit ((char)kb.KeyValue)) {
  430. var x = Char.ToUpper ((char)kb.KeyValue);
  431. foreach (var item in barItems.Children) {
  432. if (item == null) continue;
  433. if (item.IsEnabled () && item.HotKey == x) {
  434. host.CloseMenu ();
  435. Run (item.Action);
  436. return true;
  437. }
  438. }
  439. }
  440. break;
  441. }
  442. return true;
  443. }
  444. public override bool MouseEvent (MouseEvent me)
  445. {
  446. if (!host.handled && !host.HandleGrabView (me, this)) {
  447. return false;
  448. }
  449. host.handled = false;
  450. bool disabled;
  451. if (me.Flags == MouseFlags.Button1Clicked) {
  452. disabled = false;
  453. if (me.Y < 1)
  454. return true;
  455. var meY = me.Y - 1;
  456. if (meY >= barItems.Children.Length)
  457. return true;
  458. var item = barItems.Children [meY];
  459. if (item == null || !item.IsEnabled ()) disabled = true;
  460. if (item != null && !disabled)
  461. Run (barItems.Children [meY].Action);
  462. return true;
  463. } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked ||
  464. me.Flags == MouseFlags.Button1TripleClicked || me.Flags == MouseFlags.ReportMousePosition ||
  465. me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition)) {
  466. disabled = false;
  467. if (me.Y < 1 || me.Y - 1 >= barItems.Children.Length) {
  468. return true;
  469. }
  470. var item = barItems.Children [me.Y - 1];
  471. if (item == null || !item.IsEnabled ()) disabled = true;
  472. if (item != null && !disabled)
  473. current = me.Y - 1;
  474. CheckSubMenu ();
  475. return true;
  476. }
  477. return false;
  478. }
  479. internal void CheckSubMenu ()
  480. {
  481. if (barItems.Children [current] == null)
  482. return;
  483. var subMenu = barItems.Children [current].SubMenu;
  484. if (subMenu != null) {
  485. int pos = -1;
  486. if (host.openSubMenu != null)
  487. pos = host.openSubMenu.FindIndex (o => o?.barItems == subMenu);
  488. host.Activate (host.selected, pos, subMenu);
  489. } else if (host.openSubMenu != null && !barItems.Children [current].IsFromSubMenu)
  490. host.CloseMenu (false, true);
  491. else {
  492. SetNeedsDisplay ();
  493. }
  494. }
  495. int GetSubMenuIndex (MenuBarItem subMenu)
  496. {
  497. int pos = -1;
  498. if (this != null && Subviews.Count > 0) {
  499. Menu v = null;
  500. foreach (var menu in Subviews) {
  501. if (((Menu)menu).barItems == subMenu)
  502. v = (Menu)menu;
  503. }
  504. if (v != null)
  505. pos = Subviews.IndexOf (v);
  506. }
  507. return pos;
  508. }
  509. }
  510. /// <summary>
  511. /// The MenuBar provides a menu for Terminal.Gui applications.
  512. /// </summary>
  513. /// <remarks>
  514. /// <para>
  515. /// The <see cref="MenuBar"/> appears on the first row of the terminal.
  516. /// </para>
  517. /// <para>
  518. /// The <see cref="MenuBar"/> provides global hotkeys for the application.
  519. /// </para>
  520. /// </remarks>
  521. public class MenuBar : View {
  522. /// <summary>
  523. /// Gets or sets the array of <see cref="MenuBarItem"/>s for the menu. Only set this when the <see cref="MenuBar"/> is vislble.
  524. /// </summary>
  525. /// <value>The menu array.</value>
  526. public MenuBarItem [] Menus { get; set; }
  527. internal int selected;
  528. internal int selectedSub;
  529. Action action;
  530. /// <summary>
  531. /// Used for change the navigation key style.
  532. /// </summary>
  533. public bool UseKeysUpDownAsKeysLeftRight { get; set; } = true;
  534. /// <summary>
  535. /// Initializes a new instance of the <see cref="MenuBar"/>.
  536. /// </summary>
  537. public MenuBar () : this (new MenuBarItem [] { }) { }
  538. /// <summary>
  539. /// Initializes a new instance of the <see cref="MenuBar"/> class with the specified set of toplevel menu items.
  540. /// </summary>
  541. /// <param name="menus">Individual menu items; a null item will result in a separator being drawn.</param>
  542. public MenuBar (MenuBarItem [] menus) : base ()
  543. {
  544. X = 0;
  545. Y = 0;
  546. Width = Dim.Fill ();
  547. Height = 1;
  548. Menus = menus;
  549. //CanFocus = true;
  550. selected = -1;
  551. selectedSub = -1;
  552. ColorScheme = Colors.Menu;
  553. WantMousePositionReports = true;
  554. IsMenuOpen = false;
  555. }
  556. bool openedByAltKey;
  557. ///<inheritdoc/>
  558. public override bool OnKeyDown (KeyEvent keyEvent)
  559. {
  560. if (keyEvent.IsAlt) {
  561. openedByAltKey = true;
  562. SetNeedsDisplay ();
  563. openedByHotKey = false;
  564. }
  565. return false;
  566. }
  567. ///<inheritdoc/>
  568. public override bool OnKeyUp (KeyEvent keyEvent)
  569. {
  570. if (keyEvent.IsAlt) {
  571. // User pressed Alt - this may be a precursor to a menu accelerator (e.g. Alt-F)
  572. if (!keyEvent.IsCtrl && openedByAltKey && !IsMenuOpen && openMenu == null && ((uint)keyEvent.Key & (uint)Key.CharMask) == 0) {
  573. // There's no open menu, the first menu item should be highlight.
  574. // The right way to do this is to SetFocus(MenuBar), but for some reason
  575. // that faults.
  576. //Activate (0);
  577. //StartMenu ();
  578. IsMenuOpen = true;
  579. selected = 0;
  580. CanFocus = true;
  581. lastFocused = SuperView.MostFocused;
  582. SuperView.SetFocus (this);
  583. SetNeedsDisplay ();
  584. Application.GrabMouse (this);
  585. } else if (!openedByHotKey) {
  586. // There's an open menu. If this Alt key-up is a pre-cursor to an accelerator
  587. // we don't want to close the menu because it'll flash.
  588. // How to deal with that?
  589. if (openMenu != null)
  590. CloseAllMenus ();
  591. openedByAltKey = false;
  592. IsMenuOpen = false;
  593. selected = -1;
  594. CanFocus = false;
  595. if (lastFocused != null)
  596. SuperView?.SetFocus (lastFocused);
  597. SetNeedsDisplay ();
  598. Application.UngrabMouse ();
  599. }
  600. return true;
  601. }
  602. return false;
  603. }
  604. ///<inheritdoc/>
  605. public override void Redraw (Rect bounds)
  606. {
  607. Move (0, 0);
  608. Driver.SetAttribute (Colors.Menu.Normal);
  609. for (int i = 0; i < Frame.Width; i++)
  610. Driver.AddRune (' ');
  611. Move (1, 0);
  612. int pos = 1;
  613. for (int i = 0; i < Menus.Length; i++) {
  614. var menu = Menus [i];
  615. Move (pos, 0);
  616. Attribute hotColor, normalColor;
  617. if (i == selected) {
  618. hotColor = i == selected ? ColorScheme.HotFocus : ColorScheme.HotNormal;
  619. normalColor = i == selected ? ColorScheme.Focus : ColorScheme.Normal;
  620. } else if (openedByAltKey) {
  621. hotColor = ColorScheme.HotNormal;
  622. normalColor = ColorScheme.Normal;
  623. } else {
  624. hotColor = ColorScheme.Normal;
  625. normalColor = ColorScheme.Normal;
  626. }
  627. DrawHotString ($" {menu.Title} ", hotColor, normalColor);
  628. pos += 1 + menu.TitleLength + 2;
  629. }
  630. PositionCursor ();
  631. }
  632. ///<inheritdoc/>
  633. public override void PositionCursor ()
  634. {
  635. int pos = 0;
  636. for (int i = 0; i < Menus.Length; i++) {
  637. if (i == selected) {
  638. pos++;
  639. if (IsMenuOpen)
  640. Move (pos + 1, 0);
  641. else
  642. Move (pos + 1, 0);
  643. return;
  644. } else {
  645. if (IsMenuOpen)
  646. pos += 1 + Menus [i].TitleLength + 2;
  647. else
  648. pos += 2 + Menus [i].TitleLength + 1;
  649. }
  650. }
  651. //Move (0, 0);
  652. }
  653. void Selected (MenuItem item)
  654. {
  655. // TODO: Running = false;
  656. action = item.Action;
  657. }
  658. /// <summary>
  659. /// Raised as a menu is opening.
  660. /// </summary>
  661. public Action MenuOpening;
  662. /// <summary>
  663. /// Raised when a menu is closing.
  664. /// </summary>
  665. public Action MenuClosing;
  666. internal Menu openMenu;
  667. Menu openCurrentMenu;
  668. internal List<Menu> openSubMenu;
  669. View previousFocused;
  670. internal bool isMenuOpening;
  671. internal bool isMenuClosing;
  672. /// <summary>
  673. /// True if the menu is open; otherwise false.
  674. /// </summary>
  675. public bool IsMenuOpen { get; protected set; }
  676. /// <summary>
  677. /// Virtual method that will invoke the <see cref="MenuOpening"/>
  678. /// </summary>
  679. public virtual void OnMenuOpening ()
  680. {
  681. MenuOpening?.Invoke ();
  682. }
  683. /// <summary>
  684. /// Virtual method that will invoke the <see cref="MenuClosing"/>
  685. /// </summary>
  686. public virtual void OnMenuClosing ()
  687. {
  688. MenuClosing?.Invoke ();
  689. }
  690. View lastFocused;
  691. /// <summary>
  692. /// Get the lasted focused view before open the menu.
  693. /// </summary>
  694. public View LastFocused { get; private set; }
  695. internal void OpenMenu (int index, int sIndex = -1, MenuBarItem subMenu = null)
  696. {
  697. isMenuOpening = true;
  698. OnMenuOpening ();
  699. int pos = 0;
  700. switch (subMenu) {
  701. case null:
  702. lastFocused = lastFocused ?? SuperView.MostFocused;
  703. if (openSubMenu != null)
  704. CloseMenu (false, true);
  705. if (openMenu != null) {
  706. SuperView.Remove (openMenu);
  707. openMenu.Dispose ();
  708. }
  709. for (int i = 0; i < index; i++)
  710. pos += Menus [i].Title.RuneCount + 2;
  711. openMenu = new Menu (this, pos, 1, Menus [index]);
  712. openCurrentMenu = openMenu;
  713. openCurrentMenu.previousSubFocused = openMenu;
  714. SuperView.Add (openMenu);
  715. SuperView.SetFocus (openMenu);
  716. break;
  717. default:
  718. if (openSubMenu == null)
  719. openSubMenu = new List<Menu> ();
  720. if (sIndex > -1) {
  721. RemoveSubMenu (sIndex);
  722. } else {
  723. var last = openSubMenu.Count > 0 ? openSubMenu.Last () : openMenu;
  724. openCurrentMenu = new Menu (this, last.Frame.Left + last.Frame.Width, last.Frame.Top + 1 + last.current, subMenu);
  725. openCurrentMenu.previousSubFocused = last.previousSubFocused;
  726. openSubMenu.Add (openCurrentMenu);
  727. SuperView.Add (openCurrentMenu);
  728. }
  729. selectedSub = openSubMenu.Count - 1;
  730. SuperView?.SetFocus (openCurrentMenu);
  731. break;
  732. }
  733. isMenuOpening = false;
  734. IsMenuOpen = true;
  735. }
  736. /// <summary>
  737. /// Opens the current Menu programatically.
  738. /// </summary>
  739. public void OpenMenu ()
  740. {
  741. if (openMenu != null)
  742. return;
  743. selected = 0;
  744. SetNeedsDisplay ();
  745. previousFocused = SuperView.Focused;
  746. OpenMenu (selected);
  747. Application.GrabMouse (this);
  748. }
  749. // Activates the menu, handles either first focus, or activating an entry when it was already active
  750. // For mouse events.
  751. internal void Activate (int idx, int sIdx = -1, MenuBarItem subMenu = null)
  752. {
  753. selected = idx;
  754. selectedSub = sIdx;
  755. if (openMenu == null)
  756. previousFocused = SuperView.Focused;
  757. OpenMenu (idx, sIdx, subMenu);
  758. SetNeedsDisplay ();
  759. }
  760. /// <summary>
  761. /// Closes the current Menu programatically, if open.
  762. /// </summary>
  763. public void CloseMenu ()
  764. {
  765. CloseMenu (false, false);
  766. }
  767. internal void CloseMenu (bool reopen = false, bool isSubMenu = false)
  768. {
  769. isMenuClosing = true;
  770. OnMenuClosing ();
  771. switch (isSubMenu) {
  772. case false:
  773. if (openMenu != null) {
  774. SuperView.Remove (openMenu);
  775. }
  776. SetNeedsDisplay ();
  777. if (previousFocused != null && openMenu != null && previousFocused.ToString () != openCurrentMenu.ToString ())
  778. previousFocused?.SuperView?.SetFocus (previousFocused);
  779. openMenu?.Dispose ();
  780. openMenu = null;
  781. if (lastFocused is Menu) {
  782. lastFocused = null;
  783. }
  784. LastFocused = lastFocused;
  785. lastFocused = null;
  786. if (LastFocused != null) {
  787. if (!reopen)
  788. selected = -1;
  789. LastFocused.SuperView?.SetFocus (LastFocused);
  790. } else {
  791. SuperView.SetFocus (this);
  792. PositionCursor ();
  793. }
  794. IsMenuOpen = false;
  795. break;
  796. case true:
  797. selectedSub = -1;
  798. SetNeedsDisplay ();
  799. RemoveAllOpensSubMenus ();
  800. openCurrentMenu.previousSubFocused?.SuperView?.SetFocus (openCurrentMenu.previousSubFocused);
  801. openSubMenu = null;
  802. IsMenuOpen = true;
  803. break;
  804. }
  805. isMenuClosing = false;
  806. }
  807. void RemoveSubMenu (int index)
  808. {
  809. if (openSubMenu == null)
  810. return;
  811. for (int i = openSubMenu.Count - 1; i > index; i--) {
  812. isMenuClosing = true;
  813. if (openSubMenu.Count - 1 > 0)
  814. SuperView.SetFocus (openSubMenu [i - 1]);
  815. else
  816. SuperView.SetFocus (openMenu);
  817. if (openSubMenu != null) {
  818. var menu = openSubMenu [i];
  819. SuperView.Remove (menu);
  820. openSubMenu.Remove (menu);
  821. menu.Dispose ();
  822. }
  823. RemoveSubMenu (i);
  824. }
  825. if (openSubMenu.Count > 0)
  826. openCurrentMenu = openSubMenu.Last ();
  827. //if (openMenu.Subviews.Count == 0)
  828. // return;
  829. //if (index == 0) {
  830. // //SuperView.SetFocus (previousSubFocused);
  831. // FocusPrev ();
  832. // return;
  833. //}
  834. //for (int i = openMenu.Subviews.Count - 1; i > index; i--) {
  835. // isMenuClosing = true;
  836. // if (openMenu.Subviews.Count - 1 > 0)
  837. // SuperView.SetFocus (openMenu.Subviews [i - 1]);
  838. // else
  839. // SuperView.SetFocus (openMenu);
  840. // if (openMenu != null) {
  841. // Remove (openMenu.Subviews [i]);
  842. // openMenu.Remove (openMenu.Subviews [i]);
  843. // }
  844. // RemoveSubMenu (i);
  845. //}
  846. isMenuClosing = false;
  847. }
  848. internal void RemoveAllOpensSubMenus ()
  849. {
  850. if (openSubMenu != null) {
  851. foreach (var item in openSubMenu) {
  852. SuperView.Remove (item);
  853. item.Dispose ();
  854. }
  855. }
  856. }
  857. internal void CloseAllMenus ()
  858. {
  859. if (!isMenuOpening && !isMenuClosing) {
  860. if (openSubMenu != null)
  861. CloseMenu (false, true);
  862. CloseMenu ();
  863. if (LastFocused != null && LastFocused != this)
  864. selected = -1;
  865. }
  866. IsMenuOpen = false;
  867. openedByHotKey = false;
  868. openedByAltKey = false;
  869. }
  870. View FindDeepestMenu (View view, ref int count)
  871. {
  872. count = count > 0 ? count : 0;
  873. foreach (var menu in view.Subviews) {
  874. if (menu is Menu) {
  875. count++;
  876. return FindDeepestMenu ((Menu)menu, ref count);
  877. }
  878. }
  879. return view;
  880. }
  881. internal void PreviousMenu (bool isSubMenu = false)
  882. {
  883. switch (isSubMenu) {
  884. case false:
  885. if (selected <= 0)
  886. selected = Menus.Length - 1;
  887. else
  888. selected--;
  889. if (selected > -1)
  890. CloseMenu (true, false);
  891. OpenMenu (selected);
  892. break;
  893. case true:
  894. if (selectedSub > -1) {
  895. selectedSub--;
  896. RemoveSubMenu (selectedSub);
  897. SetNeedsDisplay ();
  898. } else
  899. PreviousMenu ();
  900. break;
  901. }
  902. }
  903. internal void NextMenu (bool isSubMenu = false)
  904. {
  905. switch (isSubMenu) {
  906. case false:
  907. if (selected == -1)
  908. selected = 0;
  909. else if (selected + 1 == Menus.Length)
  910. selected = 0;
  911. else
  912. selected++;
  913. if (selected > -1)
  914. CloseMenu (true);
  915. OpenMenu (selected);
  916. break;
  917. case true:
  918. if (UseKeysUpDownAsKeysLeftRight) {
  919. CloseMenu (false, true);
  920. NextMenu ();
  921. } else {
  922. if ((selectedSub == -1 || openSubMenu == null || openSubMenu?.Count == selectedSub) && openCurrentMenu.barItems.Children [openCurrentMenu.current].SubMenu == null) {
  923. if (openSubMenu != null)
  924. CloseMenu (false, true);
  925. NextMenu ();
  926. } else if (openCurrentMenu.barItems.Children [openCurrentMenu.current].SubMenu != null ||
  927. !openCurrentMenu.barItems.Children [openCurrentMenu.current].IsFromSubMenu)
  928. selectedSub++;
  929. else
  930. return;
  931. SetNeedsDisplay ();
  932. openCurrentMenu.CheckSubMenu ();
  933. }
  934. break;
  935. }
  936. }
  937. bool openedByHotKey;
  938. internal bool FindAndOpenMenuByHotkey (KeyEvent kb)
  939. {
  940. //int pos = 0;
  941. var c = ((uint)kb.Key & (uint)Key.CharMask);
  942. for (int i = 0; i < Menus.Length; i++) {
  943. // TODO: this code is duplicated, hotkey should be part of the MenuBarItem
  944. var mi = Menus [i];
  945. int p = mi.Title.IndexOf ('_');
  946. if (p != -1 && p + 1 < mi.Title.RuneCount) {
  947. if (Char.ToUpperInvariant ((char)mi.Title [p + 1]) == c) {
  948. ProcessMenu (i, mi);
  949. return true;
  950. }
  951. }
  952. }
  953. return false;
  954. }
  955. private void ProcessMenu (int i, MenuBarItem mi)
  956. {
  957. if (mi.IsTopLevel) {
  958. var menu = new Menu (this, i, 0, mi);
  959. menu.Run (mi.Action);
  960. menu.Dispose ();
  961. } else {
  962. openedByHotKey = true;
  963. Application.GrabMouse (this);
  964. selected = i;
  965. OpenMenu (i);
  966. }
  967. }
  968. ///<inheritdoc/>
  969. public override bool ProcessHotKey (KeyEvent kb)
  970. {
  971. if (kb.Key == Key.F9) {
  972. if (!IsMenuOpen)
  973. OpenMenu ();
  974. else
  975. CloseAllMenus ();
  976. return true;
  977. }
  978. // To ncurses simulate a AltMask key pressing Alt+Space because
  979. // it can�t detect an alone special key down was pressed.
  980. if (kb.IsAlt && kb.Key == Key.AltMask && openMenu == null) {
  981. OnKeyDown (kb);
  982. OnKeyUp (kb);
  983. return true;
  984. } else if (kb.IsAlt) {
  985. if (FindAndOpenMenuByHotkey (kb)) return true;
  986. }
  987. //var kc = kb.KeyValue;
  988. return base.ProcessHotKey (kb);
  989. }
  990. ///<inheritdoc/>
  991. public override bool ProcessKey (KeyEvent kb)
  992. {
  993. switch (kb.Key) {
  994. case Key.CursorLeft:
  995. selected--;
  996. if (selected < 0)
  997. selected = Menus.Length - 1;
  998. break;
  999. case Key.CursorRight:
  1000. selected = (selected + 1) % Menus.Length;
  1001. break;
  1002. case Key.Esc:
  1003. case Key.ControlC:
  1004. //TODO: Running = false;
  1005. CloseMenu ();
  1006. if (openedByAltKey) {
  1007. openedByAltKey = false;
  1008. LastFocused.SuperView?.SetFocus (LastFocused);
  1009. }
  1010. break;
  1011. case Key.CursorDown:
  1012. case Key.Enter:
  1013. ProcessMenu (selected, Menus [selected]);
  1014. break;
  1015. default:
  1016. var key = kb.KeyValue;
  1017. if ((key >= 'a' && key <= 'z') || (key >= 'A' && key <= 'Z') || (key >= '0' && key <= '9')) {
  1018. char c = Char.ToUpper ((char)key);
  1019. if (selected == -1 || Menus [selected].IsTopLevel)
  1020. return false;
  1021. foreach (var mi in Menus [selected].Children) {
  1022. if (mi == null)
  1023. continue;
  1024. int p = mi.Title.IndexOf ('_');
  1025. if (p != -1 && p + 1 < mi.Title.RuneCount) {
  1026. if (mi.Title [p + 1] == c) {
  1027. Selected (mi);
  1028. return true;
  1029. }
  1030. }
  1031. }
  1032. }
  1033. return false;
  1034. }
  1035. SetNeedsDisplay ();
  1036. return true;
  1037. }
  1038. ///<inheritdoc/>
  1039. public override bool MouseEvent (MouseEvent me)
  1040. {
  1041. if (!handled && !HandleGrabView (me, this)) {
  1042. return false;
  1043. }
  1044. handled = false;
  1045. if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags == MouseFlags.Button1Clicked ||
  1046. (me.Flags == MouseFlags.ReportMousePosition && selected > -1) ||
  1047. (me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition) && selected > -1)) {
  1048. int pos = 1;
  1049. int cx = me.X;
  1050. for (int i = 0; i < Menus.Length; i++) {
  1051. if (cx > pos && me.X < pos + 1 + Menus [i].TitleLength) {
  1052. if (me.Flags == MouseFlags.Button1Clicked) {
  1053. if (Menus [i].IsTopLevel) {
  1054. var menu = new Menu (this, i, 0, Menus [i]);
  1055. menu.Run (Menus [i].Action);
  1056. menu.Dispose ();
  1057. }
  1058. } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked) {
  1059. if (IsMenuOpen) {
  1060. CloseAllMenus ();
  1061. } else {
  1062. Activate (i);
  1063. }
  1064. } else if (selected != i && selected > -1 && (me.Flags == MouseFlags.ReportMousePosition ||
  1065. me.Flags == MouseFlags.Button1Pressed && me.Flags == MouseFlags.ReportMousePosition)) {
  1066. if (IsMenuOpen) {
  1067. CloseMenu ();
  1068. Activate (i);
  1069. }
  1070. } else {
  1071. if (IsMenuOpen)
  1072. Activate (i);
  1073. }
  1074. return true;
  1075. }
  1076. pos += 2 + Menus [i].TitleLength + 1;
  1077. }
  1078. }
  1079. return false;
  1080. }
  1081. internal bool handled;
  1082. internal bool HandleGrabView (MouseEvent me, View current)
  1083. {
  1084. if (Application.mouseGrabView != null) {
  1085. if (me.View is MenuBar || me.View is Menu) {
  1086. if (me.View != current) {
  1087. Application.UngrabMouse ();
  1088. var v = me.View;
  1089. Application.GrabMouse (v);
  1090. var newxy = v.ScreenToView (me.X, me.Y);
  1091. var nme = new MouseEvent () {
  1092. X = newxy.X,
  1093. Y = newxy.Y,
  1094. Flags = me.Flags,
  1095. OfX = me.X - newxy.X,
  1096. OfY = me.Y - newxy.Y,
  1097. View = v
  1098. };
  1099. v.MouseEvent (nme);
  1100. }
  1101. } else if (!(me.View is MenuBar || me.View is Menu) && (me.Flags.HasFlag (MouseFlags.Button1Clicked) ||
  1102. me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked)) {
  1103. Application.UngrabMouse ();
  1104. CloseAllMenus ();
  1105. handled = false;
  1106. return false;
  1107. } else {
  1108. handled = false;
  1109. return false;
  1110. }
  1111. } else if (!IsMenuOpen && (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))) {
  1112. Application.GrabMouse (current);
  1113. } else if (IsMenuOpen && (me.View is MenuBar || me.View is Menu)) {
  1114. Application.GrabMouse (me.View);
  1115. } else {
  1116. handled = false;
  1117. return false;
  1118. }
  1119. //if (me.View != this && me.Flags != MouseFlags.Button1Pressed)
  1120. // return true;
  1121. //else if (me.View != this && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1122. // Application.UngrabMouse ();
  1123. // host.CloseAllMenus ();
  1124. // return true;
  1125. //}
  1126. //if (!(me.View is MenuBar) && !(me.View is Menu) && me.Flags != MouseFlags.Button1Pressed))
  1127. // return false;
  1128. //if (Application.mouseGrabView != null) {
  1129. // if (me.View is MenuBar || me.View is Menu) {
  1130. // me.X -= me.OfX;
  1131. // me.Y -= me.OfY;
  1132. // me.View.MouseEvent (me);
  1133. // return true;
  1134. // } else if (!(me.View is MenuBar || me.View is Menu) && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1135. // Application.UngrabMouse ();
  1136. // CloseAllMenus ();
  1137. // }
  1138. //} else if (!isMenuClosed && selected == -1 && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1139. // Application.GrabMouse (this);
  1140. // return true;
  1141. //}
  1142. //if (Application.mouseGrabView != null) {
  1143. // if (Application.mouseGrabView == me.View && me.View == current) {
  1144. // me.X -= me.OfX;
  1145. // me.Y -= me.OfY;
  1146. // } else if (me.View != current && me.View is MenuBar && me.View is Menu) {
  1147. // Application.UngrabMouse ();
  1148. // Application.GrabMouse (me.View);
  1149. // } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1150. // Application.UngrabMouse ();
  1151. // CloseMenu ();
  1152. // }
  1153. //} else if ((!isMenuClosed && selected > -1)) {
  1154. // Application.GrabMouse (current);
  1155. //}
  1156. handled = true;
  1157. return true;
  1158. }
  1159. }
  1160. }