Menu.cs 40 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351
  1. namespace Terminal.Gui;
  2. /// <summary>Specifies how a <see cref="MenuItem"/> shows selection state.</summary>
  3. [Flags]
  4. public enum MenuItemCheckStyle
  5. {
  6. /// <summary>The menu item will be shown normally, with no check indicator. The default.</summary>
  7. NoCheck = 0b_0000_0000,
  8. /// <summary>The menu item will indicate checked/un-checked state (see <see cref="Checked"/>).</summary>
  9. Checked = 0b_0000_0001,
  10. /// <summary>The menu item is part of a menu radio group (see <see cref="Checked"/>) and will indicate selected state.</summary>
  11. Radio = 0b_0000_0010
  12. }
  13. /// <summary>
  14. /// A <see cref="MenuItem"/> has title, an associated help text, and an action to execute on activation. MenuItems
  15. /// can also have a checked indicator (see <see cref="Checked"/>).
  16. /// </summary>
  17. public class MenuItem
  18. {
  19. private readonly ShortcutHelper _shortcutHelper;
  20. private bool _allowNullChecked;
  21. private MenuItemCheckStyle _checkType;
  22. private string _title;
  23. // TODO: Update to use Key instead of KeyCode
  24. /// <summary>Initializes a new instance of <see cref="MenuItem"/></summary>
  25. public MenuItem (KeyCode shortcut = KeyCode.Null) : this ("", "", null, null, null, shortcut) { }
  26. // TODO: Update to use Key instead of KeyCode
  27. /// <summary>Initializes a new instance of <see cref="MenuItem"/>.</summary>
  28. /// <param name="title">Title for the menu item.</param>
  29. /// <param name="help">Help text to display.</param>
  30. /// <param name="action">Action to invoke when the menu item is activated.</param>
  31. /// <param name="canExecute">Function to determine if the action can currently be executed.</param>
  32. /// <param name="parent">The <see cref="Parent"/> of this menu item.</param>
  33. /// <param name="shortcut">The <see cref="Shortcut"/> keystroke combination.</param>
  34. public MenuItem (
  35. string title,
  36. string help,
  37. Action action,
  38. Func<bool> canExecute = null,
  39. MenuItem parent = null,
  40. KeyCode shortcut = KeyCode.Null
  41. )
  42. {
  43. Title = title ?? "";
  44. Help = help ?? "";
  45. Action = action;
  46. CanExecute = canExecute;
  47. Parent = parent;
  48. _shortcutHelper = new ShortcutHelper ();
  49. if (shortcut != KeyCode.Null)
  50. {
  51. Shortcut = shortcut;
  52. }
  53. }
  54. /// <summary>Gets or sets the action to be invoked when the menu item is triggered.</summary>
  55. /// <value>Method to invoke.</value>
  56. public Action Action { get; set; }
  57. /// <summary>
  58. /// Used only if <see cref="CheckType"/> is of <see cref="MenuItemCheckStyle.Checked"/> type. If
  59. /// <see langword="true"/> allows <see cref="Checked"/> to be null, true or false. If <see langword="false"/> only
  60. /// allows <see cref="Checked"/> to be true or false.
  61. /// </summary>
  62. public bool AllowNullChecked
  63. {
  64. get => _allowNullChecked;
  65. set
  66. {
  67. _allowNullChecked = value;
  68. Checked ??= false;
  69. }
  70. }
  71. /// <summary>
  72. /// Gets or sets the action to be invoked to determine if the menu can be triggered. If <see cref="CanExecute"/>
  73. /// returns <see langword="true"/> the menu item will be enabled. Otherwise, it will be disabled.
  74. /// </summary>
  75. /// <value>Function to determine if the action is can be executed or not.</value>
  76. public Func<bool> CanExecute { get; set; }
  77. /// <summary>
  78. /// Sets or gets whether the <see cref="MenuItem"/> shows a check indicator or not. See
  79. /// <see cref="MenuItemCheckStyle"/>.
  80. /// </summary>
  81. public bool? Checked { set; get; }
  82. /// <summary>
  83. /// Sets or gets the <see cref="MenuItemCheckStyle"/> of a menu item where <see cref="Checked"/> is set to
  84. /// <see langword="true"/>.
  85. /// </summary>
  86. public MenuItemCheckStyle CheckType
  87. {
  88. get => _checkType;
  89. set
  90. {
  91. _checkType = value;
  92. if (_checkType == MenuItemCheckStyle.Checked && !_allowNullChecked && Checked is null)
  93. {
  94. Checked = false;
  95. }
  96. }
  97. }
  98. /// <summary>Gets or sets arbitrary data for the menu item.</summary>
  99. /// <remarks>This property is not used internally.</remarks>
  100. public object Data { get; set; }
  101. /// <summary>Gets or sets the help text for the menu item. The help text is drawn to the right of the <see cref="Title"/>.</summary>
  102. /// <value>The help text.</value>
  103. public string Help { get; set; }
  104. /// <summary>Gets the parent for this <see cref="MenuItem"/>.</summary>
  105. /// <value>The parent.</value>
  106. public MenuItem Parent { get; set; }
  107. /// <summary>Gets or sets the title of the menu item .</summary>
  108. /// <value>The title.</value>
  109. public string Title
  110. {
  111. get => _title;
  112. set
  113. {
  114. if (_title == value)
  115. {
  116. return;
  117. }
  118. _title = value;
  119. GetHotKey ();
  120. }
  121. }
  122. /// <summary>Gets if this <see cref="MenuItem"/> is from a sub-menu.</summary>
  123. internal bool IsFromSubMenu => Parent != null;
  124. internal int TitleLength => GetMenuBarItemLength (Title);
  125. //
  126. // ┌─────────────────────────────┐
  127. // │ Quit Quit UI Catalog Ctrl+Q │
  128. // └─────────────────────────────┘
  129. // ┌─────────────────┐
  130. // │ ◌ TopLevel Alt+T │
  131. // └─────────────────┘
  132. // TODO: Replace the `2` literals with named constants
  133. internal int Width => 1
  134. + // space before Title
  135. TitleLength
  136. + 2
  137. + // space after Title - BUGBUG: This should be 1
  138. (Checked == true || CheckType.HasFlag (MenuItemCheckStyle.Checked) || CheckType.HasFlag (MenuItemCheckStyle.Radio)
  139. ? 2
  140. : 0)
  141. + // check glyph + space
  142. (Help.GetColumns () > 0 ? 2 + Help.GetColumns () : 0)
  143. + // Two spaces before Help
  144. (ShortcutTag.GetColumns () > 0
  145. ? 2 + ShortcutTag.GetColumns ()
  146. : 0); // Pad two spaces before shortcut tag (which are also aligned right)
  147. /// <summary>Merely a debugging aid to see the interaction with main.</summary>
  148. public bool GetMenuBarItem () { return IsFromSubMenu; }
  149. /// <summary>Merely a debugging aid to see the interaction with main.</summary>
  150. public MenuItem GetMenuItem () { return this; }
  151. /// <summary>
  152. /// Returns <see langword="true"/> if the menu item is enabled. This method is a wrapper around
  153. /// <see cref="CanExecute"/>.
  154. /// </summary>
  155. public bool IsEnabled () { return CanExecute?.Invoke () ?? true; }
  156. /// <summary>
  157. /// Toggle the <see cref="Checked"/> between three states if <see cref="AllowNullChecked"/> is
  158. /// <see langword="true"/> or between two states if <see cref="AllowNullChecked"/> is <see langword="false"/>.
  159. /// </summary>
  160. public void ToggleChecked ()
  161. {
  162. if (_checkType != MenuItemCheckStyle.Checked)
  163. {
  164. throw new InvalidOperationException ("This isn't a Checked MenuItemCheckStyle!");
  165. }
  166. bool? previousChecked = Checked;
  167. if (AllowNullChecked)
  168. {
  169. Checked = previousChecked switch
  170. {
  171. null => true,
  172. true => false,
  173. false => null
  174. };
  175. }
  176. else
  177. {
  178. Checked = !Checked;
  179. }
  180. }
  181. private static int GetMenuBarItemLength (string title)
  182. {
  183. return title.EnumerateRunes ()
  184. .Where (ch => ch != MenuBar.HotKeySpecifier)
  185. .Sum (ch => Math.Max (ch.GetColumns (), 1));
  186. }
  187. #region Keyboard Handling
  188. // TODO: Update to use Key instead of Rune
  189. /// <summary>
  190. /// The HotKey is used to activate a <see cref="MenuItem"/> with the keyboard. HotKeys are defined by prefixing the
  191. /// <see cref="Title"/> of a MenuItem with an underscore ('_').
  192. /// <para>
  193. /// Pressing Alt-Hotkey for a <see cref="MenuBarItem"/> (menu items on the menu bar) works even if the menu is
  194. /// not active). Once a menu has focus and is active, pressing just the HotKey will activate the MenuItem.
  195. /// </para>
  196. /// <para>
  197. /// For example for a MenuBar with a "_File" MenuBarItem that contains a "_New" MenuItem, Alt-F will open the
  198. /// File menu. Pressing the N key will then activate the New MenuItem.
  199. /// </para>
  200. /// <para>See also <see cref="Shortcut"/> which enable global key-bindings to menu items.</para>
  201. /// </summary>
  202. public Rune HotKey { get; set; }
  203. private void GetHotKey ()
  204. {
  205. var nextIsHot = false;
  206. foreach (char x in _title)
  207. {
  208. if (x == MenuBar.HotKeySpecifier.Value)
  209. {
  210. nextIsHot = true;
  211. }
  212. else
  213. {
  214. if (nextIsHot)
  215. {
  216. HotKey = (Rune)char.ToUpper (x);
  217. break;
  218. }
  219. nextIsHot = false;
  220. HotKey = default (Rune);
  221. }
  222. }
  223. }
  224. // TODO: Update to use Key instead of KeyCode
  225. /// <summary>
  226. /// Shortcut defines a key binding to the MenuItem that will invoke the MenuItem's action globally for the
  227. /// <see cref="View"/> that is the parent of the <see cref="MenuBar"/> or <see cref="ContextMenu"/> this
  228. /// <see cref="MenuItem"/>.
  229. /// <para>
  230. /// The <see cref="KeyCode"/> will be drawn on the MenuItem to the right of the <see cref="Title"/> and
  231. /// <see cref="Help"/> text. See <see cref="ShortcutTag"/>.
  232. /// </para>
  233. /// </summary>
  234. public KeyCode Shortcut
  235. {
  236. get => _shortcutHelper.Shortcut;
  237. set
  238. {
  239. if (_shortcutHelper.Shortcut != value && (ShortcutHelper.PostShortcutValidation (value) || value == KeyCode.Null))
  240. {
  241. _shortcutHelper.Shortcut = value;
  242. }
  243. }
  244. }
  245. /// <summary>Gets the text describing the keystroke combination defined by <see cref="Shortcut"/>.</summary>
  246. public string ShortcutTag => _shortcutHelper.Shortcut == KeyCode.Null
  247. ? string.Empty
  248. : Key.ToString (_shortcutHelper.Shortcut, MenuBar.ShortcutDelimiter);
  249. #endregion Keyboard Handling
  250. }
  251. /// <summary>
  252. /// An internal class used to represent a menu pop-up menu. Created and managed by <see cref="MenuBar"/> and
  253. /// <see cref="ContextMenu"/>.
  254. /// </summary>
  255. internal sealed class Menu : View
  256. {
  257. private readonly MenuBarItem _barItems;
  258. private readonly MenuBar _host;
  259. internal int _currentChild;
  260. internal View _previousSubFocused;
  261. internal static Rectangle MakeFrame (int x, int y, MenuItem [] items, Menu parent = null)
  262. {
  263. if (items is null || items.Length == 0)
  264. {
  265. return Rectangle.Empty;
  266. }
  267. int minX = x;
  268. int minY = y;
  269. const int borderOffset = 2; // This 2 is for the space around
  270. int maxW = (items.Max (z => z?.Width) ?? 0) + borderOffset;
  271. int maxH = items.Length + borderOffset;
  272. if (parent is { } && x + maxW > Driver.Cols)
  273. {
  274. minX = Math.Max (parent.Frame.Right - parent.Frame.Width - maxW, 0);
  275. }
  276. if (y + maxH > Driver.Rows)
  277. {
  278. minY = Math.Max (Driver.Rows - maxH, 0);
  279. }
  280. return new (minX, minY, maxW, maxH);
  281. }
  282. internal required MenuBar Host
  283. {
  284. get => _host;
  285. init
  286. {
  287. ArgumentNullException.ThrowIfNull (value);
  288. _host = value;
  289. }
  290. }
  291. internal required MenuBarItem BarItems
  292. {
  293. get => _barItems;
  294. init
  295. {
  296. ArgumentNullException.ThrowIfNull (value);
  297. _barItems = value;
  298. // Debugging aid so ToString() is helpful
  299. Text = _barItems.Title;
  300. }
  301. }
  302. internal Menu Parent { get; init; }
  303. public override void BeginInit ()
  304. {
  305. base.BeginInit ();
  306. Frame = MakeFrame (Frame.X, Frame.Y, _barItems?.Children, Parent);
  307. if (_barItems is { IsTopLevel: true })
  308. {
  309. // This is a standalone MenuItem on a MenuBar
  310. ColorScheme = _host.ColorScheme;
  311. CanFocus = true;
  312. }
  313. else
  314. {
  315. _currentChild = -1;
  316. for (var i = 0; i < _barItems!.Children?.Length; i++)
  317. {
  318. if (_barItems.Children [i]?.IsEnabled () == true)
  319. {
  320. _currentChild = i;
  321. break;
  322. }
  323. }
  324. ColorScheme = _host.ColorScheme;
  325. CanFocus = true;
  326. WantMousePositionReports = _host.WantMousePositionReports;
  327. }
  328. BorderStyle = _host.MenusBorderStyle;
  329. AddCommand (
  330. Command.Right,
  331. () =>
  332. {
  333. _host.NextMenu (
  334. !_barItems.IsTopLevel
  335. || (_barItems.Children != null
  336. && _barItems!.Children.Length > 0
  337. && _currentChild > -1
  338. && _currentChild < _barItems.Children.Length
  339. && _barItems.Children [_currentChild].IsFromSubMenu),
  340. _barItems!.Children != null
  341. && _barItems.Children.Length > 0
  342. && _currentChild > -1
  343. && _host.UseSubMenusSingleFrame
  344. && _barItems.SubMenu (
  345. _barItems.Children [_currentChild]
  346. )
  347. != null
  348. );
  349. return true;
  350. }
  351. );
  352. AddKeyBindings (_barItems);
  353. #if SUPPORT_ALT_TO_ACTIVATE_MENU
  354. Initialized += (s, e) =>
  355. {
  356. if (SuperView is { })
  357. {
  358. SuperView.KeyUp += SuperView_KeyUp;
  359. }
  360. };
  361. #endif
  362. }
  363. public Menu ()
  364. {
  365. if (Application.Current is { })
  366. {
  367. Application.Current.DrawContentComplete += Current_DrawContentComplete;
  368. Application.Current.SizeChanging += Current_TerminalResized;
  369. }
  370. Application.MouseEvent += Application_RootMouseEvent;
  371. // Things this view knows how to do
  372. AddCommand (Command.LineUp, () => MoveUp ());
  373. AddCommand (Command.LineDown, () => MoveDown ());
  374. AddCommand (
  375. Command.Left,
  376. () =>
  377. {
  378. _host.PreviousMenu (true);
  379. return true;
  380. }
  381. );
  382. AddCommand (
  383. Command.Cancel,
  384. () =>
  385. {
  386. CloseAllMenus ();
  387. return true;
  388. }
  389. );
  390. AddCommand (
  391. Command.Accept,
  392. () =>
  393. {
  394. RunSelected ();
  395. return true;
  396. }
  397. );
  398. AddCommand (Command.Select, () => _host?.SelectItem (_menuItemToSelect));
  399. AddCommand (Command.ToggleExpandCollapse, () => SelectOrRun ());
  400. AddCommand (Command.HotKey, () => _host?.SelectItem (_menuItemToSelect));
  401. // Default key bindings for this view
  402. KeyBindings.Add (Key.CursorUp, Command.LineUp);
  403. KeyBindings.Add (Key.CursorDown, Command.LineDown);
  404. KeyBindings.Add (Key.CursorLeft, Command.Left);
  405. KeyBindings.Add (Key.CursorRight, Command.Right);
  406. KeyBindings.Add (Key.Esc, Command.Cancel);
  407. KeyBindings.Add (Key.Enter, Command.Accept);
  408. KeyBindings.Add (Key.F9, KeyBindingScope.HotKey, Command.ToggleExpandCollapse);
  409. KeyBindings.Add (
  410. KeyCode.CtrlMask | KeyCode.Space,
  411. KeyBindingScope.HotKey,
  412. Command.ToggleExpandCollapse
  413. );
  414. }
  415. #if SUPPORT_ALT_TO_ACTIVATE_MENU
  416. void SuperView_KeyUp (object sender, KeyEventArgs e)
  417. {
  418. if (SuperView is null || SuperView.CanFocus == false || SuperView.Visible == false)
  419. {
  420. return;
  421. }
  422. _host.AltKeyUpHandler (e);
  423. }
  424. #endif
  425. private void AddKeyBindings (MenuBarItem menuBarItem)
  426. {
  427. if (menuBarItem is null || menuBarItem.Children is null)
  428. {
  429. return;
  430. }
  431. foreach (MenuItem menuItem in menuBarItem.Children.Where (m => m is { }))
  432. {
  433. KeyBindings.Add ((KeyCode)menuItem.HotKey.Value, Command.ToggleExpandCollapse);
  434. KeyBindings.Add (
  435. (KeyCode)menuItem.HotKey.Value | KeyCode.AltMask,
  436. Command.ToggleExpandCollapse
  437. );
  438. if (menuItem.Shortcut != KeyCode.Null)
  439. {
  440. KeyBindings.Add (menuItem.Shortcut, KeyBindingScope.HotKey, Command.Select);
  441. }
  442. MenuBarItem subMenu = menuBarItem.SubMenu (menuItem);
  443. AddKeyBindings (subMenu);
  444. }
  445. }
  446. private int _menuBarItemToActivate = -1;
  447. private MenuItem _menuItemToSelect;
  448. /// <summary>Called when a key bound to Command.Select is pressed. This means a hot key was pressed.</summary>
  449. /// <returns></returns>
  450. private bool SelectOrRun ()
  451. {
  452. if (!IsInitialized || !Visible)
  453. {
  454. return true;
  455. }
  456. if (_menuBarItemToActivate != -1)
  457. {
  458. _host.Activate (1, _menuBarItemToActivate);
  459. }
  460. else if (_menuItemToSelect is { })
  461. {
  462. var m = _menuItemToSelect as MenuBarItem;
  463. if (m?.Children?.Length > 0)
  464. {
  465. MenuItem item = _barItems.Children [_currentChild];
  466. if (item is null)
  467. {
  468. return true;
  469. }
  470. bool disabled = item is null || !item.IsEnabled ();
  471. if (!disabled && (_host.UseSubMenusSingleFrame || !CheckSubMenu ()))
  472. {
  473. SetNeedsDisplay ();
  474. SetParentSetNeedsDisplay ();
  475. return true;
  476. }
  477. if (!disabled)
  478. {
  479. _host.OnMenuOpened ();
  480. }
  481. }
  482. else
  483. {
  484. _host.SelectItem (_menuItemToSelect);
  485. }
  486. }
  487. else if (_host.IsMenuOpen)
  488. {
  489. _host.CloseAllMenus ();
  490. }
  491. else
  492. {
  493. _host.OpenMenu ();
  494. }
  495. //_openedByHotKey = true;
  496. return true;
  497. }
  498. /// <inheritdoc/>
  499. public override bool? OnInvokingKeyBindings (Key keyEvent)
  500. {
  501. // This is a bit of a hack. We want to handle the key bindings for menu bar but
  502. // InvokeKeyBindings doesn't pass any context so we can't tell which item it is for.
  503. // So before we call the base class we set SelectedItem appropriately.
  504. KeyCode key = keyEvent.KeyCode;
  505. if (KeyBindings.TryGet (key, out _))
  506. {
  507. _menuBarItemToActivate = -1;
  508. _menuItemToSelect = null;
  509. MenuItem [] children = _barItems.Children;
  510. if (children is null)
  511. {
  512. return base.OnInvokingKeyBindings (keyEvent);
  513. }
  514. // Search for shortcuts first. If there's a shortcut, we don't want to activate the menu item.
  515. foreach (MenuItem c in children)
  516. {
  517. if (key == c?.Shortcut)
  518. {
  519. _menuBarItemToActivate = -1;
  520. _menuItemToSelect = c;
  521. //keyEvent.Scope = KeyBindingScope.HotKey;
  522. return base.OnInvokingKeyBindings (keyEvent);
  523. }
  524. MenuBarItem subMenu = _barItems.SubMenu (c);
  525. if (FindShortcutInChildMenu (key, subMenu))
  526. {
  527. //keyEvent.Scope = KeyBindingScope.HotKey;
  528. return base.OnInvokingKeyBindings (keyEvent);
  529. }
  530. }
  531. // Search for hot keys next.
  532. for (var c = 0; c < children.Length; c++)
  533. {
  534. int hotKeyValue = children [c]?.HotKey.Value ?? default (int);
  535. var hotKey = (KeyCode)hotKeyValue;
  536. if (hotKey == KeyCode.Null)
  537. {
  538. continue;
  539. }
  540. bool matches = key == hotKey || key == (hotKey | KeyCode.AltMask);
  541. if (!_host.IsMenuOpen)
  542. {
  543. // If the menu is open, only match if Alt is not pressed.
  544. matches = key == hotKey;
  545. }
  546. if (matches)
  547. {
  548. _menuItemToSelect = children [c];
  549. _currentChild = c;
  550. return base.OnInvokingKeyBindings (keyEvent);
  551. }
  552. }
  553. }
  554. bool? handled = base.OnInvokingKeyBindings (keyEvent);
  555. if (handled is { } && (bool)handled)
  556. {
  557. return true;
  558. }
  559. // This supports the case where the menu bar is a context menu
  560. return _host.OnInvokingKeyBindings (keyEvent);
  561. }
  562. private bool FindShortcutInChildMenu (KeyCode key, MenuBarItem menuBarItem)
  563. {
  564. if (menuBarItem?.Children is null)
  565. {
  566. return false;
  567. }
  568. foreach (MenuItem menuItem in menuBarItem.Children)
  569. {
  570. if (key == menuItem?.Shortcut)
  571. {
  572. _menuBarItemToActivate = -1;
  573. _menuItemToSelect = menuItem;
  574. return true;
  575. }
  576. MenuBarItem subMenu = menuBarItem.SubMenu (menuItem);
  577. FindShortcutInChildMenu (key, subMenu);
  578. }
  579. return false;
  580. }
  581. private void Current_TerminalResized (object sender, SizeChangedEventArgs e)
  582. {
  583. if (_host.IsMenuOpen)
  584. {
  585. _host.CloseAllMenus ();
  586. }
  587. }
  588. /// <inheritdoc/>
  589. public override void OnVisibleChanged ()
  590. {
  591. base.OnVisibleChanged ();
  592. if (Visible)
  593. {
  594. Application.MouseEvent += Application_RootMouseEvent;
  595. }
  596. else
  597. {
  598. Application.MouseEvent -= Application_RootMouseEvent;
  599. }
  600. }
  601. private void Application_RootMouseEvent (object sender, MouseEventEventArgs a)
  602. {
  603. if (a.MouseEvent.View is MenuBar)
  604. {
  605. return;
  606. }
  607. if (!Visible)
  608. {
  609. throw new InvalidOperationException ("This shouldn't running on a invisible menu!");
  610. }
  611. Point boundsPoint = ScreenToViewport (a.MouseEvent.X, a.MouseEvent.Y);
  612. var me = new MouseEvent
  613. {
  614. X = boundsPoint.X,
  615. Y = boundsPoint.Y,
  616. Flags = a.MouseEvent.Flags,
  617. ScreenPosition = new (a.MouseEvent.X, a.MouseEvent.Y),
  618. View = this
  619. };
  620. if (OnMouseEvent (me) || a.MouseEvent.Flags == MouseFlags.Button1Pressed || a.MouseEvent.Flags == MouseFlags.Button1Released)
  621. {
  622. a.MouseEvent.Handled = true;
  623. }
  624. }
  625. internal Attribute DetermineColorSchemeFor (MenuItem item, int index)
  626. {
  627. if (item is null)
  628. {
  629. return GetNormalColor ();
  630. }
  631. if (index == _currentChild)
  632. {
  633. return ColorScheme.Focus;
  634. }
  635. return !item.IsEnabled () ? ColorScheme.Disabled : GetNormalColor ();
  636. }
  637. public override void OnDrawContent (Rectangle viewport)
  638. {
  639. if (_barItems.Children is null)
  640. {
  641. return;
  642. }
  643. Rectangle savedClip = Driver.Clip;
  644. Driver.Clip = new (0, 0, Driver.Cols, Driver.Rows);
  645. Driver.SetAttribute (GetNormalColor ());
  646. OnDrawAdornments ();
  647. OnRenderLineCanvas ();
  648. for (int i = Viewport.Y; i < _barItems.Children.Length; i++)
  649. {
  650. if (i < 0)
  651. {
  652. continue;
  653. }
  654. if (ViewportToScreen (Viewport).Y + i >= Driver.Rows)
  655. {
  656. break;
  657. }
  658. MenuItem item = _barItems.Children [i];
  659. Driver.SetAttribute (
  660. item is null ? GetNormalColor () :
  661. i == _currentChild ? ColorScheme.Focus : GetNormalColor ()
  662. );
  663. if (item is null && BorderStyle != LineStyle.None)
  664. {
  665. Move (-1, i);
  666. Driver.AddRune (Glyphs.LeftTee);
  667. }
  668. else if (Frame.X < Driver.Cols)
  669. {
  670. Move (0, i);
  671. }
  672. Driver.SetAttribute (DetermineColorSchemeFor (item, i));
  673. for (int p = Viewport.X; p < Frame.Width - 2; p++)
  674. {
  675. // This - 2 is for the border
  676. if (p < 0)
  677. {
  678. continue;
  679. }
  680. if (ViewportToScreen (Viewport).X + p >= Driver.Cols)
  681. {
  682. break;
  683. }
  684. if (item is null)
  685. {
  686. Driver.AddRune (Glyphs.HLine);
  687. }
  688. else if (i == 0 && p == 0 && _host.UseSubMenusSingleFrame && item.Parent.Parent is { })
  689. {
  690. Driver.AddRune (Glyphs.LeftArrow);
  691. }
  692. // This `- 3` is left border + right border + one row in from right
  693. else if (p == Frame.Width - 3 && _barItems.SubMenu (_barItems.Children [i]) is { })
  694. {
  695. Driver.AddRune (Glyphs.RightArrow);
  696. }
  697. else
  698. {
  699. Driver.AddRune ((Rune)' ');
  700. }
  701. }
  702. if (item is null)
  703. {
  704. if (BorderStyle != LineStyle.None && SuperView?.Frame.Right - Frame.X > Frame.Width)
  705. {
  706. Move (Frame.Width - 2, i);
  707. Driver.AddRune (Glyphs.RightTee);
  708. }
  709. continue;
  710. }
  711. string textToDraw = null;
  712. Rune nullCheckedChar = Glyphs.NullChecked;
  713. Rune checkChar = Glyphs.Selected;
  714. Rune uncheckedChar = Glyphs.UnSelected;
  715. if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked))
  716. {
  717. checkChar = Glyphs.Checked;
  718. uncheckedChar = Glyphs.UnChecked;
  719. }
  720. // Support Checked even though CheckType wasn't set
  721. if (item.CheckType == MenuItemCheckStyle.Checked && item.Checked is null)
  722. {
  723. textToDraw = $"{nullCheckedChar} {item.Title}";
  724. }
  725. else if (item.Checked == true)
  726. {
  727. textToDraw = $"{checkChar} {item.Title}";
  728. }
  729. else if (item.CheckType.HasFlag (MenuItemCheckStyle.Checked) || item.CheckType.HasFlag (MenuItemCheckStyle.Radio))
  730. {
  731. textToDraw = $"{uncheckedChar} {item.Title}";
  732. }
  733. else
  734. {
  735. textToDraw = item.Title;
  736. }
  737. Rectangle screen = ViewportToScreen (new (new (0 , i), Size.Empty));
  738. if (screen.X < Driver.Cols)
  739. {
  740. Driver.Move (screen.X + 1, screen.Y);
  741. if (!item.IsEnabled ())
  742. {
  743. DrawHotString (textToDraw, ColorScheme.Disabled, ColorScheme.Disabled);
  744. }
  745. else if (i == 0 && _host.UseSubMenusSingleFrame && item.Parent.Parent is { })
  746. {
  747. var tf = new TextFormatter
  748. {
  749. Alignment = TextAlignment.Centered, HotKeySpecifier = MenuBar.HotKeySpecifier, Text = textToDraw
  750. };
  751. // The -3 is left/right border + one space (not sure what for)
  752. tf.Draw (
  753. ViewportToScreen (new (1, i, Frame.Width - 3, 1)),
  754. i == _currentChild ? ColorScheme.Focus : GetNormalColor (),
  755. i == _currentChild ? ColorScheme.HotFocus : ColorScheme.HotNormal,
  756. SuperView?.ViewportToScreen (SuperView.Viewport) ?? Rectangle.Empty
  757. );
  758. }
  759. else
  760. {
  761. DrawHotString (
  762. textToDraw,
  763. i == _currentChild ? ColorScheme.HotFocus : ColorScheme.HotNormal,
  764. i == _currentChild ? ColorScheme.Focus : GetNormalColor ()
  765. );
  766. }
  767. // The help string
  768. int l = item.ShortcutTag.GetColumns () == 0
  769. ? item.Help.GetColumns ()
  770. : item.Help.GetColumns () + item.ShortcutTag.GetColumns () + 2;
  771. int col = Frame.Width - l - 3;
  772. screen = ViewportToScreen (new (new (col, i), Size.Empty));
  773. if (screen.X < Driver.Cols)
  774. {
  775. Driver.Move (screen.X, screen.Y);
  776. Driver.AddStr (item.Help);
  777. // The shortcut tag string
  778. if (!string.IsNullOrEmpty (item.ShortcutTag))
  779. {
  780. Driver.Move (screen.X + l - item.ShortcutTag.GetColumns (), screen.Y);
  781. Driver.AddStr (item.ShortcutTag);
  782. }
  783. }
  784. }
  785. }
  786. Driver.Clip = savedClip;
  787. PositionCursor ();
  788. }
  789. private void Current_DrawContentComplete (object sender, DrawEventArgs e)
  790. {
  791. if (Visible)
  792. {
  793. OnDrawContent (Viewport);
  794. }
  795. }
  796. public override void PositionCursor ()
  797. {
  798. if (_host?.IsMenuOpen != false)
  799. {
  800. if (_barItems.IsTopLevel)
  801. {
  802. _host?.PositionCursor ();
  803. }
  804. else
  805. {
  806. Move (2, 1 + _currentChild);
  807. }
  808. }
  809. else
  810. {
  811. _host?.PositionCursor ();
  812. }
  813. }
  814. public void Run (Action action)
  815. {
  816. if (action is null || _host is null)
  817. {
  818. return;
  819. }
  820. Application.UngrabMouse ();
  821. _host.CloseAllMenus ();
  822. Application.Refresh ();
  823. _host.Run (action);
  824. }
  825. public override bool OnLeave (View view) { return _host.OnLeave (view); }
  826. private void RunSelected ()
  827. {
  828. if (_barItems.IsTopLevel)
  829. {
  830. Run (_barItems.Action);
  831. }
  832. else
  833. {
  834. switch (_currentChild)
  835. {
  836. case > -1 when _barItems.Children [_currentChild].Action != null:
  837. Run (_barItems.Children [_currentChild].Action);
  838. break;
  839. case 0 when _host.UseSubMenusSingleFrame && _barItems.Children [_currentChild].Parent.Parent != null:
  840. _host.PreviousMenu (_barItems.Children [_currentChild].Parent.IsFromSubMenu, true);
  841. break;
  842. case > -1 when _barItems.SubMenu (_barItems.Children [_currentChild]) != null:
  843. CheckSubMenu ();
  844. break;
  845. }
  846. }
  847. }
  848. private void CloseAllMenus ()
  849. {
  850. Application.UngrabMouse ();
  851. _host.CloseAllMenus ();
  852. }
  853. private bool MoveDown ()
  854. {
  855. if (_barItems.IsTopLevel)
  856. {
  857. return true;
  858. }
  859. bool disabled;
  860. do
  861. {
  862. _currentChild++;
  863. if (_currentChild >= _barItems.Children.Length)
  864. {
  865. _currentChild = 0;
  866. }
  867. if (this != _host.openCurrentMenu && _barItems.Children [_currentChild]?.IsFromSubMenu == true && _host._selectedSub > -1)
  868. {
  869. _host.PreviousMenu (true);
  870. _host.SelectEnabledItem (_barItems.Children, _currentChild, out _currentChild);
  871. _host.openCurrentMenu = this;
  872. }
  873. MenuItem item = _barItems.Children [_currentChild];
  874. if (item?.IsEnabled () != true)
  875. {
  876. disabled = true;
  877. }
  878. else
  879. {
  880. disabled = false;
  881. }
  882. if (!_host.UseSubMenusSingleFrame
  883. && _host.UseKeysUpDownAsKeysLeftRight
  884. && _barItems.SubMenu (_barItems.Children [_currentChild]) != null
  885. && !disabled
  886. && _host.IsMenuOpen)
  887. {
  888. if (!CheckSubMenu ())
  889. {
  890. return false;
  891. }
  892. break;
  893. }
  894. if (!_host.IsMenuOpen)
  895. {
  896. _host.OpenMenu (_host._selected);
  897. }
  898. }
  899. while (_barItems.Children [_currentChild] is null || disabled);
  900. SetNeedsDisplay ();
  901. SetParentSetNeedsDisplay ();
  902. if (!_host.UseSubMenusSingleFrame)
  903. {
  904. _host.OnMenuOpened ();
  905. }
  906. return true;
  907. }
  908. private bool MoveUp ()
  909. {
  910. if (_barItems.IsTopLevel || _currentChild == -1)
  911. {
  912. return true;
  913. }
  914. bool disabled;
  915. do
  916. {
  917. _currentChild--;
  918. if (_host.UseKeysUpDownAsKeysLeftRight && !_host.UseSubMenusSingleFrame)
  919. {
  920. if ((_currentChild == -1 || this != _host.openCurrentMenu)
  921. && _barItems.Children [_currentChild + 1].IsFromSubMenu
  922. && _host._selectedSub > -1)
  923. {
  924. _currentChild++;
  925. _host.PreviousMenu (true);
  926. if (_currentChild > 0)
  927. {
  928. _currentChild--;
  929. _host.openCurrentMenu = this;
  930. }
  931. break;
  932. }
  933. }
  934. if (_currentChild < 0)
  935. {
  936. _currentChild = _barItems.Children.Length - 1;
  937. }
  938. if (!_host.SelectEnabledItem (_barItems.Children, _currentChild, out _currentChild, false))
  939. {
  940. _currentChild = 0;
  941. if (!_host.SelectEnabledItem (_barItems.Children, _currentChild, out _currentChild) && !_host.CloseMenu (false))
  942. {
  943. return false;
  944. }
  945. break;
  946. }
  947. MenuItem item = _barItems.Children [_currentChild];
  948. disabled = item?.IsEnabled () != true;
  949. if (_host.UseSubMenusSingleFrame
  950. || !_host.UseKeysUpDownAsKeysLeftRight
  951. || _barItems.SubMenu (_barItems.Children [_currentChild]) == null
  952. || disabled
  953. || !_host.IsMenuOpen)
  954. {
  955. continue;
  956. }
  957. if (!CheckSubMenu ())
  958. {
  959. return false;
  960. }
  961. break;
  962. }
  963. while (_barItems.Children [_currentChild] is null || disabled);
  964. SetNeedsDisplay ();
  965. SetParentSetNeedsDisplay ();
  966. if (!_host.UseSubMenusSingleFrame)
  967. {
  968. _host.OnMenuOpened ();
  969. }
  970. return true;
  971. }
  972. private void SetParentSetNeedsDisplay ()
  973. {
  974. if (_host._openSubMenu is { })
  975. {
  976. foreach (Menu menu in _host._openSubMenu)
  977. {
  978. menu.SetNeedsDisplay ();
  979. }
  980. }
  981. _host?._openMenu?.SetNeedsDisplay ();
  982. _host?.SetNeedsDisplay ();
  983. }
  984. protected internal override bool OnMouseEvent (MouseEvent me)
  985. {
  986. if (!_host._handled && !_host.HandleGrabView (me, this))
  987. {
  988. return false;
  989. }
  990. _host._handled = false;
  991. bool disabled;
  992. if (me.Flags == MouseFlags.Button1Clicked)
  993. {
  994. disabled = false;
  995. if (me.Y < 0)
  996. {
  997. return true;
  998. }
  999. if (me.Y >= _barItems.Children.Length)
  1000. {
  1001. return true;
  1002. }
  1003. MenuItem item = _barItems.Children [me.Y];
  1004. if (item is null || !item.IsEnabled ())
  1005. {
  1006. disabled = true;
  1007. }
  1008. if (disabled)
  1009. {
  1010. return true;
  1011. }
  1012. _currentChild = me.Y;
  1013. RunSelected ();
  1014. return true;
  1015. }
  1016. if (me.Flags != MouseFlags.Button1Pressed
  1017. && me.Flags != MouseFlags.Button1DoubleClicked
  1018. && me.Flags != MouseFlags.Button1TripleClicked
  1019. && me.Flags != MouseFlags.ReportMousePosition
  1020. && !me.Flags.HasFlag (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition))
  1021. {
  1022. return false;
  1023. }
  1024. {
  1025. disabled = false;
  1026. if (me.Y < 0 || me.Y >= _barItems.Children.Length)
  1027. {
  1028. return true;
  1029. }
  1030. MenuItem item = _barItems.Children [me.Y];
  1031. if (item is null)
  1032. {
  1033. return true;
  1034. }
  1035. if (item?.IsEnabled () != true)
  1036. {
  1037. disabled = true;
  1038. }
  1039. if (!disabled)
  1040. {
  1041. _currentChild = me.Y;
  1042. }
  1043. if (_host.UseSubMenusSingleFrame || !CheckSubMenu ())
  1044. {
  1045. SetNeedsDisplay ();
  1046. SetParentSetNeedsDisplay ();
  1047. return true;
  1048. }
  1049. _host.OnMenuOpened ();
  1050. return true;
  1051. }
  1052. }
  1053. internal bool CheckSubMenu ()
  1054. {
  1055. if (_currentChild == -1 || _barItems.Children [_currentChild] is null)
  1056. {
  1057. return true;
  1058. }
  1059. MenuBarItem subMenu = _barItems.SubMenu (_barItems.Children [_currentChild]);
  1060. if (subMenu is { })
  1061. {
  1062. int pos = -1;
  1063. if (_host._openSubMenu is { })
  1064. {
  1065. pos = _host._openSubMenu.FindIndex (o => o?._barItems == subMenu);
  1066. }
  1067. if (pos == -1
  1068. && this != _host.openCurrentMenu
  1069. && subMenu.Children != _host.openCurrentMenu._barItems.Children
  1070. && !_host.CloseMenu (false, true))
  1071. {
  1072. return false;
  1073. }
  1074. _host.Activate (_host._selected, pos, subMenu);
  1075. }
  1076. else if (_host._openSubMenu?.Count == 0 || _host._openSubMenu?.Last ()._barItems.IsSubMenuOf (_barItems.Children [_currentChild]) == false)
  1077. {
  1078. return _host.CloseMenu (false, true);
  1079. }
  1080. else
  1081. {
  1082. SetNeedsDisplay ();
  1083. SetParentSetNeedsDisplay ();
  1084. }
  1085. return true;
  1086. }
  1087. private int GetSubMenuIndex (MenuBarItem subMenu)
  1088. {
  1089. int pos = -1;
  1090. if (Subviews.Count == 0)
  1091. {
  1092. return pos;
  1093. }
  1094. Menu v = null;
  1095. foreach (View menu in Subviews)
  1096. {
  1097. if (((Menu)menu)._barItems == subMenu)
  1098. {
  1099. v = (Menu)menu;
  1100. }
  1101. }
  1102. if (v is { })
  1103. {
  1104. pos = Subviews.IndexOf (v);
  1105. }
  1106. return pos;
  1107. }
  1108. /// <inheritdoc/>
  1109. public override bool OnEnter (View view)
  1110. {
  1111. Application.Driver.SetCursorVisibility (CursorVisibility.Invisible);
  1112. return base.OnEnter (view);
  1113. }
  1114. protected override void Dispose (bool disposing)
  1115. {
  1116. if (Application.Current is { })
  1117. {
  1118. Application.Current.DrawContentComplete -= Current_DrawContentComplete;
  1119. Application.Current.SizeChanging -= Current_TerminalResized;
  1120. }
  1121. Application.MouseEvent -= Application_RootMouseEvent;
  1122. base.Dispose (disposing);
  1123. }
  1124. }