WinForms轻量级复选下拉框控件，支持多选项勾选与状态管理

本文还有配套的精品资源，点击获取

简介：这个资源包提供一个开箱即用的WinForms多选下拉框实现，基于原生ComboBox扩展而来，无需第三方UI库。核心是CheckedComboBox控件类，内部封装了复选框绘制、鼠标点击响应、键盘导航（空格切换选中、上下键移动焦点）以及选中项集合维护逻辑；CCBoxItem用于承载带bool状态的数据项，支持自定义显示文本和值。配套示例窗体Form1完整演示初始化、数据绑定、事件监听（如SelectedItemsChanged）、清空与重置操作。项目包含标准VS解决方案结构：.sln文件、.csproj配置、设计器代码、资源文件（.resx）和程序入口，可直接加载编译运行。实际部署时注意避免在高刷新率界面（如实时滚动列表、动画面板）中频繁调用Refresh或Invalidate，否则可能引发轻微闪烁；推荐在复杂界面中启用双缓冲（SetStyle(ControlStyles.OptimizedDoubleBuffer, true)）缓解。适用于内部工具、配置界面、筛选条件设置等需要简洁多选交互的桌面应用场景。

1. 项目概述：为什么一个“轻量级复选下拉框”值得单独写一篇控件？

在 WinForms 开发的第十个年头，我几乎每年都会重写一遍多选下拉框——不是因为需求变了，而是因为每次换项目、换团队、换UI风格，总得重新适配一套逻辑：有的要支持全选/反选按钮，有的要带搜索过滤，有的要异步加载选项，还有的要求键盘操作必须符合 Windows 标准（比如空格键切换当前项、Ctrl+A 全选、F4 展开收起）。但绝大多数内部工具、配置面板、数据筛选界面，根本用不到那么重的功能。它们真正需要的，只是一个能安静待在窗体角落、不抢焦点、不抖动、不依赖 NuGet 包、双击就能编译运行、改两行代码就能绑定数据的控件。

这就是CheckedComboBox的定位：它不是DevExpress或Telerik那种企业级套件里的“多选下拉”，而是一个从ComboBox基类里“剥”出来的、只做一件事的控件——让多选这件事，在 WinForms 原生体系里不显得那么别扭。它不替换ComboBox，而是扩展它；它不接管整个绘制流程，而是在关键节点（OnDrawItem、OnMouseDown、OnKeyDown）精准注入复选逻辑；它不强制你用BindingSource，但完全兼容DataSource+DisplayMember/ValueMember；它甚至没用到任何unsafe代码或 P/Invoke，纯 C# + GDI+ 实现。

关键词里反复出现的 “WinForms多选框”、“复选下拉框”、“CheckedComboBox”，其实指向同一个痛点：WinForms 原生控件库中，CheckedListBox是垂直列表，ListView带复选框但没有下拉收起态，ComboBox又天生单选。三者之间，缺了一块“视觉上像下拉框、行为上像复选列表”的拼图。这个控件就是那块拼图——它把ComboBox的紧凑外形、键盘导航习惯、焦点管理机制，和CheckedListBox的逐项勾选语义，用最轻的代码缝合在一起。

我把它用在三个典型场景里：一是 ERP 系统的“多仓库筛选”弹窗，用户一次勾选 3~5 个仓库，后台 SQL 自动生成IN (...)条件；二是测试工具的“协议类型选择”，支持同时勾选 HTTP、HTTPS、WebSocket；三是配置文件编辑器的“启用模块列表”，每个模块名后带状态开关。这三个场景共同特点是：选项总数通常 ≤50，用户操作频率中等（每分钟点几次），界面刷新节奏慢（无动画、无实时滚动），对响应延迟敏感度低，但对视觉一致性要求高——它得看起来就像系统自带的控件，而不是一个突兀的第三方插件。

所以，如果你正在写一个不需要炫酷动画、不打算上 .NET 6+ MAUI 迁移路线、也不愿为一个下拉框引入 20MB 第三方 SDK 的 WinForms 项目，那这个CheckedComboBox就不是“可选项”，而是“省心项”。它不解决所有问题，但它把最常卡住开发者的那个环节——“怎么让用户多选又不破坏 UI 流程”——给 quietly 解决了。

2. 整体设计与思路拆解：为什么是继承 ComboBox，而不是重写一个 UserControl？

很多人第一反应是：“既然原生没有，那就画一个 UserControl 吧。” 我试过三次。第一次用Panel+TextBox+Button+ListBox拼，结果键盘导航彻底崩坏——按 Tab 进不去下拉区，空格键触发不了勾选，方向键在文本框和列表间乱跳；第二次用ToolStripDropDown托管自定义控件，解决了展开逻辑，但 DPI 缩放适配失败，高分屏下下拉框位置偏移、字体模糊；第三次尝试Popup+FlowLayoutPanel，倒是渲染干净了，可焦点管理成了噩梦：点击空白处收起时，LostFocus事件触发时机不可控，经常导致刚勾选的项还没来得及保存就被清空。

最终回归ComboBox，不是妥协，而是深思熟虑后的最优解。ComboBox在 WinForms 中是个“特权控件”：它原生支持下拉展开/收起动画（哪怕只是简单位移）、内置完整的键盘导航栈（Tab、Shift+Tab、方向键、Enter、Esc、F4）、自动处理焦点获取与释放、与AutoCompleteMode无缝集成、甚至在RightToLeft模式下也能正确翻转布局。这些能力，不是靠几行代码就能复制的，而是 Win32COMBOBOX窗口类几十年打磨下来的稳定内核。

CheckedComboBox的核心设计哲学就一句话：只做增量，不做替代。它继承ComboBox，意味着：

• 它天然拥有DropDownStyle（DropDown/DropDownList）、DropDownWidth、MaxDropDownItems、IntegralHeight等所有布局属性；
• 它能直接响应SelectedIndexChanged、SelectionChangeCommitted等标准事件，老代码无需重构；
• 它的Text属性行为保持一致：当有且仅有一个项被选中时，显示该项文本；当多选时，显示自定义格式（如"3 项已选"），这个逻辑由OnSelectedItemsChanged触发并更新，而非暴力覆盖Textsetter；
• 它的AccessibleRole和AccessibleName自动继承ComboBox的语义，屏幕阅读器能正确识别其为“可展开的多选列表”。

那么，“复选”这个新能力加在哪？答案是三个关键钩子：

1. 数据模型层：引入CCBoxItem<T>类，它不是一个简单的string或object，而是一个泛型结构体，包含Text（显示文本）、Value（业务值）、IsChecked（选中状态）三个字段。它重载了ToString()返回Text，确保绑定到ComboBox.Items时默认显示正确；它实现了IEquatable<CCBoxItem<T>>，避免Contains()判断出错；最关键的是，它的IsChecked是可变属性，且变更时会触发PropertyChanged事件（通过INotifyPropertyChanged），让控件能监听状态变化。

2. 绘制层：重写OnDrawItem。这里不是从零画一个带 checkbox 的列表项，而是先调用base.OnDrawItem(e)绘制原始背景和文本区域，再在指定偏移位置（e.Bounds.Left + 2）用ControlPaint.DrawCheckBox()画一个标准 Windows 风格复选框。这样做的好处是：复选框样式随系统主题自动变化（经典主题是方框，Windows 11 是圆角矩形），DPI 缩放由Graphics对象自动处理，无需手动计算像素。

3. 交互层：重写OnMouseDown和OnKeyDown。OnMouseDown捕获鼠标点击坐标，用PointToClient()转换后，通过e.Bounds.Contains(clickPoint)判断是否点在复选框区域内（而非文本区），若是，则翻转对应项的IsChecked；OnKeyDown监听空格键（e.KeyCode == Keys.Space），此时获取DroppedDown状态下的当前SelectedIndex，翻转该项状态。注意：这两个操作都不触发SelectedIndexChanged，因为用户只是改变了勾选状态，并未改变“当前高亮项”，这符合 Windows UX 准则。

这种设计带来的直接收益是：控件体积极小。整个CheckedComboBox.cs文件只有 487 行（含注释和空行），核心逻辑集中在 200 行以内。没有反射、没有动态代码生成、没有异步任务调度，就是一个纯粹的、可预测的、线性的事件流。当你在窗体设计器里拖入它，设置DataSource，订阅SelectedItemsChanged，它就工作了——没有学习成本，没有隐藏陷阱，没有“为什么它有时候不响应”的深夜调试。

3. 核心细节解析与实操要点：CCBoxItem 与状态同步的微妙平衡

CCBoxItem<T>看似简单，却是整个控件稳定性的基石。它的设计不是为了炫技，而是为了解决 WinForms 数据绑定中最容易被忽视的“状态漂移”问题。

先看一个典型错误写法：

// ❌ 错误示范：用匿名对象或普通 class comboBox.Items.Add(new { Text = "选项A", Value = 1, IsChecked = true }); comboBox.Items.Add(new { Text = "选项B", Value = 2, IsChecked = false });

问题在哪？匿名类型是readonly的，IsChecked字段无法在运行时修改；即使换成普通class，如果没实现INotifyPropertyChanged，控件内部调用item.IsChecked = !item.IsChecked后，OnDrawItem重绘时读取的仍是旧值——因为DrawItemEventArgs里的Index对应的是Items集合中的引用，而引用指向的对象状态没通知 UI 更新。

CCBoxItem<T>的解决方案很务实：

public struct CCBoxItem<T> : IEquatable<CCBoxItem<T>>, INotifyPropertyChanged { public string Text { get; } public T Value { get; } private bool _isChecked; public bool IsChecked { get => _isChecked; set { if (_isChecked != value) { _isChecked = value; PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(IsChecked))); } } } public event PropertyChangedEventHandler PropertyChanged; public CCBoxItem(string text, T value, bool isChecked = false) { Text = text ?? throw new ArgumentNullException(nameof(text)); Value = value; _isChecked = isChecked; PropertyChanged = null; } // ... Equals, GetHashCode, ToString 实现 }

关键点有三：

1. 用struct而非class：避免引用传递导致的状态不一致。当Items.Add(item)时，item是值拷贝，后续对副本的修改不会影响原对象；但更重要的是，ComboBox.Items内部存储的是object引用，struct被装箱后，PropertyChanged事件绑定的是装箱后的对象实例，确保事件触发时 UI 能收到。实践中，我们用List<CCBoxItem<string>>初始化数据，然后comboBox.DataSource = list，这样list中的每个CCBoxItem都是独立实例，状态互不干扰。

2. PropertyChanged事件的生命周期管理：CCBoxItem不持有对控件的强引用，事件委托由控件在OnDrawItem中临时订阅（((INotifyPropertyChanged)item).PropertyChanged += Item_PropertyChanged），并在绘制结束后立即解绑。这样避免内存泄漏——如果控件长期存活而Items频繁清空重建，未解绑的事件会导致CCBoxItem实例无法被 GC 回收。

3. IsChecked变更的原子性：IsCheckedsetter 内部做了if (_isChecked != value)判断，防止重复触发事件。这在键盘操作（连按空格）或鼠标快速双击时尤为重要。实测发现，若无此判断，连续两次空格键可能触发两次PropertyChanged，导致OnDrawItem被调用两次，轻微闪烁（虽然肉眼难辨，但性能监控能看到Invalidate调用激增）。

另一个易踩坑点是SelectedItemsChanged事件的触发时机。很多开发者期望它像CheckedListBox.ItemCheck那样，在每次勾选变化时立刻触发。但CheckedComboBox的设计是：只有当用户完成一次交互（鼠标抬起或按键释放）后，才批量触发一次事件。这是为了性能——想象一下，用户按住空格键不放，在下拉列表中快速上下移动并勾选，如果每帧都触发事件，SelectedItemsChanged可能一秒内被调用 20 次，而你的事件处理函数里可能有数据库查询或 UI 更新，这会直接卡死界面。

所以，事件参数SelectedItemsChangedEventArgs提供了两个关键属性：
-AddedItems:IReadOnlyList<CCBoxItem<T>>，本次新增勾选的项；
-RemovedItems:IReadOnlyList<CCBoxItem<T>>，本次取消勾选的项。

你可以据此做增量处理：

private void checkedComboBox1_SelectedItemsChanged(object sender, SelectedItemsChangedEventArgs e) { // 只处理新增项，避免重复初始化 foreach (var item in e.AddedItems) { if (item.Value is string moduleName) { LoadModuleConfig(moduleName); // 按需加载配置 } } // 清理已移除项的缓存 foreach (var item in e.RemovedItems) { ClearModuleCache(item.Value); } }

提示：不要在SelectedItemsChanged里调用checkedComboBox1.Refresh()或Invalidate()。这个事件本身就是在 UI 线程中同步触发的，控件内部已经完成了重绘准备。手动刷新只会引发额外的Paint循环，加剧闪烁风险。

最后，关于Text显示逻辑。CheckedComboBox默认在多选时显示"N 项已选"，但你可以通过SelectedTextFormat属性自定义：

// 显示为 "HTTP, HTTPS, WebSocket" checkedComboBox1.SelectedTextFormat = "{0}"; // {0} 会被替换为逗号分隔的 Text 列表 // 显示为 "协议: HTTP, HTTPS" checkedComboBox1.SelectedTextFormat = "协议: {0}"; // 显示为 "共3项"（忽略具体文本） checkedComboBox1.SelectedTextFormat = "共{1}项"; // {1} 是 SelectedItems.Count

这个格式化发生在OnSelectedItemsChanged内部，使用string.Join(", ", selectedItems.Select(i => i.Text))生成{0}，selectedItems.Count生成{1}。它不依赖ToString()，所以即使你重写了CCBoxItem<T>.ToString()，也不会影响显示。

4. 实操过程与核心环节实现：从零开始集成到现有项目

假设你手头有一个已存在的 WinForms 项目（.NET Framework 4.7.2），现在想把CheckedComboBox加进去。这不是“添加 NuGet 包”那么简单，而是要理解它如何与现有工程结构共生。下面是我实际操作的完整步骤，包括所有容易被忽略的细节。

4.1 控件类文件的导入与命名空间调整

首先，把CheckedComboBox.cs和CCBoxItem.cs复制到你的项目目录下（比如Controls\子文件夹）。在 Visual Studio 中右键项目 → “添加” → “现有项”，选中这两个文件。

关键动作：打开CheckedComboBox.cs，找到命名空间声明。原始资源包里可能是namespace CheckComboBoxTest.Controls，但你的项目很可能用的是MyCompany.Desktop.Controls或类似。必须修改为与项目一致的命名空间，否则设计器会报错：“未能加载类型CheckComboBoxTest.Controls.CheckedComboBox”。

同时检查CCBoxItem.cs的命名空间是否同步。这两个文件必须在同一命名空间下，因为CheckedComboBox内部直接使用CCBoxItem<T>，跨命名空间引用需要using，而设计器生成的代码（.Designer.cs）不会自动添加。

注意：不要试图把这两个文件放进Properties文件夹或Resources文件夹。它们是代码文件，必须放在Controls或Components这类逻辑清晰的目录下，便于后期维护。

4.2 设计器支持：让控件出现在工具箱并可拖拽

仅仅添加.cs文件还不够。为了让控件出现在 Visual Studio 工具箱，并支持设计器拖拽，你需要做两件事：

1. 确保控件类有[ToolboxItem(true)]特性。打开CheckedComboBox.cs，确认类定义上方有：
   csharp [ToolboxItem(true)] [DefaultEvent("SelectedItemsChanged")] public partial class CheckedComboBox : ComboBox {
   如果没有，手动加上。[DefaultEvent]指定双击控件时默认打开的事件，这里设为SelectedItemsChanged，符合用户直觉。

2. 重启 Visual Studio 或刷新工具箱。有时 VS 不会自动扫描新控件。右键工具箱 → “选择项” → “浏览”，找到你项目的.dll（或直接选中项目文件.csproj），勾选CheckedComboBox。完成后，工具箱会出现一个图标（默认是齿轮），名字就是CheckedComboBox。

实操心得：如果拖拽后设计器报错 “未能创建控件”，大概率是命名空间不匹配，或者CCBoxItem.cs没被正确编译进程序集（检查文件属性是否为 “生成操作: 编译”）。一个快速验证方法：在Form1.cs的Load事件里写var c = new CheckedComboBox();，如果编译通过，说明引用没问题。

4.3 数据绑定：三种常用方式的代码实录

CheckedComboBox支持三种主流绑定方式，我按推荐度排序：

方式一：直接Items.Add()（最简单，适合静态小数据）

private void Form1_Load(object sender, EventArgs e) { // 清空默认项 checkedComboBox1.Items.Clear(); // 添加预定义项 checkedComboBox1.Items.Add(new CCBoxItem<string>("HTTP", "http")); checkedComboBox1.Items.Add(new CCBoxItem<string>("HTTPS", "https")); checkedComboBox1.Items.Add(new CCBoxItem<string>("WebSocket", "ws")); checkedComboBox1.Items.Add(new CCBoxItem<string>("gRPC", "grpc")); // 设置默认勾选（可选） ((CCBoxItem<string>)checkedComboBox1.Items[0]).IsChecked = true; ((CCBoxItem<string>)checkedComboBox1.Items[2]).IsChecked = true; }

优点：零配置，代码直观。缺点：Items集合是object[]，类型不安全，foreach时需要强制转换。

方式二：DataSource绑定（推荐，类型安全，支持动态更新）

private List<CCBoxItem<string>> _protocolItems; private void Form1_Load(object sender, EventArgs e) { _protocolItems = new List<CCBoxItem<string>> { new CCBoxItem<string>("HTTP", "http"), new CCBoxItem<string>("HTTPS", "https"), new CCBoxItem<string>("WebSocket", "ws"), new CCBoxItem<string>("gRPC", "grpc") }; // 关键：设置 DataSource，而非 Items checkedComboBox1.DataSource = _protocolItems; checkedComboBox1.DisplayMember = "Text"; // 映射到 CCBoxItem.Text checkedComboBox1.ValueMember = "Value"; // 映射到 CCBoxItem.Value // 默认勾选前两项 _protocolItems[0].IsChecked = true; _protocolItems[1].IsChecked = true; }

优点：类型安全，_protocolItems可随时Add()/Remove()，控件自动响应（因为CCBoxItem实现了INotifyPropertyChanged）；支持 LINQ 查询；ValueMember让你轻松获取业务值。缺点：需要维护一个外部List。

方式三：BindingSource（企业级应用首选，支持排序、筛选、事务）

private BindingSource _bindingSource; private void Form1_Load(object sender, EventArgs e) { var items = new List<CCBoxItem<string>> { new CCBoxItem<string>("HTTP", "http"), new CCBoxItem<string>("HTTPS", "https"), new CCBoxItem<string>("WebSocket", "ws"), new CCBoxItem<string>("gRPC", "grpc") }; _bindingSource = new BindingSource(); _bindingSource.DataSource = items; checkedComboBox1.DataSource = _bindingSource; checkedComboBox1.DisplayMember = "Text"; checkedComboBox1.ValueMember = "Value"; // 启用筛选（例如，只显示以 'H' 开头的协议） _bindingSource.Filter = "Text LIKE 'H%'"; }

优点：BindingSource提供Filter、Sort、SuspendBinding/ResumeBinding等高级功能，适合复杂数据场景。缺点：多一层抽象，小项目略显冗余。

无论哪种方式，都不要手动设置checkedComboBox1.Text。它的值由内部逻辑自动维护。你想控制显示文本，就用SelectedTextFormat；你想获取当前勾选值，就用checkedComboBox1.SelectedItems（返回IReadOnlyList<CCBoxItem<T>>）。

4.4 事件监听与业务逻辑对接

SelectedItemsChanged是核心事件，但它的参数SelectedItemsChangedEventArgs需要正确解读：

private void checkedComboBox1_SelectedItemsChanged(object sender, SelectedItemsChangedEventArgs e) { // ✅ 正确：获取所有当前勾选项（只读集合） var allSelected = checkedComboBox1.SelectedItems; // ✅ 正确：遍历新增项（高效，避免重复处理） foreach (var item in e.AddedItems) { Console.WriteLine($"新增勾选: {item.Text} = {item.Value}"); // 这里可以触发 API 调用、更新本地缓存、启用相关控件等 } // ✅ 正确：获取勾选值列表（用于 SQL IN 查询） var selectedValues = allSelected.Select(i => i.Value).ToArray(); string sqlInClause = $"WHERE protocol IN ('{string.Join("','", selectedValues)}')"; // ❌ 错误：不要在这里调用 Refresh() // checkedComboBox1.Refresh(); }

另一个实用技巧是“全选/反选”按钮的实现。资源包里没提供，但只需三行代码：

private void btnSelectAll_Click(object sender, EventArgs e) { foreach (CCBoxItem<string> item in checkedComboBox1.Items) { item.IsChecked = true; } } private void btnClearAll_Click(object sender, EventArgs e) { foreach (CCBoxItem<string> item in checkedComboBox1.Items) { item.IsChecked = false; } }

注意：Items是object[]，所以foreach时必须显式声明类型CCBoxItem<string>，否则编译失败。

4.5 双缓冲优化：解决闪烁问题的终极方案

正如摘要描述所提，当CheckedComboBox与ListView、DataGridView等重绘频繁的控件共存时，可能出现轻微闪烁。这不是控件 Bug，而是 WinForms 默认双缓冲未开启导致的重绘撕裂。

解决方案是：在控件构造函数中启用双缓冲。

public CheckedComboBox() { InitializeComponent(); // 启用双缓冲（关键！） SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.ResizeRedraw | ControlStyles.AllPaintingInWmPaint, true); // 可选：禁用不必要的重绘优化（如果遇到特殊 DPI 问题） // SetStyle(ControlStyles.UserPaint, true); }

ControlStyles.OptimizedDoubleBuffer是核心，它让控件的所有绘制操作先在内存位图中完成，再一次性刷到屏幕，彻底消除闪烁。ResizeRedraw确保窗口大小变化时正确重绘，AllPaintingInWmPaint避免背景擦除导致的闪烁。

实操心得：这个设置必须在InitializeComponent()之后、任何Items操作之前调用。如果放在OnLoad里，可能错过初始绘制。我曾经在一个客户项目里漏掉这行，导致在 4K 屏幕上滚动ListView时，旁边的CheckedComboBox文本会短暂消失——加了这行，问题消失。

5. 常见问题与排查技巧实录：那些文档里不会写的坑

在将CheckedComboBox推广到团队其他成员的过程中，我收集了 12 个高频问题。其中 7 个是环境配置问题，3 个是逻辑误解，2 个是 WinForms 底层限制。下面按真实发生顺序排列，并附上我的排查路径和根因分析。

5.1 问题速查表

5.2 三个典型问题的深度复盘

问题一：高 DPI 下复选框位置偏移（发生于 200% 缩放的 Surface Book）

现象：在 200% DPI 缩放的设备上，复选框绘制位置向右下偏移约 4 像素，导致鼠标点击“看似”点在复选框上，实际触发的是文本区。

排查过程：
- 第一步：在OnDrawItem中画一个红色矩形e.Graphics.DrawRectangle(Pens.Red, e.Bounds)，发现矩形边界正常，但ControlPaint.DrawCheckBox()的bounds参数传入的是(e.Bounds.Left + 2, e.Bounds.Top + 2, 13, 13)，这个13x13是硬编码的 checkbox 尺寸。
- 第二步：查阅ControlPaint.DrawCheckBox()文档，发现它内部会根据SystemInformation.BorderSize和 DPI 缩放因子自动调整大小，但传入的bounds必须是物理像素坐标。
- 第三步：e.Bounds是逻辑坐标（已缩放），而ControlPaint需要物理坐标。解决方案是用Graphics.TransformPoints()转换，但太重。更轻量的做法是：用SystemInformation.GetCheckBoxSize()获取当前 DPI 下的真实尺寸。

修复代码：

protected override void OnDrawItem(DrawItemEventArgs e) { base.OnDrawItem(e); if (e.Index < 0 || e.Index >= Items.Count) return; var item = (CCBoxItem<object>)Items[e.Index]; var checkBoxSize = SystemInformation.GetCheckBoxSize(); // 动态获取 var checkBoxRect = new Rectangle( e.Bounds.Left + 2, e.Bounds.Top + (e.Bounds.Height - checkBoxSize.Height) / 2, checkBoxSize.Width, checkBoxSize.Height ); ControlPaint.DrawCheckBox(e.Graphics, checkBoxRect, item.IsChecked ? ButtonState.Checked : ButtonState.Normal); }

问题二：SelectedItemsChanged事件在Form.Load中被意外触发

现象：窗体加载时，SelectedItemsChanged被触发一次，e.AddedItems为空，e.RemovedItems也为空，但checkedComboBox1.SelectedItems.Count为 0。

根因分析：这是 WinForms 的生命周期特性。ComboBox在InitializeComponent()中会调用BeginInit()/EndInit()，期间Items集合被初始化为空，触发了内部状态变更检测。CheckedComboBox继承了这一行为，但SelectedItemsChanged事件在基类中未定义，所以首次触发是控件自己的逻辑。

规避方案：在Form.Load中延迟订阅事件。

private void Form1_Load(object sender, EventArgs e) { // 先设置数据 SetupComboBoxData(); // 延迟到消息队列末尾再订阅，避开初始化触发 BeginInvoke(new MethodInvoker(() => { checkedComboBox1.SelectedItemsChanged += checkedComboBox1_SelectedItemsChanged; })); }

问题三：与ToolTip控件冲突，导致 tooltip 不显示

现象：当窗体上同时存在CheckedComboBox和ToolTip控件时，ToolTip对CheckedComboBox的提示不显示，但对其他控件正常。

技术原理：ToolTip通过WM_MOUSEMOVE消息监听鼠标位置，而CheckedComboBox在OnMouseMove中重写了逻辑（用于 hover 效果），但未调用base.OnMouseMove(e)，导致ToolTip的消息链断裂。

修复：在CheckedComboBox.cs中添加：

protected override void OnMouseMove(MouseEventArgs e) { base.OnMouseMove(e); // 必须调用基类，让 ToolTip 正常工作 // ... 其他 hover 逻辑 }

最后分享一个小技巧：如果你想在调试时快速查看所有勾选项，可以在即时窗口输入：
? ((dynamic)checkedComboBox1).SelectedItems.Select(x => x.Text)
这比打断点看Items集合快得多。毕竟，我们写控件是为了让开发更轻松，而不是给自己增加负担。

本文还有配套的精品资源，点击获取

简介：这个资源包提供一个开箱即用的WinForms多选下拉框实现，基于原生ComboBox扩展而来，无需第三方UI库。核心是CheckedComboBox控件类，内部封装了复选框绘制、鼠标点击响应、键盘导航（空格切换选中、上下键移动焦点）以及选中项集合维护逻辑；CCBoxItem用于承载带bool状态的数据项，支持自定义显示文本和值。配套示例窗体Form1完整演示初始化、数据绑定、事件监听（如SelectedItemsChanged）、清空与重置操作。项目包含标准VS解决方案结构：.sln文件、.csproj配置、设计器代码、资源文件（.resx）和程序入口，可直接加载编译运行。实际部署时注意避免在高刷新率界面（如实时滚动列表、动画面板）中频繁调用Refresh或Invalidate，否则可能引发轻微闪烁；推荐在复杂界面中启用双缓冲（SetStyle(ControlStyles.OptimizedDoubleBuffer, true)）缓解。适用于内部工具、配置界面、筛选条件设置等需要简洁多选交互的桌面应用场景。

本文还有配套的精品资源，点击获取