using System.ComponentModel;
using System.Reflection.Metadata;
using Terminal.Gui.Analyzers.Internal.Attributes;
namespace Terminal.Gui;
///
/// Displays a command, help text, and a key binding. When the key is pressed, the command will be invoked. Useful for
/// displaying a command in such as a
/// menu, toolbar, or status bar.
///
///
///
/// When the user clicks on the or presses the key
/// specified by the command is invoked, causing the
/// event to be fired
///
///
/// If is , the
/// command
/// be invoked regardless of what View has focus, enabling an application-wide keyboard shortcut.
///
///
/// A Shortcut displays the command text on the left side, the help text in the middle, and the key binding on the
/// right side.
///
///
/// The command text can be set by setting the 's Text property.
///
///
/// The help text can be set by setting the property or by setting .
///
///
/// The key text is set by setting the property.
/// If the is , the text is not displayed.
///
///
public class Shortcut : View
{
///
/// Creates a new instance of ;
///
///
///
///
///
public Shortcut (Key key, string commandText, Action action, string helpText = null)
{
Id = "_shortcut";
HighlightStyle = HighlightStyle.Pressed;
Highlight += Shortcut_Highlight;
CanFocus = true;
Width = GetWidthDimAuto ();
Height = Dim.Auto (DimAutoStyle.Content, 1);
AddCommand (Command.HotKey, OnAccept);
AddCommand (Command.Accept, OnAccept);
KeyBindings.Add (KeyCode.Space, Command.Accept);
KeyBindings.Add (KeyCode.Enter, Command.Accept);
TitleChanged += Shortcut_TitleChanged; // This needs to be set before CommandView is set
CommandView = new ()
{
Width = Dim.Auto (),
Height = Dim.Auto (),
};
HelpView.Id = "_helpView";
HelpView.CanFocus = false;
HelpView.Text = helpText;
Add (HelpView);
KeyView.Id = "_keyView";
KeyView.CanFocus = false;
Add (KeyView);
// If the user clicks anywhere on the Shortcut, other than the CommandView, invoke the Command
MouseClick += Shortcut_MouseClick;
HelpView.MouseClick += Shortcut_MouseClick;
KeyView.MouseClick += Shortcut_MouseClick;
LayoutStarted += OnLayoutStarted;
Initialized += OnInitialized;
if (key is null)
{
key = Key.Empty;
}
Key = key;
Title = commandText;
Action = action;
return;
void OnInitialized (object sender, EventArgs e)
{
SuperViewRendersLineCanvas = true;
Border.ShowTitle = false;
ShowHide ();
// Force Width to DimAuto to calculate natural width and then set it back
Dim savedDim = Width;
Width = GetWidthDimAuto ();
_minimumDimAutoWidth = Frame.Width;
Width = savedDim;
SetCommandViewDefaultLayout ();
SetHelpViewDefaultLayout ();
SetKeyViewDefaultLayout ();
SetColors ();
}
// Helper to set Width consistently
Dim GetWidthDimAuto ()
{
// TODO: PosAlign.CalculateMinDimension is a hack. Need to figure out a better way of doing this.
return Dim.Auto (DimAutoStyle.Content, minimumContentDim: Dim.Func (() => PosAlign.CalculateMinDimension (0, Subviews, Dimension.Width)), maximumContentDim: Dim.Func (() => PosAlign.CalculateMinDimension (0, Subviews, Dimension.Width)));
}
}
///
/// Creates a new instance of .
///
public Shortcut () : this (Gui.Key.Empty, string.Empty, null) { }
///
/// Gets or sets the for this . The default is
/// , which is ideal for status bars and toolbars. If set to ,
/// the Shortcut will be configured for vertical layout, which is ideal for menus.
///
public Orientation Orientation { get; set; } = Orientation.Horizontal;
private AlignmentModes _alignmentModes = AlignmentModes.StartToEnd | AlignmentModes.IgnoreFirstOrLast;
///
/// Gets or sets the for this . The default is .
///
public AlignmentModes AlignmentModes
{
get => _alignmentModes;
set
{
_alignmentModes = value;
SetCommandViewDefaultLayout ();
SetHelpViewDefaultLayout ();
SetKeyViewDefaultLayout ();
}
}
// When one of the subviews is "empty" we don't want to show it. So we
// Use Add/Remove. We need to be careful to add them in the right order
// so Pos.Align works correctly.
private void ShowHide ()
{
RemoveAll ();
if (CommandView.Visible)
{
Add (CommandView);
}
if (HelpView.Visible && !string.IsNullOrEmpty (HelpView.Text))
{
Add (HelpView);
}
if (KeyView.Visible && Key != Key.Empty)
{
Add (KeyView);
}
}
// This is used to calculate the minimum width of the Shortcut when the width is NOT Dim.Auto
private int? _minimumDimAutoWidth;
// When layout starts, we need to adjust the layout of the HelpView and KeyView
private void OnLayoutStarted (object sender, LayoutEventArgs e)
{
if (Width is DimAuto widthAuto)
{
_minimumDimAutoWidth = Frame.Width;
}
else
{
if (string.IsNullOrEmpty (HelpView.Text))
{
return;
}
int currentWidth = Frame.Width;
// If our width is smaller than the natural then reduce width of HelpView.
if (currentWidth < _minimumDimAutoWidth)
{
int delta = _minimumDimAutoWidth.Value - currentWidth;
int maxHelpWidth = int.Max (0, HelpView.Text.GetColumns () + Margin.Thickness.Horizontal - delta);
switch (maxHelpWidth)
{
case 0:
// Hide HelpView
HelpView.Visible = false;
HelpView.X = 0;
break;
case 1:
// Scrunch it by removing margins
HelpView.Margin.Thickness = new (0, 0, 0, 0);
break;
case 2:
// Scrunch just the right margin
var t = GetMarginThickness ();
HelpView.Margin.Thickness = new (t.Right, t.Top, t.Left - 1, t.Bottom);
break;
default:
// Default margin
HelpView.Margin.Thickness = GetMarginThickness ();
break;
}
if (maxHelpWidth > 0)
{
HelpView.X = Pos.Align (Alignment.End, AlignmentModes);
// Leverage Dim.Auto's max:
HelpView.Width = Dim.Auto (DimAutoStyle.Text, maximumContentDim: maxHelpWidth);
HelpView.Visible = true;
}
}
else
{
// Reset to default
//SetCommandViewDefaultLayout();
SetHelpViewDefaultLayout ();
//SetKeyViewDefaultLayout ();
}
}
}
private Thickness GetMarginThickness ()
{
if (Orientation == Orientation.Vertical)
{
return new Thickness (1, 0, 1, 0);
}
else
{
return new Thickness (1, 0, 1, 0);
}
}
private Color? _savedForeColor;
private void Shortcut_Highlight (object sender, HighlightEventArgs e)
{
if (e.HighlightStyle.HasFlag (HighlightStyle.Pressed))
{
if (!_savedForeColor.HasValue)
{
_savedForeColor = base.ColorScheme.Normal.Foreground;
}
var cs = new ColorScheme (base.ColorScheme)
{
Normal = new (ColorScheme.Normal.Foreground.GetHighlightColor (), base.ColorScheme.Normal.Background)
};
base.ColorScheme = cs;
}
if (e.HighlightStyle == HighlightStyle.None && _savedForeColor.HasValue)
{
var cs = new ColorScheme (base.ColorScheme)
{
Normal = new (_savedForeColor.Value, base.ColorScheme.Normal.Background)
};
base.ColorScheme = cs;
}
SuperView?.SetNeedsDisplay ();
e.Cancel = true;
}
private void Shortcut_MouseClick (object sender, MouseEventEventArgs e)
{
// When the Shortcut is clicked, we want to invoke the Command and Set focus
var view = sender as View;
if (!e.Handled)
{
// If the subview (likely CommandView) didn't handle the mouse click, invoke the command.
e.Handled = InvokeCommand (Command.Accept) == true;
}
if (CanFocus)
{
SetFocus ();
}
}
#region Command
private View _commandView = new ();
///
/// Gets or sets the View that displays the command text and hotkey.
///
///
///
/// By default, the of the is displayed as the Shortcut's
/// command text.
///
///
/// By default, the CommandView is a with set to
/// .
///
///
/// Setting the will add it to the and remove any existing
/// .
///
///
///
///
/// This example illustrates how to add a to a that toggles the
/// property.
///
///
/// var force16ColorsShortcut = new Shortcut
/// {
/// Key = Key.F6,
/// KeyBindingScope = KeyBindingScope.HotKey,
/// CommandView = new CheckBox { Text = "Force 16 Colors" }
/// };
/// var cb = force16ColorsShortcut.CommandView as CheckBox;
/// cb.Checked = Application.Force16Colors;
///
/// cb.Toggled += (s, e) =>
/// {
/// var cb = s as CheckBox;
/// Application.Force16Colors = cb!.Checked == true;
/// Application.Refresh();
/// };
/// StatusBar.Add(force16ColorsShortcut);
///
///
public View CommandView
{
get => _commandView;
set
{
if (value == null)
{
throw new ArgumentNullException ();
}
if (_commandView is { })
{
Remove (_commandView);
_commandView?.Dispose ();
}
_commandView = value;
_commandView.Id = "_commandView";
_commandView.MouseClick += Shortcut_MouseClick;
_commandView.Accept += CommandViewAccept;
_commandView.HotKeyChanged += (s, e) =>
{
if (e.NewKey != Key.Empty)
{
// Add it
AddKeyBindingsForHotKey (e.OldKey, e.NewKey);
}
};
_commandView.HotKeySpecifier = new ('_');
Title = _commandView.Text;
SetCommandViewDefaultLayout ();
SetHelpViewDefaultLayout ();
SetKeyViewDefaultLayout ();
ShowHide ();
UpdateKeyBinding ();
return;
void CommandViewAccept (object sender, CancelEventArgs e)
{
// When the CommandView fires its Accept event, we want to act as though the
// Shortcut was clicked.
if (base.OnAccept () == true)
{
e.Cancel = true;
}
}
}
}
private void SetCommandViewDefaultLayout ()
{
CommandView.Margin.Thickness = GetMarginThickness ();
CommandView.X = Pos.Align (Alignment.End, AlignmentModes);
CommandView.Y = 0;//Pos.Center ();
}
private void Shortcut_TitleChanged (object sender, StateEventArgs e)
{
// If the Title changes, update the CommandView text.
// This is a helper to make it easier to set the CommandView text.
// CommandView is public and replaceable, but this is a convenience.
_commandView.Text = Title;
}
#endregion Command
#region Help
///
/// The subview that displays the help text for the command. Internal for unit testing.
///
internal View HelpView { get; } = new ();
private void SetHelpViewDefaultLayout ()
{
HelpView.Margin.Thickness = GetMarginThickness ();
HelpView.X = Pos.Align (Alignment.End, AlignmentModes);
HelpView.Y = 0;//Pos.Center ();
HelpView.Width = Dim.Auto (DimAutoStyle.Text);
HelpView.Height = CommandView?.Visible == true ? Dim.Height (CommandView) : 1;
HelpView.Visible = true;
HelpView.VerticalTextAlignment = Alignment.Center;
}
///
/// Gets or sets the help text displayed in the middle of the Shortcut. Identical in function to
/// .
///
public override string Text
{
get => HelpView?.Text;
set
{
if (HelpView != null)
{
HelpView.Text = value;
ShowHide ();
}
}
}
///
/// Gets or sets the help text displayed in the middle of the Shortcut.
///
public string HelpText
{
get => HelpView?.Text;
set
{
if (HelpView != null)
{
HelpView.Text = value;
ShowHide ();
}
}
}
#endregion Help
#region Key
private Key _key = Key.Empty;
///
/// Gets or sets the that will be bound to the command.
///
public Key Key
{
get => _key;
set
{
if (value == null)
{
throw new ArgumentNullException ();
}
_key = value;
UpdateKeyBinding ();
KeyView.Text = Key == Key.Empty ? string.Empty : $"{Key}";
ShowHide ();
}
}
private KeyBindingScope _keyBindingScope = KeyBindingScope.HotKey;
///
/// Gets or sets the scope for the key binding for how is bound to .
///
public KeyBindingScope KeyBindingScope
{
get => _keyBindingScope;
set
{
_keyBindingScope = value;
UpdateKeyBinding ();
}
}
// TODO: Make internal once Bar is done
///
/// Gets the subview that displays the key. Internal for unit testing.
///
public View KeyView { get; } = new ();
private int _minimumKeyViewSize;
///
///
public int MinimumKeyViewSize
{
get => _minimumKeyViewSize;
set
{
if (value == _minimumKeyViewSize)
{
//return;
}
_minimumKeyViewSize = value;
SetKeyViewDefaultLayout ();
CommandView.SetNeedsLayout ();
HelpView.SetNeedsLayout ();
KeyView.SetNeedsLayout ();
SetSubViewNeedsDisplay ();
}
}
private int GetMinimumKeyViewSize () { return MinimumKeyViewSize; }
private void SetKeyViewDefaultLayout ()
{
KeyView.Margin.Thickness = GetMarginThickness ();
KeyView.X = Pos.Align (Alignment.End, AlignmentModes);
KeyView.Y = 0;//Pos.Center ();
KeyView.Width = Dim.Auto (DimAutoStyle.Text, Dim.Func (GetMinimumKeyViewSize));
KeyView.Height = CommandView?.Visible == true ? Dim.Height (CommandView) : 1;
KeyView.Visible = true;
// Right align the text in the keyview
KeyView.TextAlignment = Alignment.End;
KeyView.VerticalTextAlignment = Alignment.Center;
KeyView.KeyBindings.Clear ();
}
private void UpdateKeyBinding ()
{
if (Key != null)
{
KeyBindings.Remove (Key);
KeyBindings.Add (Key, KeyBindingScope, Command.Accept);
}
}
#endregion Key
#region Accept Handling
///
/// Called when the command is received. This
/// occurs if the user clicks on the Bar with the mouse or presses the key bound to
/// Command.Accept (Space by default).
///
protected new bool? OnAccept ()
{
var handled = true;
switch (KeyBindingScope)
{
case KeyBindingScope.Application:
handled = false;
break;
case KeyBindingScope.Focused:
// TODO: Figure this out
handled = false;
break;
case KeyBindingScope.HotKey:
_commandView.InvokeCommand (Command.HotKey);
handled = false;
break;
}
if (handled == false)
{
if (base.OnAccept () is false)
{
Action?.Invoke ();
return true;
}
}
return false;
}
///
/// Gets or sets the action to be invoked when the shortcut key is pressed or the shortcut is clicked on with the mouse.
///
///
/// Note, the event is fired first, and if cancelled, the event will not be invoked.
///
[CanBeNull]
public Action Action { get; set; }
#endregion Accept Handling
#region Focus
///
public override ColorScheme ColorScheme
{
get => base.ColorScheme;
set
{
base.ColorScheme = value;
SetColors ();
}
}
///
///
///
internal void SetColors ()
{
// Border should match superview.
Border.ColorScheme = SuperView?.ColorScheme;
if (HasFocus)
{
// When we have focus, we invert the colors
base.ColorScheme = new (base.ColorScheme)
{
Normal = base.ColorScheme.Focus,
HotNormal = base.ColorScheme.HotFocus,
HotFocus = base.ColorScheme.HotNormal,
Focus = base.ColorScheme.Normal
};
}
else
{
base.ColorScheme = SuperView?.ColorScheme;
}
// Set KeyView's colors to show "hot"
if (IsInitialized && base.ColorScheme is { })
{
var cs = new ColorScheme (base.ColorScheme)
{
Normal = base.ColorScheme.HotNormal,
HotNormal = base.ColorScheme.Normal
};
KeyView.ColorScheme = cs;
}
}
///
public override bool OnEnter (View view)
{
SetColors ();
return base.OnEnter (view);
}
///
public override bool OnLeave (View view)
{
SetColors ();
return base.OnLeave (view);
}
#endregion Focus
///
protected override void Dispose (bool disposing)
{
if (disposing)
{
if (CommandView?.IsAdded == false)
{
CommandView.Dispose ();
}
if (HelpView?.IsAdded == false)
{
HelpView.Dispose ();
}
if (KeyView?.IsAdded == false)
{
KeyView.Dispose ();
}
}
base.Dispose (disposing);
}
}