// // Button.cs: Button control // // Authors: // Miguel de Icaza (miguel@gnome.org) // using System.Text.Json.Serialization; namespace Terminal.Gui; /// Button is a that provides an item that invokes raises the event. /// /// /// Provides a button showing text that raises the event when clicked on with a mouse or /// when the user presses SPACE, ENTER, or the . The hot key is the first letter or digit /// following the first underscore ('_') in the button text. /// /// Use to change the hot key specifier from the default of ('_'). /// /// When the button is configured as the default () and the user presses the ENTER key, if /// no other processes the key, the 's event will /// be fired. /// /// /// Set to to have the event /// invoked repeatedly while the button is pressed. /// /// public class Button : View, IDesignable { private readonly Rune _leftBracket; private readonly Rune _leftDefault; private readonly Rune _rightBracket; private readonly Rune _rightDefault; private bool _isDefault; /// /// Gets or sets whether s are shown with a shadow effect by default. /// [SerializableConfigurationProperty (Scope = typeof (ThemeScope))] [JsonConverter (typeof (JsonStringEnumConverter))] public static ShadowStyle DefaultShadow { get; set; } = ShadowStyle.None; /// Initializes a new instance of . public Button () { TextAlignment = Alignment.Center; VerticalTextAlignment = Alignment.Center; _leftBracket = Glyphs.LeftBracket; _rightBracket = Glyphs.RightBracket; _leftDefault = Glyphs.LeftDefaultIndicator; _rightDefault = Glyphs.RightDefaultIndicator; Height = Dim.Auto (DimAutoStyle.Text); Width = Dim.Auto (DimAutoStyle.Text); CanFocus = true; HighlightStyle |= HighlightStyle.Pressed; #if HOVER HighlightStyle |= HighlightStyle.Hover; #endif // Override default behavior of View AddCommand (Command.HotKey, () => { SetFocus (); return !OnAccept (); }); KeyBindings.Add (Key.Space, Command.HotKey); KeyBindings.Add (Key.Enter, Command.HotKey); TitleChanged += Button_TitleChanged; MouseClick += Button_MouseClick; ShadowStyle = DefaultShadow; } private bool _wantContinuousButtonPressed; /// public override bool WantContinuousButtonPressed { get => _wantContinuousButtonPressed; set { if (value == _wantContinuousButtonPressed) { return; } _wantContinuousButtonPressed = value; if (_wantContinuousButtonPressed) { HighlightStyle |= HighlightStyle.PressedOutside; } else { HighlightStyle &= ~HighlightStyle.PressedOutside; } } } private void Button_MouseClick (object sender, MouseEventEventArgs e) { e.Handled = InvokeCommand (Command.HotKey) == true; } private void Button_TitleChanged (object sender, EventArgs e) { base.Text = e.CurrentValue; TextFormatter.HotKeySpecifier = HotKeySpecifier; } /// public override string Text { get => base.Title; set => base.Text = base.Title = value; } /// public override Rune HotKeySpecifier { get => base.HotKeySpecifier; set => TextFormatter.HotKeySpecifier = base.HotKeySpecifier = value; } /// Gets or sets whether the is the default action to activate in a dialog. /// true if is default; otherwise, false. public bool IsDefault { get => _isDefault; set { _isDefault = value; UpdateTextFormatterText (); OnResizeNeeded (); } } /// public bool NoDecorations { get; set; } /// public bool NoPadding { get; set; } /// public override Point? PositionCursor () { if (HotKey.IsValid && Text != "") { for (var i = 0; i < TextFormatter.Text.GetRuneCount (); i++) { if (TextFormatter.Text [i] == Text [0]) { Move (i, 0); return null; // Don't show the cursor } } } return base.PositionCursor (); } /// protected override void UpdateTextFormatterText () { base.UpdateTextFormatterText(); if (NoDecorations) { TextFormatter.Text = Text; } else if (IsDefault) { TextFormatter.Text = $"{_leftBracket}{_leftDefault} {Text} {_rightDefault}{_rightBracket}"; } else { if (NoPadding) { TextFormatter.Text = $"{_leftBracket}{Text}{_rightBracket}"; } else { TextFormatter.Text = $"{_leftBracket} {Text} {_rightBracket}"; } } } /// public bool EnableForDesign () { Title = "_Button"; return true; } }