Menu.cs 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275
  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.Length + 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)
  468. return true;
  469. if (me.Y - 1 >= barItems.Children.Length)
  470. return true;
  471. var item = barItems.Children [me.Y - 1];
  472. if (item == null || !item.IsEnabled ()) disabled = true;
  473. if (item != null && !disabled)
  474. current = me.Y - 1;
  475. CheckSubMenu ();
  476. return true;
  477. }
  478. return false;
  479. }
  480. internal void CheckSubMenu ()
  481. {
  482. if (barItems.Children [current] == null)
  483. return;
  484. var subMenu = barItems.Children [current].SubMenu;
  485. if (subMenu != null) {
  486. int pos = -1;
  487. if (host.openSubMenu != null)
  488. pos = host.openSubMenu.FindIndex (o => o?.barItems == subMenu);
  489. host.Activate (host.selected, pos, subMenu);
  490. } else if (host.openSubMenu != null && !barItems.Children [current].IsFromSubMenu)
  491. host.CloseMenu (false, true);
  492. }
  493. int GetSubMenuIndex (MenuBarItem subMenu)
  494. {
  495. int pos = -1;
  496. if (this != null && Subviews.Count > 0) {
  497. Menu v = null;
  498. foreach (var menu in Subviews) {
  499. if (((Menu)menu).barItems == subMenu)
  500. v = (Menu)menu;
  501. }
  502. if (v != null)
  503. pos = Subviews.IndexOf (v);
  504. }
  505. return pos;
  506. }
  507. }
  508. /// <summary>
  509. /// The MenuBar provides a menu for Terminal.Gui applications.
  510. /// </summary>
  511. /// <remarks>
  512. /// <para>
  513. /// The <see cref="MenuBar"/> appears on the first row of the terminal.
  514. /// </para>
  515. /// <para>
  516. /// The <see cref="MenuBar"/> provides global hotkeys for the application.
  517. /// </para>
  518. /// </remarks>
  519. public class MenuBar : View {
  520. /// <summary>
  521. /// Gets or sets the array of <see cref="MenuBarItem"/>s for the menu. Only set this when the <see cref="MenuBar"/> is vislble.
  522. /// </summary>
  523. /// <value>The menu array.</value>
  524. public MenuBarItem [] Menus { get; set; }
  525. internal int selected;
  526. internal int selectedSub;
  527. Action action;
  528. /// <summary>
  529. /// Used for change the navigation key style.
  530. /// </summary>
  531. public bool UseKeysUpDownAsKeysLeftRight { get; set; } = true;
  532. /// <summary>
  533. /// Initializes a new instance of the <see cref="MenuBar"/>.
  534. /// </summary>
  535. public MenuBar () : this (new MenuBarItem [] { }) { }
  536. /// <summary>
  537. /// Initializes a new instance of the <see cref="MenuBar"/> class with the specified set of toplevel menu items.
  538. /// </summary>
  539. /// <param name="menus">Individual menu items; a null item will result in a separator being drawn.</param>
  540. public MenuBar (MenuBarItem [] menus) : base ()
  541. {
  542. X = 0;
  543. Y = 0;
  544. Width = Dim.Fill ();
  545. Height = 1;
  546. Menus = menus;
  547. //CanFocus = true;
  548. selected = -1;
  549. selectedSub = -1;
  550. ColorScheme = Colors.Menu;
  551. WantMousePositionReports = true;
  552. IsMenuOpen = false;
  553. }
  554. bool openedByAltKey;
  555. ///<inheritdoc/>
  556. public override bool OnKeyDown (KeyEvent keyEvent)
  557. {
  558. if (keyEvent.IsAlt) {
  559. openedByAltKey = true;
  560. SetNeedsDisplay ();
  561. openedByHotKey = false;
  562. }
  563. return false;
  564. }
  565. ///<inheritdoc/>
  566. public override bool OnKeyUp (KeyEvent keyEvent)
  567. {
  568. if (keyEvent.IsAlt) {
  569. // User pressed Alt - this may be a precursor to a menu accelerator (e.g. Alt-F)
  570. if (!keyEvent.IsCtrl && openedByAltKey && !IsMenuOpen && openMenu == null && ((uint)keyEvent.Key & (uint)Key.CharMask) == 0) {
  571. // There's no open menu, the first menu item should be highlight.
  572. // The right way to do this is to SetFocus(MenuBar), but for some reason
  573. // that faults.
  574. //Activate (0);
  575. //StartMenu ();
  576. IsMenuOpen = true;
  577. selected = 0;
  578. CanFocus = true;
  579. lastFocused = SuperView.MostFocused;
  580. SuperView.SetFocus (this);
  581. SetNeedsDisplay ();
  582. Application.GrabMouse (this);
  583. } else if (!openedByHotKey) {
  584. // There's an open menu. If this Alt key-up is a pre-cursor to an accelerator
  585. // we don't want to close the menu because it'll flash.
  586. // How to deal with that?
  587. if (openMenu != null)
  588. CloseAllMenus ();
  589. openedByAltKey = false;
  590. IsMenuOpen = false;
  591. selected = -1;
  592. CanFocus = false;
  593. if (lastFocused != null)
  594. SuperView?.SetFocus (lastFocused);
  595. SetNeedsDisplay ();
  596. Application.UngrabMouse ();
  597. }
  598. return true;
  599. }
  600. return false;
  601. }
  602. ///<inheritdoc/>
  603. public override void Redraw (Rect bounds)
  604. {
  605. Move (0, 0);
  606. Driver.SetAttribute (Colors.Menu.Normal);
  607. for (int i = 0; i < Frame.Width; i++)
  608. Driver.AddRune (' ');
  609. Move (1, 0);
  610. int pos = 1;
  611. for (int i = 0; i < Menus.Length; i++) {
  612. var menu = Menus [i];
  613. Move (pos, 0);
  614. Attribute hotColor, normalColor;
  615. if (i == selected) {
  616. hotColor = i == selected ? ColorScheme.HotFocus : ColorScheme.HotNormal;
  617. normalColor = i == selected ? ColorScheme.Focus : ColorScheme.Normal;
  618. } else if (openedByAltKey) {
  619. hotColor = ColorScheme.HotNormal;
  620. normalColor = ColorScheme.Normal;
  621. } else {
  622. hotColor = ColorScheme.Normal;
  623. normalColor = ColorScheme.Normal;
  624. }
  625. DrawHotString ($" {menu.Title} ", hotColor, normalColor);
  626. pos += 1 + menu.TitleLength + 2;
  627. }
  628. PositionCursor ();
  629. }
  630. ///<inheritdoc/>
  631. public override void PositionCursor ()
  632. {
  633. int pos = 0;
  634. for (int i = 0; i < Menus.Length; i++) {
  635. if (i == selected) {
  636. pos++;
  637. if (IsMenuOpen)
  638. Move (pos + 1, 0);
  639. else
  640. Move (pos + 1, 0);
  641. return;
  642. } else {
  643. if (IsMenuOpen)
  644. pos += 1 + Menus [i].TitleLength + 2;
  645. else
  646. pos += 2 + Menus [i].TitleLength + 1;
  647. }
  648. }
  649. //Move (0, 0);
  650. }
  651. void Selected (MenuItem item)
  652. {
  653. // TODO: Running = false;
  654. action = item.Action;
  655. }
  656. /// <summary>
  657. /// Raised as a menu is opening.
  658. /// </summary>
  659. public Action MenuOpening;
  660. /// <summary>
  661. /// Raised when a menu is closing.
  662. /// </summary>
  663. public Action MenuClosing;
  664. internal Menu openMenu;
  665. Menu openCurrentMenu;
  666. internal List<Menu> openSubMenu;
  667. View previousFocused;
  668. internal bool isMenuOpening;
  669. internal bool isMenuClosing;
  670. /// <summary>
  671. /// True if the menu is open; otherwise false.
  672. /// </summary>
  673. public bool IsMenuOpen { get; protected set; }
  674. /// <summary>
  675. /// Virtual method that will invoke the <see cref="MenuOpening"/>
  676. /// </summary>
  677. public virtual void OnMenuOpening ()
  678. {
  679. MenuOpening?.Invoke ();
  680. }
  681. /// <summary>
  682. /// Virtual method that will invoke the <see cref="MenuClosing"/>
  683. /// </summary>
  684. public virtual void OnMenuClosing ()
  685. {
  686. MenuClosing?.Invoke ();
  687. }
  688. View lastFocused;
  689. /// <summary>
  690. /// Get the lasted focused view before open the menu.
  691. /// </summary>
  692. public View LastFocused { get; private set; }
  693. internal void OpenMenu (int index, int sIndex = -1, MenuBarItem subMenu = null)
  694. {
  695. isMenuOpening = true;
  696. OnMenuOpening ();
  697. int pos = 0;
  698. switch (subMenu) {
  699. case null:
  700. lastFocused = lastFocused ?? SuperView.MostFocused;
  701. if (openSubMenu != null)
  702. CloseMenu (false, true);
  703. if (openMenu != null)
  704. SuperView.Remove (openMenu);
  705. for (int i = 0; i < index; i++)
  706. pos += Menus [i].Title.Length + 2;
  707. openMenu = new Menu (this, pos, 1, Menus [index]);
  708. openCurrentMenu = openMenu;
  709. openCurrentMenu.previousSubFocused = openMenu;
  710. SuperView.Add (openMenu);
  711. SuperView.SetFocus (openMenu);
  712. break;
  713. default:
  714. if (openSubMenu == null)
  715. openSubMenu = new List<Menu> ();
  716. if (sIndex > -1) {
  717. RemoveSubMenu (sIndex);
  718. } else {
  719. var last = openSubMenu.Count > 0 ? openSubMenu.Last () : openMenu;
  720. openCurrentMenu = new Menu (this, last.Frame.Left + last.Frame.Width, last.Frame.Top + 1 + last.current, subMenu);
  721. openCurrentMenu.previousSubFocused = last.previousSubFocused;
  722. openSubMenu.Add (openCurrentMenu);
  723. SuperView.Add (openCurrentMenu);
  724. }
  725. selectedSub = openSubMenu.Count - 1;
  726. SuperView?.SetFocus (openCurrentMenu);
  727. break;
  728. }
  729. isMenuOpening = false;
  730. IsMenuOpen = true;
  731. }
  732. /// <summary>
  733. /// Opens the current Menu programatically.
  734. /// </summary>
  735. public void OpenMenu ()
  736. {
  737. if (openMenu != null)
  738. return;
  739. selected = 0;
  740. SetNeedsDisplay ();
  741. previousFocused = SuperView.Focused;
  742. OpenMenu (selected);
  743. Application.GrabMouse (this);
  744. }
  745. // Activates the menu, handles either first focus, or activating an entry when it was already active
  746. // For mouse events.
  747. internal void Activate (int idx, int sIdx = -1, MenuBarItem subMenu = null)
  748. {
  749. selected = idx;
  750. selectedSub = sIdx;
  751. if (openMenu == null)
  752. previousFocused = SuperView.Focused;
  753. OpenMenu (idx, sIdx, subMenu);
  754. SetNeedsDisplay ();
  755. }
  756. /// <summary>
  757. /// Closes the current Menu programatically, if open.
  758. /// </summary>
  759. public void CloseMenu ()
  760. {
  761. CloseMenu (false, false);
  762. }
  763. internal void CloseMenu (bool reopen = false, bool isSubMenu = false)
  764. {
  765. isMenuClosing = true;
  766. OnMenuClosing ();
  767. switch (isSubMenu) {
  768. case false:
  769. if (openMenu != null)
  770. SuperView.Remove (openMenu);
  771. SetNeedsDisplay ();
  772. if (previousFocused != null && openMenu != null && previousFocused.ToString () != openCurrentMenu.ToString ())
  773. previousFocused?.SuperView?.SetFocus (previousFocused);
  774. openMenu = null;
  775. if (lastFocused is Menu) {
  776. lastFocused = null;
  777. }
  778. LastFocused = lastFocused;
  779. lastFocused = null;
  780. if (LastFocused != null) {
  781. if (!reopen)
  782. selected = -1;
  783. LastFocused.SuperView?.SetFocus (LastFocused);
  784. } else {
  785. SuperView.SetFocus (this);
  786. PositionCursor ();
  787. }
  788. IsMenuOpen = false;
  789. break;
  790. case true:
  791. selectedSub = -1;
  792. SetNeedsDisplay ();
  793. RemoveAllOpensSubMenus ();
  794. openCurrentMenu.previousSubFocused?.SuperView?.SetFocus (openCurrentMenu.previousSubFocused);
  795. openSubMenu = null;
  796. IsMenuOpen = true;
  797. break;
  798. }
  799. isMenuClosing = false;
  800. }
  801. void RemoveSubMenu (int index)
  802. {
  803. if (openSubMenu == null)
  804. return;
  805. for (int i = openSubMenu.Count - 1; i > index; i--) {
  806. isMenuClosing = true;
  807. if (openSubMenu.Count - 1 > 0)
  808. SuperView.SetFocus (openSubMenu [i - 1]);
  809. else
  810. SuperView.SetFocus (openMenu);
  811. if (openSubMenu != null) {
  812. SuperView.Remove (openSubMenu [i]);
  813. openSubMenu.Remove (openSubMenu [i]);
  814. }
  815. RemoveSubMenu (i);
  816. }
  817. if (openSubMenu.Count > 0)
  818. openCurrentMenu = openSubMenu.Last ();
  819. //if (openMenu.Subviews.Count == 0)
  820. // return;
  821. //if (index == 0) {
  822. // //SuperView.SetFocus (previousSubFocused);
  823. // FocusPrev ();
  824. // return;
  825. //}
  826. //for (int i = openMenu.Subviews.Count - 1; i > index; i--) {
  827. // isMenuClosing = true;
  828. // if (openMenu.Subviews.Count - 1 > 0)
  829. // SuperView.SetFocus (openMenu.Subviews [i - 1]);
  830. // else
  831. // SuperView.SetFocus (openMenu);
  832. // if (openMenu != null) {
  833. // Remove (openMenu.Subviews [i]);
  834. // openMenu.Remove (openMenu.Subviews [i]);
  835. // }
  836. // RemoveSubMenu (i);
  837. //}
  838. isMenuClosing = false;
  839. }
  840. internal void RemoveAllOpensSubMenus ()
  841. {
  842. if (openSubMenu != null) {
  843. foreach (var item in openSubMenu) {
  844. SuperView.Remove (item);
  845. }
  846. }
  847. }
  848. internal void CloseAllMenus ()
  849. {
  850. if (!isMenuOpening && !isMenuClosing) {
  851. if (openSubMenu != null)
  852. CloseMenu (false, true);
  853. CloseMenu ();
  854. if (LastFocused != null && LastFocused != this)
  855. selected = -1;
  856. }
  857. IsMenuOpen = false;
  858. openedByHotKey = false;
  859. openedByAltKey = false;
  860. }
  861. View FindDeepestMenu (View view, ref int count)
  862. {
  863. count = count > 0 ? count : 0;
  864. foreach (var menu in view.Subviews) {
  865. if (menu is Menu) {
  866. count++;
  867. return FindDeepestMenu ((Menu)menu, ref count);
  868. }
  869. }
  870. return view;
  871. }
  872. internal void PreviousMenu (bool isSubMenu = false)
  873. {
  874. switch (isSubMenu) {
  875. case false:
  876. if (selected <= 0)
  877. selected = Menus.Length - 1;
  878. else
  879. selected--;
  880. if (selected > -1)
  881. CloseMenu (true, false);
  882. OpenMenu (selected);
  883. break;
  884. case true:
  885. if (selectedSub > -1) {
  886. selectedSub--;
  887. RemoveSubMenu (selectedSub);
  888. SetNeedsDisplay ();
  889. } else
  890. PreviousMenu ();
  891. break;
  892. }
  893. }
  894. internal void NextMenu (bool isSubMenu = false)
  895. {
  896. switch (isSubMenu) {
  897. case false:
  898. if (selected == -1)
  899. selected = 0;
  900. else if (selected + 1 == Menus.Length)
  901. selected = 0;
  902. else
  903. selected++;
  904. if (selected > -1)
  905. CloseMenu (true);
  906. OpenMenu (selected);
  907. break;
  908. case true:
  909. if (UseKeysUpDownAsKeysLeftRight) {
  910. CloseMenu (false, true);
  911. NextMenu ();
  912. } else {
  913. if ((selectedSub == -1 || openSubMenu == null || openSubMenu?.Count == selectedSub) && openCurrentMenu.barItems.Children [openCurrentMenu.current].SubMenu == null) {
  914. if (openSubMenu != null)
  915. CloseMenu (false, true);
  916. NextMenu ();
  917. } else if (openCurrentMenu.barItems.Children [openCurrentMenu.current].SubMenu != null ||
  918. !openCurrentMenu.barItems.Children [openCurrentMenu.current].IsFromSubMenu)
  919. selectedSub++;
  920. else
  921. return;
  922. SetNeedsDisplay ();
  923. openCurrentMenu.CheckSubMenu ();
  924. }
  925. break;
  926. }
  927. }
  928. bool openedByHotKey;
  929. internal bool FindAndOpenMenuByHotkey (KeyEvent kb)
  930. {
  931. //int pos = 0;
  932. var c = ((uint)kb.Key & (uint)Key.CharMask);
  933. for (int i = 0; i < Menus.Length; i++) {
  934. // TODO: this code is duplicated, hotkey should be part of the MenuBarItem
  935. var mi = Menus [i];
  936. int p = mi.Title.IndexOf ('_');
  937. if (p != -1 && p + 1 < mi.Title.Length) {
  938. if (Char.ToUpperInvariant ((char)mi.Title [p + 1]) == c) {
  939. ProcessMenu (i, mi);
  940. return true;
  941. }
  942. }
  943. }
  944. return false;
  945. }
  946. private void ProcessMenu (int i, MenuBarItem mi)
  947. {
  948. if (mi.IsTopLevel) {
  949. var menu = new Menu (this, i, 0, mi);
  950. menu.Run (mi.Action);
  951. } else {
  952. openedByHotKey = true;
  953. Application.GrabMouse (this);
  954. selected = i;
  955. OpenMenu (i);
  956. }
  957. }
  958. ///<inheritdoc/>
  959. public override bool ProcessHotKey (KeyEvent kb)
  960. {
  961. if (kb.Key == Key.F9) {
  962. if (!IsMenuOpen)
  963. OpenMenu ();
  964. else
  965. CloseAllMenus ();
  966. return true;
  967. }
  968. // To ncurses simulate a AltMask key pressing Alt+Space because
  969. // it can�t detect an alone special key down was pressed.
  970. if (kb.IsAlt && kb.Key == Key.AltMask && openMenu == null) {
  971. OnKeyDown (kb);
  972. OnKeyUp (kb);
  973. return true;
  974. } else if (kb.IsAlt) {
  975. if (FindAndOpenMenuByHotkey (kb)) return true;
  976. }
  977. //var kc = kb.KeyValue;
  978. return base.ProcessHotKey (kb);
  979. }
  980. ///<inheritdoc/>
  981. public override bool ProcessKey (KeyEvent kb)
  982. {
  983. switch (kb.Key) {
  984. case Key.CursorLeft:
  985. selected--;
  986. if (selected < 0)
  987. selected = Menus.Length - 1;
  988. break;
  989. case Key.CursorRight:
  990. selected = (selected + 1) % Menus.Length;
  991. break;
  992. case Key.Esc:
  993. case Key.ControlC:
  994. //TODO: Running = false;
  995. CloseMenu ();
  996. if (openedByAltKey) {
  997. openedByAltKey = false;
  998. LastFocused.SuperView?.SetFocus (LastFocused);
  999. }
  1000. break;
  1001. case Key.CursorDown:
  1002. case Key.Enter:
  1003. ProcessMenu (selected, Menus [selected]);
  1004. break;
  1005. default:
  1006. var key = kb.KeyValue;
  1007. if ((key >= 'a' && key <= 'z') || (key >= 'A' && key <= 'Z') || (key >= '0' && key <= '9')) {
  1008. char c = Char.ToUpper ((char)key);
  1009. if (selected == -1 || Menus [selected].IsTopLevel)
  1010. return false;
  1011. foreach (var mi in Menus [selected].Children) {
  1012. if (mi == null)
  1013. continue;
  1014. int p = mi.Title.IndexOf ('_');
  1015. if (p != -1 && p + 1 < mi.Title.Length) {
  1016. if (mi.Title [p + 1] == c) {
  1017. Selected (mi);
  1018. return true;
  1019. }
  1020. }
  1021. }
  1022. }
  1023. return false;
  1024. }
  1025. SetNeedsDisplay ();
  1026. return true;
  1027. }
  1028. ///<inheritdoc/>
  1029. public override bool MouseEvent (MouseEvent me)
  1030. {
  1031. if (!handled && !HandleGrabView (me, this)) {
  1032. return false;
  1033. }
  1034. handled = false;
  1035. if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags == MouseFlags.Button1Clicked ||
  1036. (me.Flags == MouseFlags.ReportMousePosition && selected > -1) ||
  1037. (me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition) && selected > -1)) {
  1038. int pos = 1;
  1039. int cx = me.X;
  1040. for (int i = 0; i < Menus.Length; i++) {
  1041. if (cx > pos && me.X < pos + 1 + Menus [i].TitleLength) {
  1042. if (me.Flags == MouseFlags.Button1Clicked) {
  1043. if (Menus [i].IsTopLevel) {
  1044. var menu = new Menu (this, i, 0, Menus [i]);
  1045. menu.Run (Menus [i].Action);
  1046. }
  1047. } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked) {
  1048. if (IsMenuOpen) {
  1049. CloseAllMenus ();
  1050. } else {
  1051. Activate (i);
  1052. }
  1053. } else if (selected != i && selected > -1 && (me.Flags == MouseFlags.ReportMousePosition ||
  1054. me.Flags == MouseFlags.Button1Pressed && me.Flags == MouseFlags.ReportMousePosition)) {
  1055. if (IsMenuOpen) {
  1056. CloseMenu ();
  1057. Activate (i);
  1058. }
  1059. } else {
  1060. if (IsMenuOpen)
  1061. Activate (i);
  1062. }
  1063. return true;
  1064. }
  1065. pos += 2 + Menus [i].TitleLength + 1;
  1066. }
  1067. }
  1068. return false;
  1069. }
  1070. internal bool handled;
  1071. internal bool HandleGrabView (MouseEvent me, View current)
  1072. {
  1073. if (Application.mouseGrabView != null) {
  1074. if (me.View is MenuBar || me.View is Menu) {
  1075. if (me.View != current) {
  1076. Application.UngrabMouse ();
  1077. Application.GrabMouse (me.View);
  1078. me.View.MouseEvent (me);
  1079. }
  1080. } else if (!(me.View is MenuBar || me.View is Menu) && (me.Flags.HasFlag (MouseFlags.Button1Clicked) ||
  1081. me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked)) {
  1082. Application.UngrabMouse ();
  1083. CloseAllMenus ();
  1084. handled = false;
  1085. return false;
  1086. } else {
  1087. handled = false;
  1088. return false;
  1089. }
  1090. } else if (!IsMenuOpen && (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked || me.Flags == MouseFlags.Button1TripleClicked || me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))) {
  1091. Application.GrabMouse (current);
  1092. } else if (IsMenuOpen && (me.View is MenuBar || me.View is Menu)) {
  1093. Application.GrabMouse (me.View);
  1094. } else {
  1095. handled = false;
  1096. return false;
  1097. }
  1098. //if (me.View != this && me.Flags != MouseFlags.Button1Pressed)
  1099. // return true;
  1100. //else if (me.View != this && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1101. // Application.UngrabMouse ();
  1102. // host.CloseAllMenus ();
  1103. // return true;
  1104. //}
  1105. //if (!(me.View is MenuBar) && !(me.View is Menu) && me.Flags != MouseFlags.Button1Pressed))
  1106. // return false;
  1107. //if (Application.mouseGrabView != null) {
  1108. // if (me.View is MenuBar || me.View is Menu) {
  1109. // me.X -= me.OfX;
  1110. // me.Y -= me.OfY;
  1111. // me.View.MouseEvent (me);
  1112. // return true;
  1113. // } else if (!(me.View is MenuBar || me.View is Menu) && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1114. // Application.UngrabMouse ();
  1115. // CloseAllMenus ();
  1116. // }
  1117. //} else if (!isMenuClosed && selected == -1 && me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1118. // Application.GrabMouse (this);
  1119. // return true;
  1120. //}
  1121. //if (Application.mouseGrabView != null) {
  1122. // if (Application.mouseGrabView == me.View && me.View == current) {
  1123. // me.X -= me.OfX;
  1124. // me.Y -= me.OfY;
  1125. // } else if (me.View != current && me.View is MenuBar && me.View is Menu) {
  1126. // Application.UngrabMouse ();
  1127. // Application.GrabMouse (me.View);
  1128. // } else if (me.Flags == MouseFlags.Button1Pressed || me.Flags == MouseFlags.Button1DoubleClicked) {
  1129. // Application.UngrabMouse ();
  1130. // CloseMenu ();
  1131. // }
  1132. //} else if ((!isMenuClosed && selected > -1)) {
  1133. // Application.GrabMouse (current);
  1134. //}
  1135. handled = true;
  1136. return true;
  1137. }
  1138. }
  1139. }