Checkbox

The Checkbox widget provides a boolean input option with a visual checkbox and optional label.

Overview

Checkbox displays a checkable box with a label. It supports keyboard activation and provides visual feedback for checked and focus states.

Properties

IsChecked (bool)

Whether the checkbox is checked.

checkbox.IsChecked = true;

Label (string)

The checkbox label text.

checkbox.Label = "Enable feature";

BracketColor (Color)

Color of the checkbox brackets (default: Yellow).

checkbox.BracketColor = Color.Yellow;

CheckmarkColor (Color)

Color of the checkmark when checked (default: Green).

checkbox.CheckmarkColor = Color.Green;

Events

CheckedChanged

Raised when the checked state changes.

checkbox.CheckedChanged += (isChecked) =>
{
    Console.WriteLine($"Checked: {isChecked}");
};

Methods

Toggle()

Toggles the checkbox state.

checkbox.Toggle();

Keyboard Interaction

• Space or Enter: Toggle checked state
• Tab: Navigate to next focusable widget

Usage Example

var checkbox = new Checkbox("Enable notifications")
{
    X = 10,
    Y = 5,
    Width = 30,
    Height = 1,
    ForegroundColor = Color.White,
    IsChecked = false
};

checkbox.CheckedChanged += (isChecked) =>
{
    Console.WriteLine($"Notifications: {(isChecked ? "ON" : "OFF")}");
};

Related Widgets

• Button - For action buttons
• ListBox - For multiple selections
• Base Widget - Base class documentation