2024年5月6日发(作者：)

C#2010 ListBox和CheckedListBox控件

ListBox控件和CheckedListBox控件是两个相互关联的控件，ListBox控件表示

用于显示列表的Windows控件，其可显示一组列表项供用户单击；CheckedListBox

控件显示一个ListBox控件，并为每个列表项目提供一个复选框，供用户选择。

ListBox控件和CheckedListBox控件的属性和方法基本相同，其主要包含以下

几种属性，如表8-15所示。

表8-15 ListBox控件和CheckedListBox控件的属性

属性

AllowSelection

BackgroundImageL

ayout

ColumnWidth

CustomTabOffsets

HorizontalExtent

Items

MultiColumn

SelectedIndex

SelectedIndices

SelectedItem

SelectedItems

SelectedValue

SelectionMode

获取或设置多列ListBox中列的宽度

获取ListBox中的项之间的制表符宽度

获取或设置ListBox的水平滚动条可滚动的宽度

获取ListBox的项

获取或设置一个值，指示ListBox是否支持多列

这个值表示列表框中选中选项基于0的索引。如果列表框可以一次选择多

个选项，那么这个属性就包含选中列表中的第一个选项。

该属性是一个集合，包含列表框中选中选项的所有基于0的索引

在只能选择一个选项的列表框中，这个属性包含选中的选项。在可以选择

多个选项的列表框中，这个属性包含选中选项中的第一个选项

获取包含ListBox中当前选定项的集合

获取或设置由ValueMember属性指定的成员属性的值

该属性用于设置列表框的选择模式，可以使用4种选项模式：

（1）None 不能选择任何选项

（2）One 一次只能选择一个选项

（3）MultiSimple 可以选择多个选项

（4）MultiExtended 可以选择多个选项，用户还可以使用Ctrl、Shift和箭

头进行选择

Sorted

Text

如果这个属性设置为true，那么会使列表框对它包含的选项按照字母顺序

排序

许多控件都有Text属性，但这里Text属性与其他控件的Text属性大不相

同。如果设置列表框控件的Text属性，它将搜索匹配该文本的选项，并选

择该选项。如果获取Text属性，将返回列表中第一个选中的选项。如果S

说明

获取一个值，指示ListBox当前是否启用了列表项选择功能

按照ImageLayout枚举中的定义获取或设置ListBox的背景图像布局

electedMode属性设置为false，则不能使用这个属性

CheckedListBox控件由于可以实现复选功能，因此和复选框类似，其具有以下

4种独特的属性，如表8-16所示。

表8-16 CheckedListBox控件的属性

属性

CheckedIndices

CheckedItems

CheckOnClick

ThreeDCheckBoxes

说明

返回控件中被选中的元素的索引号集合

返回控件中项的集合

获取或设置一个值，该值指示当选定项时是否应切换复选框

获取或设置一个值，该值指示复选框是否有Flat或Normal的

State属性

ListBox控件和CheckedListBox控件具有大量继承自ButtonBase类的公用方法，

如表8-17所示。

表8-17 ListBox控件和CheckedListBox控件的方法

方法

ClearSelected

FindString

GetSelected

SetSelected

ToString

说明

该方法用于清除列表框中的所有选项

该方法用于查找列表框中第一个以指定字符开头的字符串

该方法用于返回一个表示是否选择一个选项的值

该方法用于设置或清除选项

该方法用于返回当前选中的选项

通常情况下，在处理ListBox和CheckedListBox控件时，使用的事件都与选中

的选项有关，如表8-18所示。

表8-18 ListBox和CheckedListBox控件的常用事件

事件

SelectedValueChanged

SelectedIndexChanged

ItemCheck

作用

当SelectedValue属性被更改时发生

当SelectedIndex属性被更改时发生

当某项的选中状态被更改时发生（仅用于CheckedListBox控件）