C#CheckedListBox控件用法详解(属性、方法、事件)

在 C# 的 Windows 窗体应用程序开发中，CheckedListBox 控件是一个非常实用的组件，它结合了 ListBox 和 CheckBox 的功能，允许用户从多个选项中选择一个或多个项目。通过勾选操作，用户可以轻松地对列表中的项进行多选和状态管理。

为了更好地使用 CheckedListBox 控件，开发者需要了解其常用属性、方法以及事件。本文将详细介绍这些内容，帮助开发者全面掌握该控件的使用方式，提升应用程序的交互性和用户体验。

一、CheckedListBox 控件的基本属性

1. Items 属性

Items 是 CheckedListBox 控件的核心属性之一，用于存储列表中的所有项。可以通过代码或设计器添加、删除或修改列表项。

checkedListBox1.Items.Add("Item 1");
checkedListBox1.Items.RemoveAt(0);

此属性返回一个 CheckedListBox.CheckedItemCollection 类型的对象，提供了对列表项的访问和操作能力。

1. CheckOnClick 属性

CheckOnClick 属性决定当用户点击列表项时是否自动切换其选中状态。默认值为 true，即点击即可勾选或取消勾选。

checkedListBox1.CheckOnClick = true;

如果设置为 false，则必须通过其他方式（如按钮）来更改选中状态。

1. SelectionMode 属性

SelectionMode 属性用于设置列表项的选中方式。可选值包括：

One：只能选择一项。

MultiSimple：允许多选，但不支持按住 Ctrl 或 Shift 键。

MultiExtended：支持按住 Ctrl 或 Shift 键进行多选。

checkedListBox1.SelectionMode = SelectionMode.MultiExtended;

1. CheckedItems 属性
   

CheckedItems 属性返回当前被勾选的所有项，是一个集合对象，可以用于遍历或处理已选中的项。

foreach (object item in checkedListBox1.CheckedItems)
{
    Console.WriteLine(item.ToString());
}

1. SelectedIndex 和 SelectedItem 属性
   

这两个属性分别用于获取当前选中的项的索引和内容。需要注意的是，它们只反映用户手动选择的项，而不是被勾选的项。

int selectedIndex = checkedListBox1.SelectedIndex;
object selectedItem = checkedListBox1.SelectedItem;

二、CheckedListBox 控件的常用方法

1. SetItemChecked 方法

SetItemChecked 方法用于设置指定索引位置的项的选中状态。第一个参数是项的索引，第二个参数是布尔值，表示是否选中。

checkedListBox1.SetItemChecked(0, true); // 勾选第一项

1. GetItemChecked 方法
   

GetItemChecked 方法用于获取指定索引位置的项的选中状态。

bool isChecked = checkedListBox1.GetItemChecked(0);

1. Clear 方法
   

Clear 方法用于清空 CheckedListBox 中的所有项。

checkedListBox1.Items.Clear();

1. Add 方法
   

Add 方法用于向 CheckedListBox 添加新项。

checkedListBox1.Items.Add("New Item");

1. RemoveAt 方法
   

RemoveAt 方法用于根据索引移除指定的项。

checkedListBox1.Items.RemoveAt(0);

三、CheckedListBox 控件的常用事件

1. SelectedIndexChanged 事件

SelectedIndexChanged 事件在用户改变所选项时触发。适用于需要根据用户选择执行某些操作的场景。

private void checkedListBox1_SelectedIndexChanged(object sender, EventArgs e)
{
    if (checkedListBox1.SelectedItem != null)
    {
        MessageBox.Show("你选择了：" + checkedListBox1.SelectedItem.ToString());
    }
}

1. ItemCheck 事件
   

ItemCheck 事件在用户点击某个项以更改其选中状态时触发。可以用于验证或阻止某些操作。

private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e)
{
    if (e.Index == 0 && e.NewValue == CheckState.Checked)
    {
        MessageBox.Show("不能勾选第一项！");
        e.Cancel = true; // 取消本次操作
    }
}

1. CheckedChanged 事件
   

CheckedChanged 事件在 CheckedListBox 的整体选中状态发生变化时触发，例如全选或取消全选操作。

private void checkedListBox1_CheckedChanged(object sender, EventArgs e)
{
    MessageBox.Show("列表选中状态已变化。");
}

1. MouseClick 事件
   

MouseClick 事件在用户单击控件时触发，可用于实现自定义的点击逻辑。

private void checkedListBox1_MouseClick(object sender, MouseEventArgs e)

{
    if (e.Button == MouseButtons.Left)
    {
        MessageBox.Show("你点击了 CheckedListBox。");
    }
}

四、CheckedListBox 的典型应用场景

1. 多选表单

在需要用户从多个选项中选择多个项目的场景下，CheckedListBox 是理想的选择。例如，在用户注册页面中选择兴趣爱好、权限配置等。

1. 数据筛选

在数据展示界面中，CheckedListBox 可以用于过滤数据，用户可以选择多个条件进行筛选，提高数据查询的灵活性。

1. 配置界面

在软件配置界面中，CheckedListBox 可用于让用户选择启用或禁用某些功能模块，实现灵活的配置管理。

五、注意事项与最佳实践

1. 避免频繁刷新控件

在大量数据更新时，应避免频繁调用 Items.Add() 或 Items.Clear()，以免影响性能。

1. 合理使用事件处理

在 ItemCheck 事件中，若需阻止某些操作，应设置 e.Cancel = true，避免不必要的状态变更。

1. 注意选中与勾选的区别

SelectedItem 表示用户手动选择的项，而 CheckedItems 表示被勾选的项，两者用途不同，不可混淆。

1. 优化 UI 体验

对于大型列表，建议采用分页或虚拟化技术，避免一次性加载过多数据导致界面卡顿。

CheckedListBox 控件在 C# Windows 应用程序中具有广泛的应用价值，它结合了列表和复选框的功能，为用户提供了一种高效的多选方式。通过掌握其主要属性、方法和事件，开发者可以更加灵活地控制控件的行为，提升应用程序的交互性与用户体验。

声明：所有来源为“聚合数据”的内容信息，未经本网许可，不得转载！如对内容有异议或投诉，请与我们联系。邮箱：marketing@think-land.com