一、常用属性
(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);
}