ConsoleForge 0.3.0
Elm-architecture TUI framework for .NET 8
Loading...
Searching...
No Matches
ConsoleForge.Widgets.Checkbox Class Referencesealed

A single toggleable checkbox widget. More...

Inheritance diagram for ConsoleForge.Widgets.Checkbox:

Public Member Functions

 Checkbox ()
 Object-initializer constructor; all properties default.
 Checkbox (string label="", bool isChecked=false, char checkedChar='✓', char uncheckedChar=' ', Style? style=null)
 Positional constructor for inline usage.
void OnKeyEvent (KeyMsg key, Action< IMsg > dispatch)
 Toggle the checkbox state when Space or Enter is pressed.
void Render (IRenderContext ctx)
 Renders the checkbox as [✓] Label or [ ] Label.

Properties

char CheckedChar = '✓' [get]
 Character rendered inside the brackets when checked. Default '✓'.
bool HasFocus [get, set]
 True when this widget holds keyboard focus.
SizeConstraint Height = SizeConstraint.Fixed(1) [get]
 Height constraint used by the layout engine.
bool IsChecked [get]
 Whether the checkbox is currently checked.
string Label = "" [get]
 Text label displayed after the checkbox indicator.
Style Style = Style.Default [get]
 Visual style for the widget. Inherits theme base style when unset.
char UncheckedChar = ' ' [get]
 Character rendered inside the brackets when unchecked. Default ' '.
SizeConstraint Width = SizeConstraint.Flex(1) [get]
 Width constraint used by the layout engine.

Detailed Description

A single toggleable checkbox widget.

Renders as [✓] Label or [ ] Label. Dispatches CheckboxToggledMsg when the user presses Space or Enter.

Constructor & Destructor Documentation

◆ Checkbox()

ConsoleForge.Widgets.Checkbox.Checkbox ( string label = "",
bool isChecked = false,
char checkedChar = '✓',
char uncheckedChar = ' ',
Style? style = null )

Positional constructor for inline usage.

Parameters
labelText displayed next to the checkbox.
isCheckedInitial checked state.
checkedCharIndicator character when checked.
uncheckedCharIndicator character when unchecked.
styleOptional visual style override.

Member Function Documentation

◆ Render()

void ConsoleForge.Widgets.Checkbox.Render ( IRenderContext ctx)

Renders the checkbox as [✓] Label or [ ] Label.

The indicator brackets and label are styled together. When focused, the active theme's Theme.FocusedStyle is blended in.

Implements ConsoleForge.Layout.IWidget.


The documentation for this class was generated from the following file:
  • src/ConsoleForge/Widgets/Checkbox.cs