Toplevel.cs 33 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075
  1. using System;
  2. using System.Collections.Generic;
  3. using System.ComponentModel;
  4. using System.Linq;
  5. namespace Terminal.Gui {
  6. /// <summary>
  7. /// Toplevel views can be modally executed. They are used for both an application's main view (filling the entire screeN and
  8. /// for pop-up views such as <see cref="Dialog"/>, <see cref="MessageBox"/>, and <see cref="Wizard"/>.
  9. /// </summary>
  10. /// <remarks>
  11. /// <para>
  12. /// Toplevels can be modally executing views, started by calling <see cref="Application.Run(Toplevel, Func{Exception, bool})"/>.
  13. /// They return control to the caller when <see cref="Application.RequestStop(Toplevel)"/> has
  14. /// been called (which sets the <see cref="Toplevel.Running"/> property to <c>false</c>).
  15. /// </para>
  16. /// <para>
  17. /// A Toplevel is created when an application initializes Terminal.Gui by calling <see cref="Application.Init(ConsoleDriver, IMainLoopDriver)"/>.
  18. /// The application Toplevel can be accessed via <see cref="Application.Top"/>. Additional Toplevels can be created
  19. /// and run (e.g. <see cref="Dialog"/>s. To run a Toplevel, create the <see cref="Toplevel"/> and
  20. /// call <see cref="Application.Run(Toplevel, Func{Exception, bool})"/>.
  21. /// </para>
  22. /// <para>
  23. /// Toplevels can also opt-in to more sophisticated initialization
  24. /// by implementing <see cref="ISupportInitialize"/>. When they do
  25. /// so, the <see cref="ISupportInitialize.BeginInit"/> and
  26. /// <see cref="ISupportInitialize.EndInit"/> methods will be called
  27. /// before running the view.
  28. /// If first-run-only initialization is preferred, the <see cref="ISupportInitializeNotification"/>
  29. /// can be implemented too, in which case the <see cref="ISupportInitialize"/>
  30. /// methods will only be called if <see cref="ISupportInitializeNotification.IsInitialized"/>
  31. /// is <see langword="false"/>. This allows proper <see cref="View"/> inheritance hierarchies
  32. /// to override base class layout code optimally by doing so only on first run,
  33. /// instead of on every run.
  34. /// </para>
  35. /// </remarks>
  36. public class Toplevel : View {
  37. /// <summary>
  38. /// Gets or sets whether the <see cref="MainLoop"/> for this <see cref="Toplevel"/> is running or not.
  39. /// </summary>
  40. /// <remarks>
  41. /// Setting this property directly is discouraged. Use <see cref="Application.RequestStop"/> instead.
  42. /// </remarks>
  43. public bool Running { get; set; }
  44. /// <summary>
  45. /// Invoked when the Toplevel <see cref="Application.RunState"/> has begun to be loaded.
  46. /// A Loaded event handler is a good place to finalize initialization before calling
  47. /// <see cref="Application.RunLoop(Application.RunState, bool)"/>.
  48. /// </summary>
  49. public event Action Loaded;
  50. /// <summary>
  51. /// Invoked when the Toplevel <see cref="MainLoop"/> has started it's first iteration.
  52. /// Subscribe to this event to perform tasks when the <see cref="Toplevel"/> has been laid out and focus has been set.
  53. /// changes.
  54. /// <para>A Ready event handler is a good place to finalize initialization after calling
  55. /// <see cref="Application.Run(Func{Exception, bool})"/> on this Toplevel.</para>
  56. /// </summary>
  57. public event Action Ready;
  58. /// <summary>
  59. /// Invoked when the Toplevel <see cref="Application.RunState"/> has been unloaded.
  60. /// A Unloaded event handler is a good place to dispose objects after calling <see cref="Application.End(Application.RunState)"/>.
  61. /// </summary>
  62. public event Action Unloaded;
  63. /// <summary>
  64. /// Invoked when the Toplevel <see cref="Application.RunState"/> becomes the <see cref="Application.Current"/> Toplevel.
  65. /// </summary>
  66. public event Action<Toplevel> Activate;
  67. /// <summary>
  68. /// Invoked when the Toplevel<see cref="Application.RunState"/> ceases to be the <see cref="Application.Current"/> Toplevel.
  69. /// </summary>
  70. public event Action<Toplevel> Deactivate;
  71. /// <summary>
  72. /// Invoked when a child of the Toplevel <see cref="Application.RunState"/> is closed by
  73. /// <see cref="Application.End(Application.RunState)"/>.
  74. /// </summary>
  75. public event Action<Toplevel> ChildClosed;
  76. /// <summary>
  77. /// Invoked when the last child of the Toplevel <see cref="Application.RunState"/> is closed from
  78. /// by <see cref="Application.End(Application.RunState)"/>.
  79. /// </summary>
  80. public event Action AllChildClosed;
  81. /// <summary>
  82. /// Invoked when the Toplevel's <see cref="Application.RunState"/> is being closed by
  83. /// <see cref="Application.RequestStop(Toplevel)"/>.
  84. /// </summary>
  85. public event Action<ToplevelClosingEventArgs> Closing;
  86. /// <summary>
  87. /// Invoked when the Toplevel's <see cref="Application.RunState"/> is closed by <see cref="Application.End(Application.RunState)"/>.
  88. /// </summary>
  89. public event Action<Toplevel> Closed;
  90. /// <summary>
  91. /// Invoked when a child Toplevel's <see cref="Application.RunState"/> has been loaded.
  92. /// </summary>
  93. public event Action<Toplevel> ChildLoaded;
  94. /// <summary>
  95. /// Invoked when a cjhild Toplevel's <see cref="Application.RunState"/> has been unloaded.
  96. /// </summary>
  97. public event Action<Toplevel> ChildUnloaded;
  98. /// <summary>
  99. /// Invoked when the terminal has been resized. The new <see cref="Size"/> of the terminal is provided.
  100. /// </summary>
  101. public event Action<Size> Resized;
  102. internal virtual void OnResized (Size size)
  103. {
  104. Resized?.Invoke (size);
  105. }
  106. internal virtual void OnChildUnloaded (Toplevel top)
  107. {
  108. ChildUnloaded?.Invoke (top);
  109. }
  110. internal virtual void OnChildLoaded (Toplevel top)
  111. {
  112. ChildLoaded?.Invoke (top);
  113. }
  114. internal virtual void OnClosed (Toplevel top)
  115. {
  116. Closed?.Invoke (top);
  117. }
  118. internal virtual bool OnClosing (ToplevelClosingEventArgs ev)
  119. {
  120. Closing?.Invoke (ev);
  121. return ev.Cancel;
  122. }
  123. internal virtual void OnAllChildClosed ()
  124. {
  125. AllChildClosed?.Invoke ();
  126. }
  127. internal virtual void OnChildClosed (Toplevel top)
  128. {
  129. if (IsMdiContainer) {
  130. SetChildNeedsDisplay ();
  131. }
  132. ChildClosed?.Invoke (top);
  133. }
  134. internal virtual void OnDeactivate (Toplevel activated)
  135. {
  136. Deactivate?.Invoke (activated);
  137. }
  138. internal virtual void OnActivate (Toplevel deactivated)
  139. {
  140. Activate?.Invoke (deactivated);
  141. }
  142. /// <summary>
  143. /// Called from <see cref="Application.Begin(Toplevel)"/> before the <see cref="Toplevel"/> redraws for the first time.
  144. /// </summary>
  145. virtual public void OnLoaded ()
  146. {
  147. IsLoaded = true;
  148. foreach (Toplevel tl in Subviews.Where (v => v is Toplevel)) {
  149. tl.OnLoaded ();
  150. }
  151. Loaded?.Invoke ();
  152. }
  153. /// <summary>
  154. /// Called from <see cref="Application.RunLoop"/> after the <see cref="Toplevel"/> has entered the
  155. /// first iteration of the loop.
  156. /// </summary>
  157. internal virtual void OnReady ()
  158. {
  159. foreach (Toplevel tl in Subviews.Where (v => v is Toplevel)) {
  160. tl.OnReady ();
  161. }
  162. Ready?.Invoke ();
  163. }
  164. /// <summary>
  165. /// Called from <see cref="Application.End(Application.RunState)"/> before the <see cref="Toplevel"/> is disposed.
  166. /// </summary>
  167. internal virtual void OnUnloaded ()
  168. {
  169. foreach (Toplevel tl in Subviews.Where (v => v is Toplevel)) {
  170. tl.OnUnloaded ();
  171. }
  172. Unloaded?.Invoke ();
  173. }
  174. /// <summary>
  175. /// Initializes a new instance of the <see cref="Toplevel"/> class with the specified <see cref="LayoutStyle.Absolute"/> layout.
  176. /// </summary>
  177. /// <param name="frame">A superview-relative rectangle specifying the location and size for the new Toplevel</param>
  178. public Toplevel (Rect frame) : base (frame)
  179. {
  180. Initialize ();
  181. }
  182. /// <summary>
  183. /// Initializes a new instance of the <see cref="Toplevel"/> class with <see cref="LayoutStyle.Computed"/> layout,
  184. /// defaulting to full screen.
  185. /// </summary>
  186. public Toplevel () : base ()
  187. {
  188. Initialize ();
  189. Width = Dim.Fill ();
  190. Height = Dim.Fill ();
  191. }
  192. void Initialize ()
  193. {
  194. ColorScheme = Colors.TopLevel;
  195. // Things this view knows how to do
  196. AddCommand (Command.QuitToplevel, () => { QuitToplevel (); return true; });
  197. AddCommand (Command.Suspend, () => { Driver.Suspend (); ; return true; });
  198. AddCommand (Command.NextView, () => { MoveNextView (); return true; });
  199. AddCommand (Command.PreviousView, () => { MovePreviousView (); return true; });
  200. AddCommand (Command.NextViewOrTop, () => { MoveNextViewOrTop (); return true; });
  201. AddCommand (Command.PreviousViewOrTop, () => { MovePreviousViewOrTop (); return true; });
  202. AddCommand (Command.Refresh, () => { Application.Refresh (); return true; });
  203. // Default keybindings for this view
  204. AddKeyBinding (Application.QuitKey, Command.QuitToplevel);
  205. AddKeyBinding (Key.Z | Key.CtrlMask, Command.Suspend);
  206. AddKeyBinding (Key.Tab, Command.NextView);
  207. AddKeyBinding (Key.CursorRight, Command.NextView);
  208. AddKeyBinding (Key.F | Key.CtrlMask, Command.NextView);
  209. AddKeyBinding (Key.CursorDown, Command.NextView);
  210. AddKeyBinding (Key.I | Key.CtrlMask, Command.NextView); // Unix
  211. AddKeyBinding (Key.BackTab | Key.ShiftMask, Command.PreviousView);
  212. AddKeyBinding (Key.CursorLeft, Command.PreviousView);
  213. AddKeyBinding (Key.CursorUp, Command.PreviousView);
  214. AddKeyBinding (Key.B | Key.CtrlMask, Command.PreviousView);
  215. AddKeyBinding (Key.Tab | Key.CtrlMask, Command.NextViewOrTop);
  216. AddKeyBinding (Application.AlternateForwardKey, Command.NextViewOrTop); // Needed on Unix
  217. AddKeyBinding (Key.Tab | Key.ShiftMask | Key.CtrlMask, Command.PreviousViewOrTop);
  218. AddKeyBinding (Application.AlternateBackwardKey, Command.PreviousViewOrTop); // Needed on Unix
  219. AddKeyBinding (Key.L | Key.CtrlMask, Command.Refresh);
  220. }
  221. /// <summary>
  222. /// Invoked when the <see cref="Application.AlternateForwardKey"/> is changed.
  223. /// </summary>
  224. public event Action<Key> AlternateForwardKeyChanged;
  225. /// <summary>
  226. /// Virtual method to invoke the <see cref="AlternateForwardKeyChanged"/> event.
  227. /// </summary>
  228. /// <param name="oldKey"></param>
  229. public virtual void OnAlternateForwardKeyChanged (Key oldKey)
  230. {
  231. ReplaceKeyBinding (oldKey, Application.AlternateForwardKey);
  232. AlternateForwardKeyChanged?.Invoke (oldKey);
  233. }
  234. /// <summary>
  235. /// Invoked when the <see cref="Application.AlternateBackwardKey"/> is changed.
  236. /// </summary>
  237. public event Action<Key> AlternateBackwardKeyChanged;
  238. /// <summary>
  239. /// Virtual method to invoke the <see cref="AlternateBackwardKeyChanged"/> event.
  240. /// </summary>
  241. /// <param name="oldKey"></param>
  242. public virtual void OnAlternateBackwardKeyChanged (Key oldKey)
  243. {
  244. ReplaceKeyBinding (oldKey, Application.AlternateBackwardKey);
  245. AlternateBackwardKeyChanged?.Invoke (oldKey);
  246. }
  247. /// <summary>
  248. /// Invoked when the <see cref="Application.QuitKey"/> is changed.
  249. /// </summary>
  250. public event Action<Key> QuitKeyChanged;
  251. /// <summary>
  252. /// Virtual method to invoke the <see cref="QuitKeyChanged"/> event.
  253. /// </summary>
  254. /// <param name="oldKey"></param>
  255. public virtual void OnQuitKeyChanged (Key oldKey)
  256. {
  257. ReplaceKeyBinding (oldKey, Application.QuitKey);
  258. QuitKeyChanged?.Invoke (oldKey);
  259. }
  260. /// <summary>
  261. /// Convenience factory method that creates a new Toplevel with the current terminal dimensions.
  262. /// </summary>
  263. /// <returns>The created Toplevel.</returns>
  264. public static Toplevel Create ()
  265. {
  266. return new Toplevel (new Rect (0, 0, Driver.Cols, Driver.Rows));
  267. }
  268. /// <summary>
  269. /// Gets or sets a value indicating whether this <see cref="Toplevel"/> can focus.
  270. /// </summary>
  271. /// <value><c>true</c> if can focus; otherwise, <c>false</c>.</value>
  272. public override bool CanFocus {
  273. get => SuperView == null ? true : base.CanFocus;
  274. }
  275. /// <summary>
  276. /// Determines whether the <see cref="Toplevel"/> is modal or not.
  277. /// If set to <c>false</c> (the default):
  278. ///
  279. /// <list type="bullet">
  280. /// <item>
  281. /// <description><see cref="ProcessKey(KeyEvent)"/> events will propagate keys upwards.</description>
  282. /// </item>
  283. /// <item>
  284. /// <description>The Toplevel will act as an embedded view (not a modal/pop-up).</description>
  285. /// </item>
  286. /// </list>
  287. ///
  288. /// If set to <c>true</c>:
  289. ///
  290. /// <list type="bullet">
  291. /// <item>
  292. /// <description><see cref="ProcessKey(KeyEvent)"/> events will NOT propogate keys upwards.</description>
  293. /// </item>
  294. /// <item>
  295. /// <description>The Toplevel will and look like a modal (pop-up) (e.g. see <see cref="Dialog"/>.</description>
  296. /// </item>
  297. /// </list>
  298. /// </summary>
  299. public bool Modal { get; set; }
  300. /// <summary>
  301. /// Gets or sets the menu for this Toplevel.
  302. /// </summary>
  303. public virtual MenuBar MenuBar { get; set; }
  304. /// <summary>
  305. /// Gets or sets the status bar for this Toplevel.
  306. /// </summary>
  307. public virtual StatusBar StatusBar { get; set; }
  308. /// <summary>
  309. /// Gets or sets if this Toplevel is a Mdi container.
  310. /// </summary>
  311. public bool IsMdiContainer { get; set; }
  312. /// <summary>
  313. /// Gets or sets if this Toplevel is a Mdi child.
  314. /// </summary>
  315. public bool IsMdiChild {
  316. get {
  317. return Application.MdiTop != null && Application.MdiTop != this && !Modal;
  318. }
  319. }
  320. /// <summary>
  321. /// <see langword="true"/> if was already loaded by the <see cref="Application.Begin(Toplevel)"/>
  322. /// <see langword="false"/>, otherwise. This is used to avoid the <see cref="View.NeedDisplay"/>
  323. /// having wrong values while this was not yet loaded.
  324. /// </summary>
  325. public bool IsLoaded { get; private set; }
  326. ///<inheritdoc/>
  327. public override bool OnKeyDown (KeyEvent keyEvent)
  328. {
  329. if (base.OnKeyDown (keyEvent)) {
  330. return true;
  331. }
  332. switch (keyEvent.Key) {
  333. case Key.AltMask:
  334. case Key.AltMask | Key.Space:
  335. case Key.CtrlMask | Key.Space:
  336. case Key _ when (keyEvent.Key & Key.AltMask) == Key.AltMask:
  337. return MenuBar != null && MenuBar.OnKeyDown (keyEvent);
  338. }
  339. return false;
  340. }
  341. ///<inheritdoc/>
  342. public override bool OnKeyUp (KeyEvent keyEvent)
  343. {
  344. if (base.OnKeyUp (keyEvent)) {
  345. return true;
  346. }
  347. switch (keyEvent.Key) {
  348. case Key.AltMask:
  349. case Key.AltMask | Key.Space:
  350. case Key.CtrlMask | Key.Space:
  351. if (MenuBar != null && MenuBar.OnKeyUp (keyEvent)) {
  352. return true;
  353. }
  354. break;
  355. }
  356. return false;
  357. }
  358. ///<inheritdoc/>
  359. public override bool ProcessKey (KeyEvent keyEvent)
  360. {
  361. if (base.ProcessKey (keyEvent))
  362. return true;
  363. var result = InvokeKeybindings (new KeyEvent (ShortcutHelper.GetModifiersKey (keyEvent),
  364. new KeyModifiers () { Alt = keyEvent.IsAlt, Ctrl = keyEvent.IsCtrl, Shift = keyEvent.IsShift }));
  365. if (result != null)
  366. return (bool)result;
  367. #if false
  368. if (keyEvent.Key == Key.F5) {
  369. Application.DebugDrawBounds = !Application.DebugDrawBounds;
  370. SetNeedsDisplay ();
  371. return true;
  372. }
  373. #endif
  374. return false;
  375. }
  376. private void MovePreviousViewOrTop ()
  377. {
  378. if (Application.MdiTop == null) {
  379. var top = Modal ? this : Application.Top;
  380. top.FocusPrev ();
  381. if (top.Focused == null) {
  382. top.FocusPrev ();
  383. }
  384. top.SetNeedsDisplay ();
  385. Application.EnsuresTopOnFront ();
  386. } else {
  387. MovePrevious ();
  388. }
  389. }
  390. private void MoveNextViewOrTop ()
  391. {
  392. if (Application.MdiTop == null) {
  393. var top = Modal ? this : Application.Top;
  394. top.FocusNext ();
  395. if (top.Focused == null) {
  396. top.FocusNext ();
  397. }
  398. top.SetNeedsDisplay ();
  399. Application.EnsuresTopOnFront ();
  400. } else {
  401. MoveNext ();
  402. }
  403. }
  404. private void MovePreviousView ()
  405. {
  406. var old = GetDeepestFocusedSubview (Focused);
  407. if (!FocusPrev ())
  408. FocusPrev ();
  409. if (old != Focused && old != Focused?.Focused) {
  410. old?.SetNeedsDisplay ();
  411. Focused?.SetNeedsDisplay ();
  412. } else {
  413. FocusNearestView (SuperView?.TabIndexes?.Reverse (), Direction.Backward);
  414. }
  415. }
  416. private void MoveNextView ()
  417. {
  418. var old = GetDeepestFocusedSubview (Focused);
  419. if (!FocusNext ())
  420. FocusNext ();
  421. if (old != Focused && old != Focused?.Focused) {
  422. old?.SetNeedsDisplay ();
  423. Focused?.SetNeedsDisplay ();
  424. } else {
  425. FocusNearestView (SuperView?.TabIndexes, Direction.Forward);
  426. }
  427. }
  428. private void QuitToplevel ()
  429. {
  430. if (Application.MdiTop != null) {
  431. Application.MdiTop.RequestStop ();
  432. } else {
  433. Application.RequestStop ();
  434. }
  435. }
  436. ///<inheritdoc/>
  437. public override bool ProcessColdKey (KeyEvent keyEvent)
  438. {
  439. if (base.ProcessColdKey (keyEvent)) {
  440. return true;
  441. }
  442. if (ShortcutHelper.FindAndOpenByShortcut (keyEvent, this)) {
  443. return true;
  444. }
  445. return false;
  446. }
  447. View GetDeepestFocusedSubview (View view)
  448. {
  449. if (view == null) {
  450. return null;
  451. }
  452. foreach (var v in view.Subviews) {
  453. if (v.HasFocus) {
  454. return GetDeepestFocusedSubview (v);
  455. }
  456. }
  457. return view;
  458. }
  459. void FocusNearestView (IEnumerable<View> views, Direction direction)
  460. {
  461. if (views == null) {
  462. return;
  463. }
  464. bool found = false;
  465. bool focusProcessed = false;
  466. int idx = 0;
  467. foreach (var v in views) {
  468. if (v == this) {
  469. found = true;
  470. }
  471. if (found && v != this) {
  472. if (direction == Direction.Forward) {
  473. SuperView?.FocusNext ();
  474. } else {
  475. SuperView?.FocusPrev ();
  476. }
  477. focusProcessed = true;
  478. if (SuperView.Focused != null && SuperView.Focused != this) {
  479. return;
  480. }
  481. } else if (found && !focusProcessed && idx == views.Count () - 1) {
  482. views.ToList () [0].SetFocus ();
  483. }
  484. idx++;
  485. }
  486. }
  487. ///<inheritdoc/>
  488. public override void Add (View view)
  489. {
  490. AddMenuStatusBar (view);
  491. base.Add (view);
  492. }
  493. internal void AddMenuStatusBar (View view)
  494. {
  495. if (view is MenuBar) {
  496. MenuBar = view as MenuBar;
  497. }
  498. if (view is StatusBar) {
  499. StatusBar = view as StatusBar;
  500. }
  501. }
  502. ///<inheritdoc/>
  503. public override void Remove (View view)
  504. {
  505. if (this is Toplevel toplevel && toplevel.MenuBar != null) {
  506. RemoveMenuStatusBar (view);
  507. }
  508. base.Remove (view);
  509. }
  510. ///<inheritdoc/>
  511. public override void RemoveAll ()
  512. {
  513. if (this == Application.Top) {
  514. MenuBar?.Dispose ();
  515. MenuBar = null;
  516. StatusBar?.Dispose ();
  517. StatusBar = null;
  518. }
  519. base.RemoveAll ();
  520. }
  521. internal void RemoveMenuStatusBar (View view)
  522. {
  523. if (view is MenuBar) {
  524. MenuBar?.Dispose ();
  525. MenuBar = null;
  526. }
  527. if (view is StatusBar) {
  528. StatusBar?.Dispose ();
  529. StatusBar = null;
  530. }
  531. }
  532. internal View EnsureVisibleBounds (Toplevel top, int x, int y,
  533. out int nx, out int ny, out View mb, out View sb)
  534. {
  535. int l;
  536. View superView;
  537. if (top?.SuperView == null || top == Application.Top || top?.SuperView == Application.Top) {
  538. l = Driver.Cols;
  539. superView = Application.Top;
  540. } else {
  541. l = top.SuperView.Frame.Width;
  542. superView = top.SuperView;
  543. }
  544. nx = Math.Max (x, 0);
  545. nx = nx + top.Frame.Width > l ? Math.Max (l - top.Frame.Width, 0) : nx;
  546. var mfLength = top.Border?.DrawMarginFrame == true ? 2 : 1;
  547. if (nx + mfLength > top.Frame.X + top.Frame.Width) {
  548. nx = Math.Max (top.Frame.Right - mfLength, 0);
  549. }
  550. //System.Diagnostics.Debug.WriteLine ($"nx:{nx}, rWidth:{rWidth}");
  551. bool m, s;
  552. if (top?.SuperView == null || top == Application.Top || top?.SuperView == Application.Top) {
  553. m = Application.Top.MenuBar?.Visible == true;
  554. mb = Application.Top.MenuBar;
  555. } else {
  556. var t = top.SuperView;
  557. while (!(t is Toplevel)) {
  558. t = t.SuperView;
  559. }
  560. m = ((Toplevel)t).MenuBar?.Visible == true;
  561. mb = ((Toplevel)t).MenuBar;
  562. }
  563. if (top?.SuperView == null || top == Application.Top || top?.SuperView == Application.Top) {
  564. l = m ? 1 : 0;
  565. } else {
  566. l = 0;
  567. }
  568. ny = Math.Max (y, l);
  569. if (top?.SuperView == null || top == Application.Top || top?.SuperView == Application.Top) {
  570. s = Application.Top.StatusBar?.Visible == true;
  571. sb = Application.Top.StatusBar;
  572. } else {
  573. var t = top.SuperView;
  574. while (!(t is Toplevel)) {
  575. t = t.SuperView;
  576. }
  577. s = ((Toplevel)t).StatusBar?.Visible == true;
  578. sb = ((Toplevel)t).StatusBar;
  579. }
  580. if (top?.SuperView == null || top == Application.Top || top?.SuperView == Application.Top) {
  581. l = s ? Driver.Rows - 1 : Driver.Rows;
  582. } else {
  583. l = s ? top.SuperView.Frame.Height - 1 : top.SuperView.Frame.Height;
  584. }
  585. ny = Math.Min (ny, l);
  586. ny = ny + top.Frame.Height >= l ? Math.Max (l - top.Frame.Height, m ? 1 : 0) : ny;
  587. if (ny + mfLength > top.Frame.Y + top.Frame.Height) {
  588. ny = Math.Max (top.Frame.Bottom - mfLength, 0);
  589. }
  590. //System.Diagnostics.Debug.WriteLine ($"ny:{ny}, rHeight:{rHeight}");
  591. return superView;
  592. }
  593. internal void PositionToplevels ()
  594. {
  595. PositionToplevel (this);
  596. foreach (var top in Subviews) {
  597. if (top is Toplevel) {
  598. PositionToplevel ((Toplevel)top);
  599. }
  600. }
  601. }
  602. /// <summary>
  603. /// Virtual method enabling implementation of specific positions for inherited <see cref="Toplevel"/> views.
  604. /// </summary>
  605. /// <param name="top">The toplevel.</param>
  606. public virtual void PositionToplevel (Toplevel top)
  607. {
  608. var superView = EnsureVisibleBounds (top, top.Frame.X, top.Frame.Y,
  609. out int nx, out int ny, out _, out View sb);
  610. bool layoutSubviews = false;
  611. if ((top?.SuperView != null || (top != Application.Top && top.Modal)
  612. || (top?.SuperView == null && top.IsMdiChild))
  613. && (nx > top.Frame.X || ny > top.Frame.Y) && top.LayoutStyle == LayoutStyle.Computed) {
  614. if ((top.X == null || top.X is Pos.PosAbsolute) && top.Bounds.X != nx) {
  615. top.X = nx;
  616. layoutSubviews = true;
  617. }
  618. if ((top.Y == null || top.Y is Pos.PosAbsolute) && top.Bounds.Y != ny) {
  619. top.Y = ny;
  620. layoutSubviews = true;
  621. }
  622. }
  623. if (sb != null && ny + top.Frame.Height != superView.Frame.Height - (sb.Visible ? 1 : 0)
  624. && top.Height is Dim.DimFill && -top.Height.Anchor (0) < 1) {
  625. top.Height = Dim.Fill (sb.Visible ? 1 : 0);
  626. layoutSubviews = true;
  627. }
  628. if (layoutSubviews) {
  629. superView.LayoutSubviews ();
  630. }
  631. }
  632. ///<inheritdoc/>
  633. public override void Redraw (Rect bounds)
  634. {
  635. if (!Visible) {
  636. return;
  637. }
  638. if (!NeedDisplay.IsEmpty || ChildNeedsDisplay || LayoutNeeded) {
  639. Driver.SetAttribute (GetNormalColor ());
  640. // This is the Application.Top. Clear just the region we're being asked to redraw
  641. // (the bounds passed to us).
  642. Clear ();
  643. Driver.SetAttribute (Enabled ? Colors.Base.Normal : Colors.Base.Disabled);
  644. LayoutSubviews ();
  645. PositionToplevels ();
  646. if (this == Application.MdiTop) {
  647. foreach (var top in Application.MdiChildes.AsEnumerable ().Reverse ()) {
  648. if (top.Frame.IntersectsWith (bounds)) {
  649. if (top != this && !top.IsCurrentTop && !OutsideTopFrame (top) && top.Visible) {
  650. top.SetNeedsLayout ();
  651. top.SetNeedsDisplay (top.Bounds);
  652. top.Redraw (top.Bounds);
  653. }
  654. }
  655. }
  656. }
  657. foreach (var view in Subviews) {
  658. if (view.Frame.IntersectsWith (bounds) && !OutsideTopFrame (this)) {
  659. view.SetNeedsLayout ();
  660. view.SetNeedsDisplay (view.Bounds);
  661. }
  662. }
  663. }
  664. base.Redraw (Bounds);
  665. }
  666. bool OutsideTopFrame (Toplevel top)
  667. {
  668. if (top.Frame.X > Driver.Cols || top.Frame.Y > Driver.Rows) {
  669. return true;
  670. }
  671. return false;
  672. }
  673. internal static Point? dragPosition;
  674. Point start;
  675. ///<inheritdoc/>
  676. public override bool MouseEvent (MouseEvent mouseEvent)
  677. {
  678. if (!CanFocus) {
  679. return true;
  680. }
  681. //System.Diagnostics.Debug.WriteLine ($"dragPosition before: {dragPosition.HasValue}");
  682. int nx, ny;
  683. if (!dragPosition.HasValue && (mouseEvent.Flags == MouseFlags.Button1Pressed
  684. || mouseEvent.Flags == MouseFlags.Button2Pressed
  685. || mouseEvent.Flags == MouseFlags.Button3Pressed)) {
  686. SetFocus ();
  687. Application.EnsuresTopOnFront ();
  688. // Only start grabbing if the user clicks on the title bar.
  689. if (mouseEvent.Y == 0 && mouseEvent.Flags == MouseFlags.Button1Pressed) {
  690. start = new Point (mouseEvent.X, mouseEvent.Y);
  691. dragPosition = new Point ();
  692. nx = mouseEvent.X - mouseEvent.OfX;
  693. ny = mouseEvent.Y - mouseEvent.OfY;
  694. dragPosition = new Point (nx, ny);
  695. Application.GrabMouse (this);
  696. }
  697. //System.Diagnostics.Debug.WriteLine ($"Starting at {dragPosition}");
  698. return true;
  699. } else if (mouseEvent.Flags == (MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition) ||
  700. mouseEvent.Flags == MouseFlags.Button3Pressed) {
  701. if (dragPosition.HasValue) {
  702. if (SuperView == null) {
  703. // Redraw the entire app window using just our Frame. Since we are
  704. // Application.Top, and our Frame always == our Bounds (Location is always (0,0))
  705. // our Frame is actually view-relative (which is what Redraw takes).
  706. // We need to pass all the view bounds because since the windows was
  707. // moved around, we don't know exactly what was the affected region.
  708. Application.Top.SetNeedsDisplay ();
  709. } else {
  710. SuperView.SetNeedsDisplay ();
  711. }
  712. EnsureVisibleBounds (this, mouseEvent.X + (SuperView == null ? mouseEvent.OfX - start.X : Frame.X - start.X),
  713. mouseEvent.Y + (SuperView == null ? mouseEvent.OfY - start.Y : Frame.Y - start.Y),
  714. out nx, out ny, out _, out _);
  715. dragPosition = new Point (nx, ny);
  716. X = nx;
  717. Y = ny;
  718. //System.Diagnostics.Debug.WriteLine ($"Drag: nx:{nx},ny:{ny}");
  719. SetNeedsDisplay ();
  720. return true;
  721. }
  722. }
  723. if (mouseEvent.Flags.HasFlag (MouseFlags.Button1Released) && dragPosition.HasValue) {
  724. Application.UngrabMouse ();
  725. dragPosition = null;
  726. }
  727. //System.Diagnostics.Debug.WriteLine ($"dragPosition after: {dragPosition.HasValue}");
  728. //System.Diagnostics.Debug.WriteLine ($"Toplevel: {mouseEvent}");
  729. return false;
  730. }
  731. /// <summary>
  732. /// Invoked by <see cref="Application.Begin"/> as part of <see cref="Application.Run(Toplevel, Func{Exception, bool})"/>
  733. /// after the views have been laid out, and before the views are drawn for the first time.
  734. /// </summary>
  735. public virtual void WillPresent ()
  736. {
  737. FocusFirst ();
  738. }
  739. /// <summary>
  740. /// Move to the next Mdi child from the <see cref="Application.MdiTop"/>.
  741. /// </summary>
  742. public virtual void MoveNext ()
  743. {
  744. Application.MoveNext ();
  745. }
  746. /// <summary>
  747. /// Move to the previous Mdi child from the <see cref="Application.MdiTop"/>.
  748. /// </summary>
  749. public virtual void MovePrevious ()
  750. {
  751. Application.MovePrevious ();
  752. }
  753. /// <summary>
  754. /// Stops and closes this <see cref="Toplevel"/>. If this Toplevel is the top-most Toplevel,
  755. /// <see cref="Application.RequestStop(Toplevel)"/> will be called, causing the application to exit.
  756. /// </summary>
  757. public virtual void RequestStop ()
  758. {
  759. if (IsMdiContainer && Running
  760. && (Application.Current == this
  761. || Application.Current?.Modal == false
  762. || Application.Current?.Modal == true && Application.Current?.Running == false)) {
  763. foreach (var child in Application.MdiChildes) {
  764. var ev = new ToplevelClosingEventArgs (this);
  765. if (child.OnClosing (ev)) {
  766. return;
  767. }
  768. child.Running = false;
  769. Application.RequestStop (child);
  770. }
  771. Running = false;
  772. Application.RequestStop (this);
  773. } else if (IsMdiContainer && Running && Application.Current?.Modal == true && Application.Current?.Running == true) {
  774. var ev = new ToplevelClosingEventArgs (Application.Current);
  775. if (OnClosing (ev)) {
  776. return;
  777. }
  778. Application.RequestStop (Application.Current);
  779. } else if (!IsMdiContainer && Running && (!Modal || (Modal && Application.Current != this))) {
  780. var ev = new ToplevelClosingEventArgs (this);
  781. if (OnClosing (ev)) {
  782. return;
  783. }
  784. Running = false;
  785. Application.RequestStop (this);
  786. } else {
  787. Application.RequestStop (Application.Current);
  788. }
  789. }
  790. /// <summary>
  791. /// Stops and closes the <see cref="Toplevel"/> specified by <paramref name="top"/>. If <paramref name="top"/> is the top-most Toplevel,
  792. /// <see cref="Application.RequestStop(Toplevel)"/> will be called, causing the application to exit.
  793. /// </summary>
  794. /// <param name="top">The toplevel to request stop.</param>
  795. public virtual void RequestStop (Toplevel top)
  796. {
  797. top.RequestStop ();
  798. }
  799. ///<inheritdoc/>
  800. public override void PositionCursor ()
  801. {
  802. if (!IsMdiContainer) {
  803. base.PositionCursor ();
  804. if (Focused == null) {
  805. EnsureFocus ();
  806. if (Focused == null) {
  807. Driver.SetCursorVisibility (CursorVisibility.Invisible);
  808. }
  809. }
  810. return;
  811. }
  812. if (Focused == null) {
  813. foreach (var top in Application.MdiChildes) {
  814. if (top != this && top.Visible) {
  815. top.SetFocus ();
  816. return;
  817. }
  818. }
  819. }
  820. base.PositionCursor ();
  821. if (Focused == null) {
  822. Driver.SetCursorVisibility (CursorVisibility.Invisible);
  823. }
  824. }
  825. /// <summary>
  826. /// Gets the current visible Toplevel Mdi child that matches the arguments pattern.
  827. /// </summary>
  828. /// <param name="type">The type.</param>
  829. /// <param name="exclude">The strings to exclude.</param>
  830. /// <returns>The matched view.</returns>
  831. public View GetTopMdiChild (Type type = null, string [] exclude = null)
  832. {
  833. if (Application.MdiTop == null) {
  834. return null;
  835. }
  836. foreach (var top in Application.MdiChildes) {
  837. if (type != null && top.GetType () == type
  838. && exclude?.Contains (top.Data.ToString ()) == false) {
  839. return top;
  840. } else if ((type != null && top.GetType () != type)
  841. || (exclude?.Contains (top.Data.ToString ()) == true)) {
  842. continue;
  843. }
  844. return top;
  845. }
  846. return null;
  847. }
  848. /// <summary>
  849. /// Shows the Mdi child indicated by <paramref name="top"/>, setting it as <see cref="Application.Current"/>.
  850. /// </summary>
  851. /// <param name="top">The Toplevel.</param>
  852. /// <returns><c>true</c> if the toplevel can be shown or <c>false</c> if not.</returns>
  853. public virtual bool ShowChild (Toplevel top = null)
  854. {
  855. if (Application.MdiTop != null) {
  856. return Application.ShowChild (top == null ? this : top);
  857. }
  858. return false;
  859. }
  860. ///<inheritdoc/>
  861. public override bool OnEnter (View view)
  862. {
  863. return MostFocused?.OnEnter (view) ?? base.OnEnter (view);
  864. }
  865. ///<inheritdoc/>
  866. public override bool OnLeave (View view)
  867. {
  868. return MostFocused?.OnLeave (view) ?? base.OnLeave (view);
  869. }
  870. }
  871. /// <summary>
  872. /// Implements the <see cref="IEqualityComparer{T}"/> for comparing two <see cref="Toplevel"/>s
  873. /// used by <see cref="StackExtensions"/>.
  874. /// </summary>
  875. public class ToplevelEqualityComparer : IEqualityComparer<Toplevel> {
  876. /// <summary>Determines whether the specified objects are equal.</summary>
  877. /// <param name="x">The first object of type <see cref="Toplevel" /> to compare.</param>
  878. /// <param name="y">The second object of type <see cref="Toplevel" /> to compare.</param>
  879. /// <returns>
  880. /// <see langword="true" /> if the specified objects are equal; otherwise, <see langword="false" />.</returns>
  881. public bool Equals (Toplevel x, Toplevel y)
  882. {
  883. if (y == null && x == null)
  884. return true;
  885. else if (x == null || y == null)
  886. return false;
  887. else if (x.Id == y.Id)
  888. return true;
  889. else
  890. return false;
  891. }
  892. /// <summary>Returns a hash code for the specified object.</summary>
  893. /// <param name="obj">The <see cref="Toplevel" /> for which a hash code is to be returned.</param>
  894. /// <returns>A hash code for the specified object.</returns>
  895. /// <exception cref="ArgumentNullException">The type of <paramref name="obj" />
  896. /// is a reference type and <paramref name="obj" /> is <see langword="null" />.</exception>
  897. public int GetHashCode (Toplevel obj)
  898. {
  899. if (obj == null)
  900. throw new ArgumentNullException ();
  901. int hCode = 0;
  902. if (int.TryParse (obj.Id.ToString (), out int result)) {
  903. hCode = result;
  904. }
  905. return hCode.GetHashCode ();
  906. }
  907. }
  908. /// <summary>
  909. /// Implements the <see cref="IComparer{T}"/> to sort the <see cref="Toplevel"/>
  910. /// from the <see cref="Application.MdiChildes"/> if needed.
  911. /// </summary>
  912. public sealed class ToplevelComparer : IComparer<Toplevel> {
  913. /// <summary>Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other.</summary>
  914. /// <param name="x">The first object to compare.</param>
  915. /// <param name="y">The second object to compare.</param>
  916. /// <returns>A signed integer that indicates the relative values of <paramref name="x" /> and <paramref name="y" />, as shown in the following table.Value Meaning Less than zero
  917. /// <paramref name="x" /> is less than <paramref name="y" />.Zero
  918. /// <paramref name="x" /> equals <paramref name="y" />.Greater than zero
  919. /// <paramref name="x" /> is greater than <paramref name="y" />.</returns>
  920. public int Compare (Toplevel x, Toplevel y)
  921. {
  922. if (ReferenceEquals (x, y))
  923. return 0;
  924. else if (x == null)
  925. return -1;
  926. else if (y == null)
  927. return 1;
  928. else
  929. return string.Compare (x.Id.ToString (), y.Id.ToString ());
  930. }
  931. }
  932. /// <summary>
  933. /// <see cref="EventArgs"/> implementation for the <see cref="Toplevel.Closing"/> event.
  934. /// </summary>
  935. public class ToplevelClosingEventArgs : EventArgs {
  936. /// <summary>
  937. /// The toplevel requesting stop.
  938. /// </summary>
  939. public View RequestingTop { get; }
  940. /// <summary>
  941. /// Provides an event cancellation option.
  942. /// </summary>
  943. public bool Cancel { get; set; }
  944. /// <summary>
  945. /// Initializes the event arguments with the requesting toplevel.
  946. /// </summary>
  947. /// <param name="requestingTop">The <see cref="RequestingTop"/>.</param>
  948. public ToplevelClosingEventArgs (Toplevel requestingTop)
  949. {
  950. RequestingTop = requestingTop;
  951. }
  952. }
  953. }