gui-cs.Terminal.Gui/Terminal.Gui/Views/StatusBar.cs

//
// StatusBar.cs: a statusbar for an application
//
// Authors:
//   Miguel de Icaza ([email protected])
//
// TODO:
//   Add mouse support
using System;
using NStack;

namespace Terminal.Gui {
	/// <summary>
	/// A statusbar item has a title, a shortcut aka hotkey, and an action to execute on activation.
	/// Such an item is ment to be as part of the global hotkeys of the application, which are available in the current context of the screen.
	/// The colour of the text will be changed after each ~. Having an statusbar item with a text of `~F1~ Help` will draw *F1* as shortcut and
	/// *Help* as standard text.
	/// </summary>
	public class StatusItem {
		/// <summary>
		/// Initializes a new <see cref="T:Terminal.Gui.StatusItem"/>.
		/// </summary>
		/// <param name="shortcut">Shortcut to activate the item.</param>
		/// <param name="title">Title for the statusbar item.</param>
		/// <param name="action">Action to invoke when the staturbar item is activated.</param>
		public StatusItem (Key shortcut, ustring title, Action action)
		{
			Title = title ?? "";
			Shortcut = shortcut;
			Action = action;
		}

		/// <summary>
		/// This is the global setting that can be used as a global shortcut to invoke the action on the menu.
		/// </summary>
		public Key Shortcut { get; }

		/// <summary>
		/// Gets or sets the title.
		/// </summary>
		/// <value>The title.</value>
		public ustring Title { get; }

		/// <summary>
		/// Gets or sets the action to be invoked when the statusbar item is triggered
		/// </summary>
		/// <value>Method to invoke.</value>
		public Action Action { get; }
	};

	/// <summary>
	/// A statusbar for your application.
	/// The statusbar should be context sensitive. This means, if the main menu and an open text editor are visible, the items probably shown will
	/// be ~F1~ Help ~F2~ Save ~F3~ Load. While a dialog to ask a file to load is executed, the remaining commands will probably be ~F1~ Help.
	/// So for each context must be a new instance of a statusbar.
	/// </summary>
	public class StatusBar : View {
// After attempting to implement this, I noticed that there are hard dependencies
// on StatusBar and MenuBars within core. They will need to be refactored for having the
// StatusBar work at the top
#if SNAP_TO_TOP
		/// <summary>
		/// The style supported by StatusBar
		/// </summary>
		public enum StatusBarStyle {
			Default = 0,
			/// <summary>
			/// The StatusBar will snap at the the bottom line of the Parent view.
			/// If the console window is made larger while the app is runing, the StatusBar
			/// will continue to snap to the bottom line of the Parent, staying visible.
			/// On consoles that support resizing of console apps (e.g. Windows Terminal and ConEmu),
			/// if the console window is subsequently made shorter, the status bar will remain visible
			/// as the Parent view resizes. If Parent is null, the StatusBar will snap to the bottom line
			/// of the console window.
			/// This is the default.
			/// </summary>
			SnapToBottom = Default,

			/// <summary>
			/// The StatusBar will act identically to MenuBar, snapping to the first line of the
			/// console window.
			/// </summary>
			SnapToTop = 1,
		}

		public StatusBarStyle Style { get; set; } = StatusBarStyle.Default;
#endif
		/// <summary>
		/// The parent view of the StatusBar.
		/// </summary>
		public View Parent { get; set; }

		/// <summary>
		/// The items that compose the StatusBar
		/// </summary>
		public StatusItem [] Items { get; set; }

		/// <summary>
		/// Initializes a new instance of the <see cref="T:Terminal.Gui.StatusBar"/> class with the specified set of statusbar items.
		/// It will be drawn in the lowest line of the terminal.
		/// </summary>
		/// <param name="items">A list of statusbar items.</param>
		public StatusBar (StatusItem [] items) : base ()
		{
			Width = Dim.Fill ();
			Height = 1;
			Items = items;
			CanFocus = false;
			ColorScheme = Colors.Menu;

			Application.Loaded += (sender, e) => {
				X = 0;
				Height = 1;
#if SNAP_TO_TOP
				switch (Style) {
				case StatusBarStyle.SnapToTop:
					X = 0;
					Y = 0;
					break;
				case StatusBarStyle.SnapToBottom:
#endif
					if (Parent == null) {
						Y = e.Rows - 1; 
					} else {
						Y = Pos.Bottom (Parent);
					}
#if SNAP_TO_TOP
					break;
				}
#endif
			};
		}

		Attribute ToggleScheme (Attribute scheme)
		{
			var result = scheme == ColorScheme.Normal ? ColorScheme.HotNormal : ColorScheme.Normal;
			Driver.SetAttribute (result);
			return result;
		}

		///<inheritdoc cref="Redraw"/>
		public override void Redraw (Rect region)
		{
			if (Frame.Y != Driver.Rows - 1) {
				Frame = new Rect (Frame.X, Driver.Rows - 1, Frame.Width, Frame.Height);
				Y = Driver.Rows - 1;
				SetNeedsDisplay ();
			}

			Move (0, 0);
			Driver.SetAttribute (ColorScheme.Normal);
			for (int i = 0; i < Frame.Width; i++)
				Driver.AddRune (' ');

			Move (1, 0);
			var scheme = ColorScheme.Normal;
			Driver.SetAttribute (scheme);
			for (int i = 0; i < Items.Length; i++) {
				var title = Items [i].Title;
				for (int n = 0; n < title.Length; n++) {
					if (title [n] == '~') {
						scheme = ToggleScheme (scheme);
						continue;
					}
					Driver.AddRune (title [n]);
				}
				Driver.AddRune (' ');
			}
		}

		///<inheritdoc cref="ProcessHotKey"/>
		public override bool ProcessHotKey (KeyEvent kb)
		{
			foreach (var item in Items) {
				if (kb.Key == item.Shortcut) {
					if (item.Action != null) item.Action ();
					return true;
				}
			}
			return false;
		}
	}
}