C# WinForm —— 14 CheckedListBox 复选列表框介绍

1. 简介

类似 ListBox，提供项的列表，区别就是 CheckedListBox 每一个项前面有个复选框

2. 常用属性

属性	解释
(Name)	控件ID，在代码里引用的时候会用到,一般以 ckl 开头
BackColor	背景颜色
BoderStyle	边框样式：无、FixedSingle、Fixed3D
MultiColumn	是否允许多列显示，默认是false
ColumnWidth	多列ListBox中各列的宽度，默认值是0，不是以多列显示的
Dock	CheckedListBox在当前容器中的位置是靠上、靠下、靠左、靠右、还是全填充
ForeColor	前景色，显示文本
Items	项的集合，和listBox， ComboBox类似
ScrollAlwaysVisible	是否始终显示滚动条，而不管列表框中有多少项
SelectionMode	项的选择模式，是单项选择、简单多项选择、扩展多项选择，还是不可选择。和listBox类似。SelectionMode.MultiExtended 表示允许选择多项，但选中的条目必定相连(相邻)，鼠标当选中一项后，按 键盘↑↓可以选定一个范围的选项，但选项不能间隔选中。SelectionMode.MultiSimple 表示允许选择多项，可以任意选中多个条目，点一下可以选中一条项目，重复点一下即取消。
SelectedItems
CheckedItems	表示勾选的项的集合；
CheckedIndices	表示勾选的多项的索引值集合；
CheckOnClick	指示复选框是否应在首次单击某项时切换。选中和勾选是不一样的。选中了不一定勾选，勾选了也不一定选中，勾选是指勾选前面的复选框。当该属性值设置为true时，选中某一项时 就会 勾选/取消勾选 该项。
Sorted	是否对列表进行排序
ThreeDCheckBoxes	复选框的ButtonState是Flat还是Normal
DataSource	指示此控件将用来获取其项的列表，它的数据通常是一个DataTable, 或者是一个List，dictionary，通常通过一个中间绑定控件BoundingSource进行数据转换，如果指定数据源的话，要设置DisplayMember属性值和ValueMember属性值。 虽然在属性面板中找不到这个选项，但这个属性也是存在的。
DisplayMember	列表项中显示的文本信息
ValueMember	项的实际值

3. Items方法 和 绑定数据源

和listBox类似

cklList.Items.Clear();
cklList.Items.Add(1);
cklList.Items.Add("aaa");
cklList.Items.AddRange(new string[] {"aaa", "bbb", "ccc"});
cklList.Items.Insert(2, "ddd");
cklList.Items.Remove("ddd");
cklList.Items.RemoveAt(2); // 移除第3项

指定数据源方式添加项，也和ListBox类似（C# WinForm —— 12 ListBox绑定数据）：

4. 事件

常用事件	解释
SelectedIndexChanged	所选中的项的索引值发生改变时，所做的操作。
SelectedValueChanged	所选中的项的值发生改变时，所做的操作。
ItemCheck	某项的选中状态要更改时触发的事件

参考：2023年C#之WinForm零基础教程50讲