using System; using System.Text; namespace Terminal.Gui; /// /// The shows an on/off toggle that the user can set /// public class CheckBox : View { Rune _charNullChecked; Rune _charChecked; Rune _charUnChecked; bool? @_checked; bool _allowNullChecked; /// /// Toggled event, raised when the is toggled. /// /// /// Client code can hook up to this event, it is /// raised when the is activated either with /// the mouse or the keyboard. The passed bool contains the previous state. /// public event EventHandler Toggled; /// /// Called when the property changes. Invokes the event. /// public virtual void OnToggled (ToggleEventArgs e) { Toggled?.Invoke (this, e); } /// /// Initializes a new instance of based on the given text, using layout. /// public CheckBox () : this (string.Empty) { } /// /// Initializes a new instance of based on the given text, using layout. /// /// S. /// If set to true is checked. public CheckBox (string s, bool is_checked = false) : base () { SetInitialProperties (s, is_checked); } /// /// Initializes a new instance of using layout. /// /// /// The size of is computed based on the /// text length. This is not toggled. /// public CheckBox (int x, int y, string s) : this (x, y, s, false) { } /// /// Initializes a new instance of using layout. /// /// /// The size of is computed based on the /// text length. /// public CheckBox (int x, int y, string s, bool is_checked) : base (new Rect (x, y, s.Length, 1)) { SetInitialProperties (s, is_checked); } // TODO: v2 - Remove constructors with parameters /// /// Private helper to set the initial properties of the View that were provided via constructors. /// /// /// void SetInitialProperties (string s, bool is_checked) { _charNullChecked = CM.Glyphs.NullChecked; _charChecked = CM.Glyphs.Checked; _charUnChecked = CM.Glyphs.UnChecked; Checked = is_checked; HotKeySpecifier = (Rune)'_'; CanFocus = true; AutoSize = true; Text = s; OnResizeNeeded (); // Things this view knows how to do AddCommand (Command.ToggleChecked, () => ToggleChecked ()); AddCommand (Command.Accept, () => { if (!HasFocus) { SetFocus (); } ToggleChecked (); return true; }); // Default keybindings for this view KeyBindings.Add (Key.Space, Command.ToggleChecked); } /// public override Key HotKey { get => base.HotKey; set { if (value is null || value.KeyCode is KeyCode.Unknown) { throw new ArgumentException (nameof (value)); } var prev = base.HotKey; if (prev != value) { var v = value == KeyCode.Unknown ? Key.Empty: value; base.HotKey = TextFormatter.HotKey = v; // Also add Alt+HotKey if (prev != (Key)KeyCode.Null && KeyBindings.TryGet (prev.WithAlt, out _)) { if (v.KeyCode == KeyCode.Null) { KeyBindings.Remove (prev.WithAlt); } else { KeyBindings.Replace (prev.WithAlt, v.WithAlt); } } else if (v.KeyCode != KeyCode.Null) { KeyBindings.Add (v.WithAlt, Command.Accept); } } } } /// protected override void UpdateTextFormatterText () { switch (TextAlignment) { case TextAlignment.Left: case TextAlignment.Centered: case TextAlignment.Justified: TextFormatter.Text = $"{GetCheckedState ()} {GetFormatterText ()}"; break; case TextAlignment.Right: TextFormatter.Text = $"{GetFormatterText ()} {GetCheckedState ()}"; break; } } Rune GetCheckedState () { return Checked switch { true => _charChecked, false => _charUnChecked, var _ => _charNullChecked }; } string GetFormatterText () { if (AutoSize || string.IsNullOrEmpty (Text) || Frame.Width <= 2) { return Text; } return Text [..Math.Min (Frame.Width - 2, Text.GetRuneCount ())]; } /// /// The state of the /// public bool? Checked { get => @_checked; set { if (value == null && !AllowNullChecked) { return; } @_checked = value; UpdateTextFormatterText (); OnResizeNeeded (); } } /// /// If allows to be null, true or false. /// If only allows to be true or false. /// public bool AllowNullChecked { get => _allowNullChecked; set { _allowNullChecked = value; Checked ??= false; } } /// public override void PositionCursor () { Move (0, 0); } bool ToggleChecked () { if (!HasFocus) { SetFocus (); } var previousChecked = Checked; if (AllowNullChecked) { switch (previousChecked) { case null: Checked = true; break; case true: Checked = false; break; case false: Checked = null; break; } } else { Checked = !Checked; } OnToggled (new ToggleEventArgs (previousChecked, Checked)); SetNeedsDisplay (); return true; } /// public override bool MouseEvent (MouseEvent me) { if (!me.Flags.HasFlag (MouseFlags.Button1Clicked) || !CanFocus) return false; ToggleChecked (); return true; } /// public override bool OnEnter (View view) { Application.Driver.SetCursorVisibility (CursorVisibility.Invisible); return base.OnEnter (view); } }