# Bunifu CheckBox

## **Overview**

**Bunifu Checkbox** is a .NET control used for selecting one or more options from a list of predefined choices. With Bunifu CheckBox you can design way good-looking checkboxes that will guarantee a great user experience. It supports an indeterminate state, different sizes, custom labels and positions, and UI customization

Bunifu CheckBox works like the standard CheckBox and is used by the user for selecting options. Below is an illustration whereby Bunifu Checkbox has been used in creating a predefined user choice list of settings.

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdMPH_rkIzUZYc73LOS%2F-MdMaLZADLhkmVn_JM0q%2Fcheckbox01.gif?alt=media\&token=80539792-e47b-4ec2-90a8-774e37a8823e)

## Getting started

### Adding Bunifu CheckBox in design time

It's easy to add Bunifu Checkbox control at design time. Start by locating Bunifu Checkbox from your toolbox and simply drag it to your form as shown below then customize it to your desired look and feel using properties that will be elaborated on later in this article.

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdMafFWSh4d2JcRsYOA%2F-MdMxWTONlCU9hCdQW4E%2Fcheckbox03.gif?alt=media\&token=6d057ef0-307f-4aee-af1e-d16d525431d9)

Let's continue with an example and begin by creating a simple application that tracks a list of to-do items in a day.

**Step one:** Create a new form and set its layout as shown below:

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdNIWfzmGkCoHzbiik6%2F-MdNJq13eEL-MS0AQiS9%2FCheckbox001.jpg?alt=media\&token=8b00f1e1-bc82-4e48-9cb9-c247d42b0c80)

**Step two:** Set the `FlowLayoutPanel` to a flow direction of **Top-down**. Then drop a Panel inside the `FlowLayoutPanel` and resize it to a width of **174** and a height of **48.** Also, set its background color to `235, 245, 255`

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdMafFWSh4d2JcRsYOA%2F-MdNCKTTRenNbMlakUu1%2Fimage.png?alt=media\&token=af99abf6-05a7-4c7e-a68b-bb964488a16d)

**Step three:** Inside the panel, drop a Bunifu Checkbox control and Bunifu Label, then position them as illustrated below:

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdMafFWSh4d2JcRsYOA%2F-MdNEJrLn1CaYGARWO_6%2Fimage.png?alt=media\&token=dd87a409-72fd-4d39-b7ab-62a449192645)

**Step four:** Access the properties of the checkbox and look out for the **`BindingControl`** property and set the label beside it as the binding control. Then replicate the panel within the FlowLayoutPanel. And as you duplicate the panels ensure you change the label text.

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdMafFWSh4d2JcRsYOA%2F-MdNICaL6X--JKv5ifzh%2Fimage.png?alt=media\&token=0c981556-d441-40fb-b37c-898878e6b8cb)

**Step five:** Write the following code in the form load event. Here  we'll loop through the controls in the `FlowLayoutPanel` , get the checkboxes and assign a `CheckStateChanged` event to each of them through code:

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

```csharp
private void Form1_Load(object sender, EventArgs e)
{
    //Loop the panels in the FlowLayoutPanel
    foreach (Panel panel in flowLayoutPanel1.Controls)
    {
        //Loop each control in the panel
        foreach (var ctrl in panel.Controls)
        {
            /*check whether a control is a Bunifu Checkbox and assign 
                * each with a CheckStateChanged event
                */
            if (ctrl is BunifuCheckBox)
            {
                /*get the control and explicity convert it to a BunifuCheckbox type
                    * by casting it
                */
                BunifuCheckBox bunifuCheckbox = (BunifuCheckBox)ctrl;
                //assign Bunifu checkbox a `CheckStateChanged` event
                bunifuCheckbox.CheckStateChanged += BunifuCheckbox_CheckStateChanged;
            }

        }

    }
}
private void BunifuCheckbox_CheckStateChanged(object sender, BunifuCheckBox.CheckedChangedEventArgs e)
{
    throw new NotImplementedException();
}

```

{% endtab %}

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

```erlang
Option Infer On

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
	'Loop the panels in the FlowLayoutPanel
	For Each panel As Panel In flowLayoutPanel1.Controls
		'Loop each control in the panel
		For Each ctrl In panel.Controls
'            check whether a control is a Bunifu Checkbox and assign 
'                * each with a CheckStateChanged event
'                
			If TypeOf ctrl Is BunifuCheckBox Then
'                get the control and explicity convert it to a BunifuCheckbox type
'                    * by casting it
'                
				Dim bunifuCheckbox As BunifuCheckBox = CType(ctrl, BunifuCheckBox)
				'assign Bunifu checkbox a `CheckStateChanged` event

				bunifuCheckbox.CheckStateChanged += BunifuCheckbox_CheckStateChanged
			End If

		Next ctrl

	Next panel
End Sub

Private Sub BunifuCheckbox_CheckStateChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.CheckedChangedEventArgs)
	Throw New NotImplementedException()
End Sub


```

{% endtab %}
{% endtabs %}

**Step 6**: In the CheckStateChanged event handler method write the following code. We'll retrieve the selected Bunifu Checkbox and add a condition to determine if it is checked or unchecked.

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

```csharp
private void BunifuCheckbox_CheckStateChanged(object sender, BunifuCheckBox.CheckedChangedEventArgs e)
{
    try
    {
        //reference the Bunifu Checkbox object that has raised this event
        BunifuCheckBox c = (BunifuCheckBox)sender;
        //check the status of the checkbox
        if (e.CheckState == BunifuCheckBox.CheckStates.Checked)
        {
            /*add one value to Bunifu ProgressBar and display the checked task
                * in a Bunifu Snackbar
                */
            bunifuProgressBar1.Value+=1;
            //the second parameter in the Show method gets the text associated with the selected checkbox
            bunifuSnackbar1.Show(this, String.Format("Task '{0}' is now checked",c.BindingControl.Text), BunifuSnackbar.MessageTypes.Success, 2100,null,BunifuSnackbar.Positions.BottomCenter);
            tasksBunifuLabel.Text = String.Format("{0} out of 7 tasks are complete...", bunifuProgressBar1.Value);
        }
        else
        {
            /*subtract one value to Bunifu ProgressBar and display the unchecked task
            * in a Bunifu Snackbar
            */
            bunifuProgressBar1.Value-=1;
            tasksBunifuLabel.Text = String.Format("{0} out of 7 tasks are complete...", bunifuProgressBar1.Value);
            //the second parameter in the Show method gets the text associated with the selected checkbox
            bunifuSnackbar1.Show(this, String.Format("Task '{0}' is now unchecked", c.BindingControl.Text), BunifuSnackbar.MessageTypes.Success, 2100, null, BunifuSnackbar.Positions.BottomCenter);
        }

    }
    catch (Exception exception)
    {
        Console.WriteLine(exception.Message);
    }

  }

```

{% endtab %}

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

```erlang
Private Sub BunifuCheckbox_CheckStateChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.CheckedChangedEventArgs)
	Try
		'reference the Bunifu Checkbox object that has raised this event
		Dim c As BunifuCheckBox = DirectCast(sender, BunifuCheckBox)
		'check the status of the checkbox
		If e.CheckState = BunifuCheckBox.CheckStates.Checked Then
'            add one value to Bunifu ProgressBar and display the checked task
'                * in a Bunifu Snackbar
'                
			bunifuProgressBar1.Value+=1
			'the second parameter in the Show method gets the text associated with the selected checkbox
			bunifuSnackbar1.Show(Me, String.Format("Task '{0}' is now checked",c.BindingControl.Text), BunifuSnackbar.MessageTypes.Success, 2100,Nothing,BunifuSnackbar.Positions.BottomCenter)
			tasksBunifuLabel.Text = String.Format("{0} out of 7 tasks are complete...", bunifuProgressBar1.Value)
		Else
'            subtract one value to Bunifu ProgressBar and display the unchecked task
'            * in a Bunifu Snackbar
'            
			bunifuProgressBar1.Value-=1
			tasksBunifuLabel.Text = String.Format("{0} out of 7 tasks are complete...", bunifuProgressBar1.Value)
			'the second parameter in the Show method gets the text associated with the selected checkbox
			bunifuSnackbar1.Show(Me, String.Format("Task '{0}' is now unchecked", c.BindingControl.Text), BunifuSnackbar.MessageTypes.Success, 2100, Nothing, BunifuSnackbar.Positions.BottomCenter)
		End If

	Catch exception As Exception
		Console.WriteLine(exception.Message)
	End Try

End Sub

```

{% endtab %}
{% endtabs %}

The following output will be displayed as a result of the preceding code:

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdTkAQ0j0R07Fc4MKuT%2F-MdU86uZRLtlTGt87gu1%2Fcheckbox04.gif?alt=media\&token=17e12e8a-35f9-4ae4-ae9f-3c7627f03c19)

### Adding Bunifu Checkbox at run time

You can add a Bunifu Checkbox control during runtime. Simply navigate to your Form's Load event and add the following code snippet:

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

```csharp
using Bunifu.UI.WinForms;
private void Form4_Load(object sender, EventArgs e)
{
    //Create Bunifu Checkboxes
    BunifuCheckBox bunifuCheckbox1 = new BunifuCheckBox();
    BunifuCheckBox bunifuCheckbox2 = new BunifuCheckBox();
    BunifuCheckBox bunifuCheckbox3 = new BunifuCheckBox();
    //Create the labels
    BunifuLabel bunifuLabels1 = new BunifuLabel();
    BunifuLabel bunifuLabels2 = new BunifuLabel();
    BunifuLabel bunifuLabels3 = new BunifuLabel();
    //Bind the labels with the checkboxes
    bunifuCheckbox1.BindingControl = bunifuLabels1;
    bunifuCheckbox2.BindingControl = bunifuLabels2;
    bunifuCheckbox3.BindingControl = bunifuLabels3;
    //label the checkboxes
    bunifuCheckbox1.BindingControl.Text = "one";
    bunifuCheckbox2.BindingControl.Text = "two";
    bunifuCheckbox3.BindingControl.Text = "three";

    //Add Bunifu Checkboxes and Bunifu Labels to the layout panel
    FlowLayoutPanel flowLayoutPanel = new FlowLayoutPanel();
    flowLayoutPanel.Controls.AddRange(new Control[]
    {
        bunifuCheckbox1,
        bunifuLabels1,
        bunifuCheckbox2,
        bunifuLabels2,
        bunifuCheckbox3,              
        bunifuLabels3
    });
    flowLayoutPanel.FlowDirection = FlowDirection.LeftToRight;
    flowLayoutPanel.Location = new Point(250, 100);
           
    this.Controls.Add(flowLayoutPanel);


}
```

{% endtab %}

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

```erlang
Imports Bunifu.UI.WinForms
Private Sub Form4_Load(ByVal sender As Object, ByVal e As EventArgs)
	'Create Bunifu Checkboxes
	Dim bunifuCheckbox1 As New BunifuCheckBox()
	Dim bunifuCheckbox2 As New BunifuCheckBox()
	Dim bunifuCheckbox3 As New BunifuCheckBox()
	'Create the labels
	Dim bunifuLabels1 As New BunifuLabel()
	Dim bunifuLabels2 As New BunifuLabel()
	Dim bunifuLabels3 As New BunifuLabel()
	'Bind the labels with the checkboxes
	bunifuCheckbox1.BindingControl = bunifuLabels1
	bunifuCheckbox2.BindingControl = bunifuLabels2
	bunifuCheckbox3.BindingControl = bunifuLabels3
	'label the checkboxes
	bunifuCheckbox1.BindingControl.Text = "one"
	bunifuCheckbox2.BindingControl.Text = "two"
	bunifuCheckbox3.BindingControl.Text = "three"

	'Add Bunifu Checkboxes and Bunifu Labels to the layout panel
	Dim flowLayoutPanel As New FlowLayoutPanel()
	flowLayoutPanel.Controls.AddRange(New Control() { bunifuCheckbox1, bunifuLabels1, bunifuCheckbox2, bunifuLabels2, bunifuCheckbox3, bunifuLabels3 })
	flowLayoutPanel.FlowDirection = FlowDirection.LeftToRight
	flowLayoutPanel.Location = New Point(250, 100)

	Me.Controls.Add(flowLayoutPanel)


End Sub

```

{% endtab %}
{% endtabs %}

 

{% hint style="success" %}
Let's take a deep dive and get insights into the properties that are available on Bunifu Checkbox.
{% endhint %}

## The `OnCheck` state properties

With Bunifu CheckBox you can apply a number of properties to your checkbox when the checkbox state is **checked.** 

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdWr2pnCFxRyVL5jP6E%2F-MdWwviv4qM7ZI3dZFiQ%2Fimage.png?alt=media\&token=b95937cc-2f8a-4634-b20e-3d128b4f4ef6)

###  `1. BorderColor`

This property allows you to get or set the checkbox border color. It supports the use of HEX, RGB, and ARGB color formats.

### **`2. BorderRadius`**  

This property allows you to get the radius's integer value or set an integer value that makes a curve on the checkbox edges. By increasing the integer value, the checkbox edges become more curved.

### **`3. BorderThickness`**

This property allows you to get the thickness's integer value or set an integer value that sets width to the checkbox borders. The checkbox borders get increasingly thicker as you set a larger integer value.

### **`4. CheckBoxColor`** 

This property allows you to get the inner color value or set the checkbox's inner fill color. It supports the use of HEX, RGB, and ARGB color formats.

### **`5. CheckmarkColor`**

This property allows you to get the color value of the tick or define the checkbox's tick icon. It supports the use of HEX, RGB, and ARGB color formats.

### **`6. CheckmarkThickness`**

This property allows you to get the thickness integer value of the checkbox tick set an integer value that determines the thickness of the tick icon in the checkbox control.

### **`7. UseBorderThicknessForCheckmark`**

This property allows you to get the property's boolean value or set a bool value(i.e. true or false), which when set to true, will apply the value specified in the `BorderThickness` property to be applied to both the checkbox border its tick icon concurrently.

## `OnUncheck` state property

You can customize Bunifu CheckBox when its state is unchecked:

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdX7i3qDVSvGXP7viYx%2F-MdX8-ltetjzb3o3RUZ5%2Fimage.png?alt=media\&token=40246ae5-a657-4f44-931d-75d4e9a3845d)

Here is a discussion of the applicable properties:

### **`1. BorderColor`**

This property allows you to get or set the checkbox border color. It supports the use of HEX, RGB, and ARGB color formats.

### **`2. BorderRadius`**

This property allows you to get the radius's integer value or set an integer value that makes a curve on the checkbox edges. By increasing the integer value, the checkbox edges become more curved.

### **`3. BorderThickness`**

This property allows you to get the thickness's integer value or set an integer value that sets width to the checkbox borders. The checkbox borders get increasingly thicker as you set a larger integer value.

### **`4. CheckBoxColor`** 

This property allows you to get the inner color value or set the checkbox's inner fill color. It supports the use of HEX, RGB, and ARGB color formats.

## **`OnDisable` state property**

The disabled state properties of Bunifu Checkbox can be easily accessed on the OnDisable category in the properties pane.

![](https://1116551356-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M7fmEPVv4n0I819sdaz%2F-MdX7i3qDVSvGXP7viYx%2F-MdXAw-WrAm-vKMCE_ea%2Fimage.png?alt=media\&token=ad3a2c4a-71f7-45b9-a8b4-49bbfd7dfa1d)

 Below is a description of the properties in an OnDisable state:

### `1. BorderColor`

This property allows you to get or set the checkbox border color. It supports the use of HEX, RGB, and ARGB color formats.

### **`2. BorderRadius`**  

This property allows you to get the radius's integer value or set an integer value that makes a curve on the checkbox edges. By increasing the integer value, the checkbox edges become more curved.

### **`3. BorderThickness`**

This property allows you to get the thickness's integer value or set an integer value that sets width to the checkbox borders. The checkbox borders get increasingly thicker as you set a larger integer value.

### **`4. CheckBoxColor`** 

This property allows you to get the inner color value or set the checkbox's inner fill color. It supports the use of HEX, RGB, and ARGB color formats.

### **`5. CheckmarkColor`**

This property allows you to get the color value of the tick or define the checkbox's tick icon. It supports the use of HEX, RGB, and ARGB color formats.

### **`6. CheckmarkThickness`**

This property allows you to get the thickness integer value of the checkbox tick set an integer value that determines the thickness of the tick icon in the checkbox control.

### **`7. UseBorderThicknessForCheckmark`**

This property allows you to get the property's boolean value or set a bool value(i.e. true or false), which when set to true, will apply the value specified in the `BorderThickness` property to be applied to both the checkbox border its tick icon concurrently.

## `OnHoverUnchecked`state property 

Similarly, you can customize further the appearance of Bunifu CheckBox when it is **hovered** and the checkbox state is **unchecked**. Below are available properties:

###  `1. BorderColor`

This property allows you to get or set the checkbox border color. It supports the use of HEX, RGB, and ARGB color formats.

### **`2. BorderRadius`**  

This property allows you to get the radius's integer value or set an integer value that makes a curve on the checkbox edges. By increasing the integer value, the checkbox edges become more curved.

### **`3. BorderThickness`**

This property allows you to get the thickness's integer value or set an integer value that sets width to the checkbox borders. The checkbox borders get increasingly thicker as you set a larger integer value.

### **`4. CheckBoxColor`** 

This property allows you to get the inner color value or set the checkbox's inner fill color. It supports the use of HEX, RGB, and ARGB color formats.

### **`5. CheckmarkColor`**

This property allows you to get the color value of the tick or define the checkbox's tick icon. It supports the use of HEX, RGB, and ARGB color formats.

### **`6. CheckmarkThickness`**

This property allows you to get the thickness integer value of the checkbox tick set an integer value that determines the thickness of the tick icon in the checkbox control.

### **`7. UseBorderThicknessForCheckmark`**

This property allows you to get the property's boolean value or set a bool value(i.e. true or false), which when set to true, will apply the value specified in the `BorderThickness` property to be applied to both the checkbox border its tick icon concurrently.

## Additional properties

###  **`ToolTip`**

This property allows you to get or set tooltip text that will be displayed when the checkbox is hovered.

###  **`AllowOnHoverStates`**

This property allows you to get the property's boolean value or set a bool value (i.e. true or false), which when checked to true, allows the OnHoverChecked and OnHoverUnchecked states to be active at runtime.  The default value is **true**.

## Animation property

### **`1. AllowCheckBoxAnimation`** 

This property allows you to get the property's boolean value or set a boolean value that, when set to true, causes a bouncy animation to occur during runtime check-state changes.

### `2. AllowCheckmarkAnimation`

This property enables you to get the property's boolean value or set a boolean value that, when set to true, triggers a tick animation during the`OnCheck` state event.

### **`3. AllowBindingControlAnimation`**

This property allows you to get the property's boolean value or set a boolean value (i.e either true or false) which when set to true, causes the bound control to bouncy effect during runtime check-state changes.

{% hint style="info" %}
`AllowCheckBoxAnimation` must be set to **true** for this property to work.
{% endhint %}

## Binding properties

### **`1. BindingControl`** 

This property allows you to get the bound control or set the control to bind specifically with the CheckBox. Generally, it is advised that we bind a label with the checkbox. 

{% hint style="info" %}
You may bind any other acceptable control (e.g. panels, labels, picture boxes, or user controls) as long as they are not the checkbox's parent.
{% endhint %}

### **`2. BindingControlPosition`** 

This property allows you to get the property's value or set the bound control position (i.e left or right).

{% hint style="info" %}
If we want to adjust the **spacing** between the checkbox and its bound control, we can do so by using the **Margin** property. If the control is bound to the left, use the **left** property; if it is bound to the right, use the **right** property.
{% endhint %}

### **`3. AllowBindingControlLocation`** 

This property allows you to get the property's boolean value or set a bool value that when set to true, causes the control bound to the checkbox will adjust its position automatically whenever the checkbox’s location changes

### `4.  AllowBindingControlColorChanges`

This property allows you to get the property's bool value or set a boolean value that when set to true, causes the control bound to the checkbox to be colored during the checkbox's state changes (i.e. the bound control will be colored with colors set on `OnCheck`, `OnUncheck`, `OnHoverChecked`, `OnHoverUnchecked` and `onDisabled` states).

## Bunifu Checkbox Events

### **`1. CheckedChanged`** 

This event occurs whenever the Checked property is changed. The sample code below listens to the check-state changes in the CheckBox.

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

```csharp
private void bunifuCheckBox1_CheckedChanged(object sender, BunifuCheckBox.CheckedChangedEventArgs e)
{
    if (e.Checked)
    {
        MessageBox.Show("Changed to a Checked state");
    }
    else
    {
        MessageBox.Show("Changed to an UnChecked state");
    }
}
```

{% endtab %}

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

```erlang
Private Sub bunifuCheckBox1_CheckedChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.CheckedChangedEventArgs)
	If e.Checked Then
		MessageBox.Show("Changed to a Checked state")
	Else
		MessageBox.Show("Changed to an UnChecked state")
	End If
End Sub

```

{% endtab %}
{% endtabs %}

###  2. **`CheckStateChanged`** 

This event is triggered whenever the check state of a Bunifu checkbox changes. The following code monitors changes in the CheckBox's check-state:

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

```csharp
private void bunifuCheckBox1_CheckStateChanged(object sender, BunifuCheckBox.CheckedChangedEventArgs e)
{
    if (e.CheckState == BunifuCheckBox.CheckStates.Checked)
    {
        MessageBox.Show("Check state changed to Checked");
    }
    else if (e.CheckState == BunifuCheckBox.CheckStates.Unchecked)
    {
        MessageBox.Show("Check state changed to Unchecked");
    }
    else
    {
        MessageBox.Show(" Check state is indeterminate");
    }
}
```

{% endtab %}

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

```erlang
Private Sub bunifuCheckBox1_CheckStateChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.CheckedChangedEventArgs)
	If e.CheckState = BunifuCheckBox.CheckStates.Checked Then
		MessageBox.Show("Check state changed to Checked")
	ElseIf e.CheckState = BunifuCheckBox.CheckStates.Unchecked Then
		MessageBox.Show("Check state changed to Unchecked")
	Else
		MessageBox.Show(" Check state is indeterminate")
	End If
End Sub

```

{% endtab %}
{% endtabs %}

### **`3. BindingControlPositionChanged`** 

This event is triggered anytime the bound control's position changes. The sample code below listens to CheckBox's bound control position changes.

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

```csharp
private void bunifuCheckBox1_BindingControlPositionChanged(object sender, BunifuCheckBox.PositionChangedEventArgs e)
{
    if (e.BindingControlPosition == BunifuCheckBox.BindingControlPositions.Left)
    {
        MessageBox.Show("binding position is set to the left position");
    }
    else
    {
        MessageBox.Show("binding position is set to the right position");
    }
}
```

{% endtab %}

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

```erlang
Private Sub bunifuCheckBox1_BindingControlPositionChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.PositionChangedEventArgs)
	If e.BindingControlPosition = BunifuCheckBox.BindingControlPositions.Left Then
		MessageBox.Show("binding position is set to the left position")
	Else
		MessageBox.Show("binding position is set to the right position")
	End If
End Sub

```

{% endtab %}
{% endtabs %}

### `4. BindingControlChanged`

This event occurs when the checkbox is bound to a different control during runtime. The sample code below listens to the check-state changes in the CheckBox.

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

```csharp
private void bunifuCheckBox1_BindingControlChanged(object sender, BunifuCheckBox.BindingControlChangedEventArgs e)
{
    MessageBox.Show("Bound control has changed");
}
```

{% endtab %}

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

```erlang
Private Sub bunifuCheckBox1_BindingControlChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.BindingControlChangedEventArgs)
	MessageBox.Show("Bound control has changed")
End Sub

```

{% endtab %}
{% endtabs %}

### `5. StatePropertiesChanged`

This event is triggered whenever there is a property change in a current state of a checkbox. The following code below executes to a current state of a checkbox and listens for any property changes within that state

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

```csharp
private void bunifuCheckBox1_StatePropertiesChanged(object sender, BunifuCheckBox.StatePropertiesChangedEventArgs e)
{
    //get the checkbox color when the checkbox is unchecked
    if (bunifuCheckBox1.CheckState == BunifuCheckBox.CheckStates.Unchecked)
    {
        MessageBox.Show(e.CurrentState.CheckBoxColor.Name);
    }
}
```

{% endtab %}

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

```erlang
Private Sub bunifuCheckBox1_StatePropertiesChanged(ByVal sender As Object, ByVal e As BunifuCheckBox.StatePropertiesChangedEventArgs)
	'get the checkbox color when the checkbox is unchecked
	If bunifuCheckBox1.CheckState = BunifuCheckBox.CheckStates.Unchecked Then
		MessageBox.Show(e.CurrentState.CheckBoxColor.Name)
	End If
End Sub

```

{% endtab %}
{% endtabs %}

\
Take Away
---------

It's our hope you will enjoy Bunifu CheckBox and that it will help you create a better user experience for your users. Should you have feedback or suggestions please send us via chat on the bottom right corner of the screen.