CheckedListBox and Binding Object Properties to Items

Question

I'm curious if there is a simple way to bind properties of a class to individual items of a CheckedListBox. There are several components out there (Telerik/DevExpress) that provide PropertyEditor grids, but I'm looking to do it in a CheckedListBox.

IE:

public class MyItem
{
    public bool Property1
    {
        get;
        set;
    }

    public bool Property2
    {
        get;
        set;
    }

    public bool Property3
    {
        get;
        set;
    }
}

And when adding items to the CheckedListBox, I'd like to have some sort of method that lets me do:

this.AddCheckListBoxItem("Property A", this.myItem.Property1);
this.AddCheckListBoxItem("Property B", this.myItem.Property2);
this.AddCheckListBoxItem("Property C", this.myItem.Property3);

the first parameter being the display name within the CheckedListBox.

Then throughout any changes to the checkstate, the bool values would automatically be updated without further code.

mservidio · Accepted Answer

I've created a solution using reflection as suggested by @Jethro. I used generics in the class definition, but I didn't implement anything that uses them yet. To summarize, basically using reflection, I've bound a single object and it's boolean properties to individual items within a standard CheckedListBox. It's nice as it doesn't require having to code to set the property values and get them when saving data, as the reflection takes care of this.

I created a Form, and added a CheckedListBox to it, and a button. Here's the code side.

using System;
using System.Linq;
using System.Reflection;
using System.Windows.Forms;

/// 
/// The main form.
/// 
public partial class Form1 : Form
{
    /// 
    /// The checked list box property helper.
    /// 
    private CheckedListBoxPropertyHelper helper;

    /// 
    /// My object to bind to the checked list box.
    /// 
    private MyItem myObjectDataSource;

    /// 
    /// Initializes a new instance of the  class.
    /// 
    public Form1()
    {
        this.InitializeComponent();

        this.myObjectDataSource = new MyItem();
        this.helper = new CheckedListBoxPropertyHelper(this.checkedListBox1, this.myObjectDataSource, true);

        this.helper.AddCheckListBoxItem(new CheckedPropertyItem("Property One", "Property1"));
        this.helper.AddCheckListBoxItem(new CheckedPropertyItem("Property Two", "Property2"));
        this.helper.AddCheckListBoxItem(new CheckedPropertyItem("Property Three", "Property3"));
    }

    /// 
    /// Handles the Click event of the Button1 control.
    /// 
    /// The source of the event.
    /// The  instance containing the event data.
    private void Button1_Click(object sender, EventArgs e)
    {
        // In the constructor
        // if we instantiated: this.helper = new CheckedListBoxPropertyHelper(this.checkedListBox1, this.myObjectDataSource, true);
        // as: this.helper = new CheckedListBoxPropertyHelper(this.checkedListBox1, this.myObjectDataSource, false);
        // changing the last bindImmediate property to false, the changes to the checkboxes wouldn't take effect immediately
        // on the underlying object, you need to call this.helper.CommitChanges() at which point the changes
        // will be made to the datasource object.

        // this.helper.CommitChanges();

        Console.WriteLine(this.myObjectDataSource.Property1.ToString());
        Console.WriteLine(this.myObjectDataSource.Property2.ToString());
        Console.WriteLine(this.myObjectDataSource.Property3.ToString());
    }
}

/// 
/// My item.
/// 
public class MyItem
{
    /// 
    /// Gets or sets a value indicating whether this  is property1.
    /// 
    /// true if property1; otherwise, false.
    public bool Property1
    {
        get;
        set;
    }

    /// 
    /// Gets or sets a value indicating whether this  is property2.
    /// 
    /// true if property2; otherwise, false.
    public bool Property2
    {
        get;
        set;
    }

    /// 
    /// Gets or sets a value indicating whether this  is property3.
    /// 
    /// true if property3; otherwise, false.
    public bool Property3
    {
        get;
        set;
    }
}

/// 
/// The checked list box property helper. This binds datasource properties to checkedlistbox items.
/// 
public class CheckedListBoxPropertyHelper where T : class
{
    /// 
    /// The checked list box.
    /// 
    private CheckedListBox checkedListBox;

    /// 
    /// The property info.
    /// 
    private PropertyInfo[] PropertyInfo;

    /// 
    /// Initializes a new instance of the  class.
    /// 
    /// The checked list box.
    /// The data source.
    /// if set to true [bind immediate].
    public CheckedListBoxPropertyHelper(CheckedListBox checkedListBox, T dataSource, bool bindImmediate)
    {
        this.checkedListBox = checkedListBox;
        this.DataSource = dataSource;
        this.PropertyInfo = this.DataSource.GetType().GetProperties();
        this.BindImmediate = bindImmediate;
        this.checkedListBox.ItemCheck += new ItemCheckEventHandler(CheckedListBox_ItemCheck);
    }

    /// 
    /// The data source.
    /// 
    public T DataSource
    {
        get;
        private set;
    }

    /// 
    /// Gets or sets a value indicating whether to [bind immediately] to the datasource object.
    /// 
    /// true if [bind immediately]; otherwise, false.
    public bool BindImmediate
    {
        get;
        set;
    }

    /// 
    /// Commits the changes.
    /// 
    public void CommitChanges()
    {
        if (!this.BindImmediate)
        {
            for (int i = 0; i < this.checkedListBox.Items.Count; i++)
            {
                CheckedPropertyItem checkedItem = this.checkedListBox.Items[i] as CheckedPropertyItem;
                this.SetChecked(this.checkedListBox.GetItemChecked(i), checkedItem);
            }
        }
        else
        {
            throw new InvalidOperationException("You cannot commit changes when bind immediate is on.");
        }
    }

    /// 
    /// Adds the check list box item.
    /// 
    /// The item.
    public void AddCheckListBoxItem(CheckedPropertyItem item)
    {
        PropertyInfo info = this.GetPropertyInfo(item.PropertyName);
        bool isChecked = false;

        if (info != null)
        {
            isChecked = (bool)info.GetValue(this.DataSource, null);
        }

        this.checkedListBox.Items.Add(item, isChecked);
    }

    /// 
    /// Handles the ItemCheck event of the CheckedListBox control.
    /// 
    /// The source of the event.
    /// The  instance containing the event data.
    private void CheckedListBox_ItemCheck(object sender, ItemCheckEventArgs e)
    {
        if (BindImmediate)
        {
            CheckedListBox clb = sender as CheckedListBox;
            CheckedPropertyItem checkedItem = clb.Items[e.Index] as CheckedPropertyItem;

            this.SetChecked(
                e.NewValue == CheckState.Checked ? true : false,
                 checkedItem);
        }
    }

    /// 
    /// Sets the checked.
    /// 
    /// if set to true [is checked].
    /// The CLB.
    private void SetChecked(bool isChecked, CheckedPropertyItem item)
    {
        PropertyInfo info = this.GetPropertyInfo(item.PropertyName);

        if (info.CanWrite)
        {
            info.SetValue(this.DataSource, isChecked, null);
        }
    }

    /// 
    /// Gets the property info.
    /// 
    /// Name of the property.
    /// 
    private PropertyInfo GetPropertyInfo(string propertyName)
    {
        return this.PropertyInfo
            .Where(c => c.Name == propertyName)
            .SingleOrDefault();
    }
}

/// 
/// Checked Property Item binding.
/// 
public class CheckedPropertyItem
{
    /// 
    /// Initializes a new instance of the  class.
    /// 
    /// The title.
    /// Name of the property.
    public CheckedPropertyItem(string title, string propertyName)
    {
        this.Title = title;
        this.PropertyName = propertyName;
    }

    /// 
    /// Gets or sets the title.
    /// 
    /// The title.
    public string Title
    {
        get;
        private set;
    }

    /// 
    /// Gets the name of the property.
    /// 
    public string PropertyName
    {
        get;
        private set;
    }

    /// 
    /// Returns a  that represents this instance.
    /// 
    /// A  that represents this instance.
    public override string ToString()
    {
        return this.Title;
    }
}

CheckedListBox and Binding Object Properties to Items

Answers (2)

Related Questions