一、常用属性、方法和事件
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); } }
然后,在CheckedBox的属性栏中,将所有的CheckedBox的CheckedChanged事件处理方法都选为CheckedChanged,这样的话,多个复选框就可以共用一个事件处理方法了。如图:
(2)checkedListBox1的ItemCheck事件
4.实现代码
总结
到此这篇关于C#中CheckedListBox控件用法的文章就介绍到这了,更多相关C# CheckedListBox控件用法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!