# Bunifu Toggle Switch (variant)

## Overview

**Bunifu Toggle Switch** variant is a  newly calibrated toggle switch with considerably great features in its design that the default Bunifu Toggle control may be unable to render.

![](/files/-MjfMGDpLCaFU4Xd3GsG)

## Getting Started

This section describes adding Bunifu Toggle Switch (variant) at the designer level and during a runtime event.

### Getting started with design view

Bunifu Toggle Switch is added to a Form by simply locating **`BunifuToggleSwitch2`** in your Visual Studio toolbox, and dragging it to the form as demonstrated below. You can quickly customize the control using its properties in the smart tag. Later in this documentation, we will get into deeper detail about its features.

![](/files/-MjZiDxqIFI1u8MiyX7b)

### Adding the toggle switch at Run-time

To add Bunifu Toggle Switch  at runtime, we will use the Form's load event to instantiate `BunifuToggleSwitch2` and add it to the form as shown in the codes below:

{% tabs %}
{% tab title="C#" %}

```csharp
private void Form1_Load(object sender, EventArgs e)
{
    //instatiate the toggle using Bunifu.UI.WinForms
    BunifuToggleSwitch2 bunifuToggle = new BunifuToggleSwitch2();
    //set the location of the toggle switch
    bunifuToggle.Location = new Point(294, 160);
    //set the toggle switch on an on-state 
    bunifuToggle.Checked = true;
    //set the checked switch style to outline
    bunifuToggle.CheckedSwitchStyle = BunifuToggleSwitch2.SwitchStyles.Outline;
    //add the control to the form
    this.Controls.Add(bunifuToggle);
}
```

{% endtab %}

{% tab title="VB.NET" %}

```erlang
Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
	'instatiate the toggle using Bunifu.UI.WinForms
	Dim bunifuToggle As New BunifuToggleSwitch2()
	'set the location of the toggle switch
	bunifuToggle.Location = New Point(294, 160)
	'set the toggle switch on an on-state 
	bunifuToggle.Checked = True
	'set the checked switch style to outline
	bunifuToggle.CheckedSwitchStyle = BunifuToggleSwitch2.SwitchStyles.Outline
	'add the control to the form
	Me.Controls.Add(bunifuToggle)
End Sub

```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
Let's deep dive and get insights into the available properties on the variant Bunifu Toggle Switch.
{% endhint %}

![](/files/-MjEla0aMETd6bSp4SL1)

## Properties

### 1. Checked

This property determines the toggle state of the control. When the property is set to true, it sets the toggle switch in an On state. By default the toggle switch is set on an Off state. 

The **`CheckedChanged`** event  fires whenever the toggle state changes. Here's a code snippet that changes the label text whenever the state changes.

{% tabs %}
{% tab title="C#" %}

```csharp
private void bunifuToggleSwitch_CheckedChanged(object sender, EventArgs e)
{
    if (bunifuToggleSwitch.Checked)
    {
        bunifuLabel.Text = "ON";
    }
    else{
        bunifuLabel.Text = "OFF";    
    }
}
```

{% endtab %}

{% tab title="VB.NET" %}

```erlang
Private Sub bunifuToggleSwitch_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs)
	If bunifuToggleSwitch.Checked Then
		bunifuLabel.Text = "ON"
	Else
		bunifuLabel.Text = "OFF"
	End If
End Sub

```

{% endtab %}
{% endtabs %}

### 2. `CheckedBackColor`

This property allows you to get or set the switch's box background color when the switch is on an On State. It supports both RGB and HEX color values.

### 3. `UncheckedBackColor`

This property allows you to get or set the switch's box background color when the switch is in an Off State. It supports both RGB and HEX color values.

### 4. `CheckedSwitchColor`

This property allows you to get or set the **fill** color of the switch thumb when the switch is on an On State. It supports both RGB and HEX color values.

### 5. `CheckedSwitchStyle`

This property allows you to get or set the surface style (enumeration) for the switch thumb when the switch is in an On State. The enumeration defines the following values: `Fill` and `Outline.`

### `6. UncheckedSwitchColor`

This property allows you to get or set the **fill** color of the switch thumb when the switch is on an Off State. It supports both RGB and HEX color values.

### `7. UncheckedSwitchStyle`

This property allows you to get or set the surface style (enumeration) for the switch thumb when the switch is in an Off State. The enumeration defines the following values: `Fill` and `Outline.`

### `8. OutlineThickness`

This property allows you to set a thickness value for the switch thumb when its style set to **outline**. By increasing the value, the outline border of the swtich thumb becomes thicker.

## Take Away

You can now generate more elegant toggle switches, which we hope will improve the appearance and feel of your UI while also providing a better user experience. 

Please contact us via chat in the bottom right corner of the screen if you have feedback or recommendations.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs2.bunifuframework.com/docs/ui/controls/bunifu-toggle-switch-variant.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.