// // Button.cs: Button control // // Authors: // Miguel de Icaza (miguel@gnome.org) // namespace Terminal.Gui; /// /// A View that raises the event when clicked with the mouse or when the /// , Enter, or Space key is pressed. /// /// /// /// Provides a button showing text that raises the event when clicked on with a mouse or /// when the user presses Enter, Space 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 causes the button to be /// accepted the 's event will be raised. If the Accept event is not /// handled, the Accept event on the . will be raised. This enables default Accept /// behavior. /// /// /// 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))] public static ShadowStyle DefaultShadow { get; set; } = ShadowStyle.None; /// /// Gets or sets the default Highlight Style. /// [SerializableConfigurationProperty (Scope = typeof (ThemeScope))] public static HighlightStyle DefaultHighlightStyle { get; set; } = HighlightStyle.Pressed | HighlightStyle.Hover; /// 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; AddCommand (Command.HotKey, HandleHotKeyCommand); KeyBindings.Remove (Key.Space); KeyBindings.Add (Key.Space, Command.HotKey); KeyBindings.Remove (Key.Enter); KeyBindings.Add (Key.Enter, Command.HotKey); TitleChanged += Button_TitleChanged; MouseClick += Button_MouseClick; ShadowStyle = DefaultShadow; HighlightStyle = DefaultHighlightStyle; } private bool? HandleHotKeyCommand (CommandContext ctx) { bool cachedIsDefault = IsDefault; // Supports "Swap Default" in Buttons scenario where IsDefault changes if (RaiseSelecting (ctx) is true) { return true; } bool? handled = RaiseAccepted (); if (handled == true) { return true; } SetFocus (); // TODO: If `IsDefault` were a property on `View` *any* View could work this way. That's theoretical as // TODO: no use-case has been identified for any View other than Button to act like this. // If Accept was not handled... if (cachedIsDefault && SuperView is { }) { return SuperView.InvokeCommand (Command.Accept); } return false; } 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) { if (e.Handled) { return; } e.Handled = InvokeCommand (Command.HotKey, ctx: new (Command.HotKey, key: null, data: this)) == true; } private void Button_TitleChanged (object sender, EventArgs e) { base.Text = e.CurrentValue; TextFormatter.HotKeySpecifier = HotKeySpecifier; } /// public override string Text { get => Title; set => base.Text = Title = value; } /// public override Rune HotKeySpecifier { get => base.HotKeySpecifier; set => TextFormatter.HotKeySpecifier = base.HotKeySpecifier = value; } /// /// Gets or sets whether the will show an indicator indicating it is the default Button. If /// /// will be invoked when the user presses Enter and no other peer- /// processes the key. /// If is not handled, the Gets or sets whether the will show an /// indicator indicating it is the default Button. If /// command on the will be invoked. /// public bool IsDefault { get => _isDefault; set { if (_isDefault == value) { return; } _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; } }