### 项集合绑定方法 在 WinForms 中，`CheckBoxList` 控件可以通过 `Items` 属性直接添加项，或者通过数据绑定的方式将数据源绑定到控件。以下是两种常见的绑定方式： 1. **直接添加项** 使用 `Items.Add()` 方法可以手动向 `CheckedListBox` 的项集合中添加元素[^1]。 ```csharp checkedListBox1.Items.Add("选项1"); checkedListBox1.Items.Add("选项2"); checkedListBox1.Items.Add("选项3"); ``` 2. **数据绑定** 通过设置 `DataSource`、`DisplayMember` 和 `ValueMember` 属性，可以将数据源绑定到 `CheckedListBox` 控件。这种方式适用于需要动态加载大量数据的场景[^1]。 ```csharp List<string> items = new List<string> { "选项A", "选项B", "选项C" }; checkedListBox1.DataSource = items; ``` 如果数据源是一个复杂对象集合，则需要指定 `DisplayMember` 和 `ValueMember`： ```csharp class Item { public string Name { get; set; } public int Id { get; set; } } List<Item> items = new List<Item> { new Item { Name = "选项X", Id = 1 }, new Item { Name = "选项Y", Id = 2 }, new Item { Name = "选项Z", Id = 3 } }; checkedListBox1.DataSource = items; checkedListBox1.DisplayMember = "Name"; checkedListBox1.ValueMember = "Id"; ``` --- ### 操作项集合的属性 `CheckedListBox` 提供了多个属性来操作和管理项集合，以下是常用的属性： 1. **Items** 表示 `CheckedListBox` 中的所有项。可以通过索引访问或修改特定项[^1]。 ```csharp string item = checkedListBox1.Items[0].ToString(); // 获取第一项 ``` 2. **CheckedItems** 返回当前被选中的项集合。这是一个只读集合，用于获取用户选择的项[^1]。 ```csharp foreach (var item in checkedListBox1.CheckedItems) { Console.WriteLine(item.ToString()); } ``` 3. **SelectedIndex** 和 **SelectedItem** 分别表示当前选中的项的索引和值。注意，`CheckedListBox` 支持多选，因此这些属性仅返回最后一个选中的项[^1]。 ```csharp int selectedIndex = checkedListBox1.SelectedIndex; object selectedItem = checkedListBox1.SelectedItem; ``` 4. **CheckState** 用于获取或设置某一项的选中状态。状态包括 `Checked`（选中）、`Unchecked`（未选中）和 `Indeterminate`（不确定状态）[^2]。 ```csharp checkedListBox1.SetItemCheckState(0, CheckState.Checked); // 设置第一项为选中状态 ``` --- ### 主要事件 `CheckedListBox` 提供了多个事件以响应用户的交互行为。以下是主要的事件及其用途： 1. **ItemCheck** 在用户更改复选框状态时触发。此事件提供了 `ItemCheckEventArgs` 参数，允许捕获即将发生的更改并执行相关逻辑。 ```csharp private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e) { if (e.NewValue == CheckState.Checked) { MessageBox.Show("您选择了 " + checkedListBox1.Items[e.Index].ToString()); } else { MessageBox.Show("您取消了选择 " + checkedListBox1.Items[e.Index].ToString()); } } ``` 2. **SelectedIndexChanged** 当用户选择不同的项时触发。此事件可用于检测当前选中的项变化[^1]。 ```csharp private void checkedListBox1_SelectedIndexChanged(object sender, EventArgs e) { if (checkedListBox1.SelectedIndex != -1) { MessageBox.Show("当前选中的项是：" + checkedListBox1.SelectedItem.ToString()); } } ``` 3. **CheckedChanged** 当某个复选框的状态发生变化时触发。此事件适用于需要对选中状态进行全局处理的场景[^2]。 ```csharp private void childCheckBox_CheckedChanged(object sender, EventArgs e) { UpdateCheckState(checkBoxAll, new List<CheckBox> { checkBox1, checkBox2, checkBox3 }); } ``` --- ### 主要方法 `CheckedListBox` 提供了一些常用的方法来操作项集合和选中状态： 1. **SetItemChecked** 设置指定索引处的项为选中或未选中状态[^1]。 ```csharp checkedListBox1.SetItemChecked(0, true); // 设置第一项为选中状态 ``` 2. **GetItemChecked** 获取指定索引处的项是否被选中[^1]。 ```csharp bool isChecked = checkedListBox1.GetItemChecked(0); ``` 3. **ClearSelected** 清除当前选中的项[^1]。 ```csharp checkedListBox1.ClearSelected(); ``` 4. **ClearChecks** 清除所有项的选中状态[^1]。 ```csharp checkedListBox1.ClearChecks(); ``` 5. **FindString** 根据文本查找项的索引[^1]。 ```csharp int index = checkedListBox1.FindString("选项A"); ``` ---