选择框列表 CheckedListBox 控件

选择框列表 CheckedListBox 控件

选择框列表顾名思义，就是可以勾选并且以列表形式展示的控件。

可以点击控件右上角的三角形，通过编辑项来添加选择项。

也可以在后台代码动态添加。

窗体加载事件中动态添加项

双击 Windows 窗体，会自动创建 Form1_Load 事件，该事件在窗体加载完成时触发。

private void Form1_Load(object sender, EventArgs e)
{
    for (int i = 0; i < 10; i++)
    {
        this.checkedListBox1.Items.Add("item" + i);
    }
}Code language: JavaScript (javascript)

获取勾选的项目

在按钮点击事件中遍历获取所有勾选的项：

private void button4_Click(object sender, EventArgs e)
{
    for (int i = 0; i < this.checkedListBox1.Items.Count; i++)
    {
        if (checkedListBox1.GetItemChecked(i))
        {
            MessageBox.Show(checkedListBox1.GetItemText(checkedListBox1.Items[i]));
        }
    }
}Code language: JavaScript (javascript)

常用属性和方法

属性/方法	说明
Items	列表项的集合
Items.Add()	动态添加列表项
GetItemChecked(int index)	判断指定索引的项是否被勾选
GetItemText(object item)	获取指定项的显示文本
CheckedItems	直接获取所有已勾选项的集合
CheckOnClick	是否单击即切换勾选状态，设为 true 体验更好

简化写法

利用 CheckedItems 集合可以直接遍历已勾选项，无需手动判断：

private void button4_Click(object sender, EventArgs e)
{
    foreach (var item in checkedListBox1.CheckedItems)
    {
        MessageBox.Show(checkedListBox1.GetItemText(item));
    }
}Code language: PHP (php)