c#学习笔记：CheckedListBox控件的用法

一、常用属性

---

（1）、CheckOnClick属性

CheckOnClick属性是布尔类型的值，如果为True，那么单击条目就能将条目勾选；如果为false，则要双击条目才能将其勾选。

2）ColumnWidth属性

ColumnWitdh属性是整型数据，表示多列条目各列的列宽。该属性只有在MultiColumn属性（允许多列显示）设置为true时才有意义。

（3）MultiColumn属性

MultiColumn属性是布尔类型的值，指示是否开启多列显示条目。该属性是配合ColumnWidth属性一起使用。

（4）SelectMode属性

该属性指示列表将是单选还是多选，这里的“选”表示选中而不是“勾选”，选中后条目会高亮，但条目左边的小方框不会勾选。在CheckedLIstBox控件中，不支持多项选择，该属性只有两个值是有效的，分别是None和One。None表示条目不能被选中，左边的小方框也不能被勾选；One表示只有一个条目可以被选中（但勾选可以选多项）。

（5）Sorted属性

该属性是布尔累心的值，如果为true，则条目会根据字母进行排序，如果为false，则不进行排序。

（6）Count属性

该属性表示列表中条目的总量。用法如下：

int conut=checkedListBox1.Items.Count

（7）Items属性

获取列表中条目的集合，通过下标获取指定条目。

object item=checkedListBox1.Items[i];

（8）SelectedItem属性和SelectedItems属性

SelectedItem属性作用是获取选中的条目，而SelectedItems属性是一个数组，保存着被选中的条目的集合，可通过下标来获取条目。用法如下：

object item =checkedListBox1.SelectedItem;

object item=checkedListBox1.SelectedItems[i];

checkedListBox1.Items.Add(item);

---

二、常用方法

---

（1）Add方法

该方法用于动态添加条目。用法如下：

checkedListBox1.Items.Add（“条目一”）；//参数可以是一个字符串或者是一个条目

或checkedListBox1.Items.Add（“条目一”，true）；//第二个参数是布尔类型的，指示是否让条目被勾选

（2）RemoveAt方法

该方法用于移除指定的条目，参数是条目的索引值。用法如下：

checkedListBox1.Items.RemoveAt(1)。

（3）Insert方法

该方法的作用是在指定位置插入一个条目，有两个参数，分别是index和item。index是条目的索引，item可以是一个条目，也可以是一个字符窜。其用法如下：

checkedListBox1.Items.Insert(i,“条目一”)；

（4）GetItemChecked方法

该方法返回第i项条目是否被勾选（不是选中），如果是则返回true,否则为false。参数是条目的索引值。其用法如下：

bool isChecked=checkedListBox1.GetItemChecked(i)；

（5）SetItemChecked方法

设置第i项条目是否被选中，参数有两个，第一个是索引，第二个是布尔值。第二个参数如果选true，则将第i项设置为勾选，否则设置为不勾选。其用法如下：

checkedListBox1.SetItemChecked（i，true）；

（6）Clear方法

该方法的作用是清除所有的条目。其用法如下：

checkedListBox1.Clear（）；

三、常用事件
（1）ItemCheck事件

当条目被勾选时发生，其用法如下：

    private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e)
     {
         //通过索引引用勾选的条目
         textBox1.Text = textBox1.Text +"\r\n"+ checkedListBox1.Items[e.Index].ToString();
     }

（2）SelectedIndexChanged和SelectedValuedChanged事件

这两个事件都是在条目被选中时发生（不一定被勾选）
**

四、应用实例

**
1、初次接触CheckedListBox控件一般认为：foreach (object obj in checkedListBox1.SelectedItems)即可遍历选中的值。其实这里遍历的只是高亮的值并不是打勾的值。遍历打勾的值要用下面的代码：

for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
    if (checkedListBox1.GetItemChecked(i))
    {
        MessageBox.Show(checkedListBox1.GetItemText(checkedListBox1.Items[i]));
    }
}

2、添加项

checkedListBox1.Items.Add("蓝色");
checkedListBox1.Items.Add("红色");
checkedListBox1.Items.Add("黄色");

3、判断第i项是否选中,选中为true,否则为false

if（checkedListBox1.GetItemChecked(i)）
{
     return true;
}
else
{
     return false;
}

4、设置第i项是否选中

checkedListBox1.SetItemChecked(i, true);  //true改为false为没有选中。

5、设置全选，添加一个名为select_all的checkbox控件，由其控制checkedListBox是全选还是全不选

private void select_all_CheckedChanged(object sender, EventArgs e)
{
    if(select_all.Checked)
	{
	          for (int j = 0; j < checkedListBox1.Items.Count; j++)
	               checkedListBox1.SetItemChecked(j, true);
	}
	else
	{
	for (int j =0; j < checkedListBox1.Items.Count; j++)
	      checkedListBox1.SetItemChecked(j, false);
	}
}

6、得到全部选中的值 ，并将选中的项的文本组合成为一个字符串

string strCollected = string.Empty;
for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
      if (checkedListBox1.GetItemChecked(i))
      {
          if (strCollected == string.Empty)
          {
               strCollected = checkedListBox1.GetItemText(checkedListBox1.Items[i]);
          }
          else
          {
               strCollected = strCollected + "/" + checkedListBox1.GetItemText(checkedListBox1.Items[i]);
          }
      }
}

7、设置CheckedListBox中第i项的Checked状态

方法1：
checkedListBox1.SetItemCheckState(i, CheckState.Checked);

方法2：
for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
	if (checkedListBox1.GetSelected(i))
	{
	MessageBox.Show(checkedListBox1.CheckedItems.ToString());
	}
}


方法3：
private void checkBoxAll_CheckedChanged(object sender, EventArgs e)
{
     if (checkBoxAll.Checked)
     {
        //被选择了则将CheckedListBox中的所有条目都变为Checked状态
        for (int i = 0; i < checkedListBoxLayerControl.Items.Count; i++)
        {    
			checkedListBoxLayerControl.SetItemCheckState(i, CheckState.Checked);
		}
	}
	else
	{
	     //否则变成Unchecked状态
	    for (int i = 0; i < checkedListBoxLayerControl.Items.Count; i++)
		{
			checkedListBoxLayerControl.SetItemCheckState(i, CheckState.Unchecked);
		}             
	}
}

8、checkedListBox 单选设置(代码实现)

private void chkl_ItemAuditing_ItemCheck(object sender, ItemCheckEventArgs e)
{
    if (chkl_ItemAuditing.CheckedItems.Count > 0)
    {
         for (int i = 0; i < chkl_ItemAuditing.Items.Count; i++)
         {
			if (i != e.Index)
			{
				this.chkl_ItemAuditing.SetItemCheckState(i,
				System.Windows.Forms.CheckState.Unchecked);
			}
		 }
	 }
}

9、checkedListBox1显示一个数据库中关键字对应的所有记录

for (int i = 0; i < table.Rows.Count; i++)
{
    string name = table.Rows["myname"].ToString();
    string paw = table.Rows["mypaw"].ToString();
    checkedListBox1.Items.Add(name + paw);
}

10、根据名设置选中

for(i=0;i<CheckedListBox.Items.Count;i++)  
{  
    if(CheckedListBox.GetItemText(CheckedListBox.Items)=="你得到的值")  
	{  
	      CheckedListBox.SetItemChecked(i,true);  
	}  
}

11、清除checkedListBox1中所有的选项

for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
    checkedListBox1.Items.Clear();
}

12、设置索引为index的项为选中状态

for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
    checkedListBox1.SetItemChecked(i, true);
}

13、选中checkedListBox1所有的选项

方法1：
for (int i = 0; i < checkedListBox1.Items.Count; i++)        
{
checkedListBox1.SetItemCheckState(i, CheckState.Checked);
}

方法2：
for (int i = 0; i < checkedListBox1.Items.Count; i++)
{ 
	//如果checkedListBox1的第i项被选中，则显示checkedListBox1对应的值
	if (checkedListBox1.GetItemChecked(i))
	{
	     MessageBox.Show(checkedListBox1.Items.ToString());
	}
}

14、反向选择checkedListBox1的选项

for (int i = 0; i < checkedListBox1.Items.Count; i++)
{
    if (checkedListBox1.GetItemChecked(i))
   {
       checkedListBox1.SetItemChecked(i, false);
   }
   else
   {
       checkedListBox1.SetItemChecked(i, true);
   }
}

15、checkedListBox1中选定的项->checkedListBox2

for (int i = 0; i < checkedListBox1.CheckedItems.Count; i++)
{
    checkedListBox2.Items.Add(this.checkedListBox1.CheckedItems);
	//remove是除去一个具体的值，不是index，注意了
    this.checkedListBox1.Items.Remove(this.checkedListBox1.CheckedItems);      
}