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 |
|
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.
// 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.");
}
};
// 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.
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.
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.
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.
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;
}