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

article/2025/10/28 1:38:41

一、常用属性、方法和事件

1.常用属性

（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);

2.常用方法

（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（）；

3.常用事件

（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.实例描述

使用CheckedBox和CheckedListBox实现如下图所示的功能：点击勾选坐标的复选框，游边的CheckedLIstBox中就会添加一个条目，并且条目是多列显示。点击勾选右边的CheckedLIstBox中的条目，就会将条目的内容显示在下方的文本框中。

2.属性设置

在属性栏中，将checkedListBox1的MultiColumn属性设为true，以实现条目的多列显示；

3.事件处理

（1）checkedBox1的CheckedChanged事件

首先，自定义一个方法用来处理checkedBox1的CheckedChanged事件：

private void CheckedChanged(object sender,EventArgs e)
{

CheckBox cb = (CheckBox)sender;//sender是被勾选的CheckedBox,引用之前先强制转换为CheckedBox类型
if (cb.Checked)
{
checkedListBox1.Items.Add(cb.Text);

}
}