Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Toggle Button Advanced

Siticone Toggle Button Advanced

The SiticoneToggleButtonAdvanced provides a sophisticated, material-design inspired checkbox experience. It goes beyond standard toggle functionality by offering specialized styles like "Switch" and "Glow", multiple checkmark shapes (Tick, Cross, Dot), gradient support, and a vast library of over 20 preset themes.

Visual Styles

Choose how the control renders its state.

Property Type Description
Style CheckBoxStyleAdvanced
  • Modern: Standard checkbox with smooth transitions.
  • Glow: Adds an outer glow effect when active.
  • Switch: Renders as a sliding toggle (like iOS/Android switches).
CheckmarkStyle Enum The symbol shown when checked: Tick (✓), Cross (✕), or Dot (●).
CheckmarkScale float Scales the size of the internal checkmark symbol (Default: 1.0).

Layout & Text

Position the text relative to the checkbox control.

Property Type Description
TextPosition Enum Places text Right (default), Left, Top, or Bottom of the box.
CheckAreaPadding int Padding between the box border and the inner checkmark.
BoxSize int Dimensions of the checkbox/switch graphic.

Colors & Effects

Granular control over every visual aspect, including gradients and glows.

Property Type Description
BoxColor Color Background color when unchecked.
CheckedBoxColor Color Background color when checked.
UseGradient bool Enables gradient fill for the checked state.
GradientColor1/2 Color Start and end colors for the gradient.
GlowColor Color Color of the outer glow effect (active in Glow style).
GlowIntensity int Strength/Radius of the glow effect.

Interaction & Behavior

Property Type Description
Checked bool Gets or sets the checked state.
AllowIndeterminate bool Allows the control to enter a third "Indeterminate" state.
ReadOnly bool Prevents user interaction while maintaining appearance.
UltraPerformance bool Disables all animations for maximum rendering speed.

Events

Advanced events support cancellation logic.

BeforeCheckStateChanged Event
// Allows cancelling the check action based on logic.
toggleAdv.BeforeCheckStateChanged += (s, e) => 
{
                if (e.NewState == CheckState.Checked && !IsAuthorized())
    {
        e.Cancel = true;
                MessageBox.Show("Access Denied.");
    }
};
CheckedChanged Event
// Fired after the state has changed.
toggleAdv.CheckedChanged += (s, e) => 
{
                Console.WriteLine($"New state: {toggleAdv.Checked}");
};

Designer Support

Includes a massive library of preset themes accessible via Smart Tag.

Category Features
Standard Themes Default Light/Dark, Windows 11, Apple Switch, Google Material.
Creative Themes Cyberpunk, Synthwave, Nordic, Forest, Oceanic, Graphite.
Specialty Themes Sunset, Bubblegum, Mint, Lava, Luxury Gold.

Usage Examples

Example 1: iOS Style Switch

Configuring the control to behave like a mobile toggle switch.

C# - Switch Setup
private void SetupSwitch()
{
    chkSwitch.Style = CheckBoxStyleAdvanced.Switch;
    
                // iOS Colors
    chkSwitch.CheckedBoxColor = Color.FromArgb(52, 199, 89);
    chkSwitch.BoxColor = Color.FromArgb(229, 229, 234);
    chkSwitch.CheckmarkColor = Color.White;
    
                // Round appearance
    chkSwitch.BorderRadius = 15;
}

Example 2: Neon Glow Effect

Using the Glow style with gradients for a high-tech look.

C# - Neon Theme
private void SetupNeonCheckbox()
{
    chkNeon.Style = CheckBoxStyleAdvanced.Glow;
    chkNeon.UseGradient = true;
    
                // Neon Cyan/Magenta Gradient
    chkNeon.GradientColor1 = Color.Cyan;
    chkNeon.GradientColor2 = Color.Magenta;
    
                // Matching Glow
    chkNeon.GlowColor = Color.FromArgb(100, Color.Cyan);
    chkNeon.GlowIntensity = 6;
    
                // Dark Background for contrast
    chkNeon.BoxColor = Color.FromArgb(30, 30, 30);
}

Example 3: Multi-Select with Indeterminate State

Managing a "Select All" checkbox for a list.

C# - Indeterminate Logic
private void UpdateSelectAllState(int selectedCount, int totalCount)
{
    chkSelectAll.AllowIndeterminate = true;
    
                if (selectedCount == 0)
        chkSelectAll.CheckState = CheckState.Unchecked;
                else if (selectedCount == totalCount)
        chkSelectAll.CheckState = CheckState.Checked;
                else
        chkSelectAll.CheckState = CheckState.Indeterminate;
}

Example 4: Custom Delete Checkbox

Using the "Cross" style to indicate a destructive action.

C# - Delete Action
private void SetupDeleteOption()
{
    chkDelete.Text = "Mark for Deletion";
    
                // Use 'X' symbol
    chkDelete.CheckmarkStyle = AdvancedCheckmarkStyle.Cross;
    
                // Red colors for warning
    chkDelete.CheckedBoxColor = Color.Crimson;
    chkDelete.CheckedBorderColor = Color.DarkRed;
    chkDelete.CheckmarkColor = Color.White;
}