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

创作时间:

作者:

@小白创作中心

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

引用

CSDN

https://blog.csdn.net/qq_30387863/article/details/138668683

在C# WinForm开发中，CheckedListBox控件是一个非常实用的组件，它结合了列表框和复选框的功能，允许用户选择多个项目并进行复选操作。本文将详细介绍CheckedListBox控件的常用属性、方法和事件，帮助开发者更好地掌握这一控件的使用方法。

1. 简介

CheckedListBox控件类似于ListBox，提供项的列表，区别在于每个项前面都有一个复选框，允许用户进行复选操作。

2. 常用属性

属性	解释
Name	控件ID，在代码里引用的时候会用到，一般以 ckl 开头
BackColor	背景颜色
BorderStyle	边框样式：无、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	某项的选中状态要更改时触发的事件