简介面向 Windows Forms 与 WPF 开发者的多选下拉框实现示例针对标准 ComboBox 只能单选的局限通过自定义控件内嵌 CheckBox让用户在下拉列表中一次勾选多个选项。示例围绕 MultiSelectComboBox 自定义控件展开配套主窗口界面与项目工程文件演示继承扩展控件、重写下拉渲染、将勾选状态与数据源双向同步以及在代码后置文件中完成控件初始化、CheckBox 事件响应与选中结果读取的完整链路可迁移到配置项设置、权限勾选、筛选条件组合等场景对希望深入 WPF 控件模板与数据绑定的中级开发者较有参考价值。压缩包共 55 个文件、约 125KB以 15 个 cs 源码和 xaml 界面文件为主体辅以 baml、resx 等资源及 csproj、sln 工程配置结构完整、便于直接编译调试。已有 498 人学习读者可据此掌握自定义控件的渲染与数据绑定思路并延伸出搜索过滤、复选样式替换等增强功能。1. 原生 ComboBox 塞不进复选框这个控件的定位与适用场景给 ComboBox 的每一项前面挂一个 CheckBox看起来是个小需求做起来却是个典型的长尾坑。业务上这个控件解决的是「一次选多个、收起后还要知道选了啥」的问题筛选器、标签选择、权限分组、导出字段勾选后台管理系统里到处是它。但 WinForms 和 WPF 的原生 ComboBox 从设计上就是单选语义CheckedListBox 又只能一直摊在界面上没有下拉收起的紧凑感。于是多数项目最终都会落到一份自绘或组合的自定义控件代码上。这篇拆的就是这份带 CheckBox 的 ComboBox 资源两条主流实现路线各自的完整代码、命中判断的细节以及我实际替换过一轮之后留下来的踩坑清单。适合手里有 WinForms 老项目需要平滑替换、或者正准备自己写一个多选下拉控件的工程师。2. 三条实现路线选型OwnerDraw 继承、复合控件、第三方库动手之前先把路线定下来这一步定错后面改的成本比从头写还高。带 CheckBox 的 ComboBox 在工程上有三种做法差别不在「能不能实现」而在「你的项目能不能承受它带来的副作用」。2.1 继承 ComboBox 走 OwnerDraw轻但要碰 Win32 消息第一种是class CheckedComboBox : ComboBox把DrawMode设成OwnerDrawFixed重写OnDrawItem在每一项前面画一个复选框。这条路线的最大优点是「平替」——调用方原来写comboBox1.Items.Add(...)的代码一行不用改把类型换掉就行属性、事件、数据绑定的习惯全部沿用。代价也很直接ComboBox 的下拉列表本质是另一个窗口内部 ListBox你在控件上挂的MouseDown事件根本收不到下拉列表里的点击。想判断用户点中了哪一项必须走GetComboBoxInfo拿到下拉列表的窗口句柄再在WndProc里拦截WM_LBUTTONDOWN用LB_ITEMFROMPOINT反查索引。这条路线能不能跑通取决于你对这几个消息的容忍度。提示继承路线有一个绕不开的硬约束DropDownStyle必须是DropDownList。一旦设成DropDown可编辑编辑区就由原生的 EDIT 控件绘制OnDrawItem里e.Index -1的那次调用根本不会来你在编辑区画的汇总文本会直接消失。2.2 UserControl 组合 CheckedListBox重但每一层都归你管第二种是新建一个UserControl一个只读的 TextBox或 Label负责显示汇总文本一个 Button 负责展开弹出来的是装在ToolStripDropDown里的CheckedListBox。控件层级完全是托管的没有 P/Invoke没有消息拦截下拉什么时候关、关的时候焦点给谁都是你自己写的代码。这条路线写起来代码量略多但调试成本低得多。CheckBox 的勾选状态、文本回填、变更事件全在托管层断点能停住日志能打出来。缺点是要自己实现「点击控件外部关闭下拉」「Esc 关闭」「Tab 移走时收起」这些原生 ComboBox 白送的行为漏一个用户就会觉得这控件「怪」。2.3 五条路线的参数对比与选型表同一件事在不同技术栈里有不同解法下面这张表把常见的五种放在一起对比方便你对照自己项目的技术栈直接定位。路线核心 API代码量编辑区可输入高 DPI 风险适用场景继承 ComboBox OwnerDrawOnDrawItem、GetComboBoxInfo、WndProc约 300 行否中ItemHeight需按 DPI 换算已有大量 ComboBox 调用点想平滑替换UserControl CheckedListBoxToolStripDropDown、ToolStripControlHost约 250 行可以低新项目后续还要加搜索过滤第三方控件库库自带0看库低有商用授权预算WPF ItemsControl CheckBoxItemContainerStyle、IsChecked绑定约 150 行 XAML可以低WPF 项目前端detailscheckbox原生 DOM约 100 行可以无Web 端筛选器选型上有两条我自己的判断标准。第一如果现有代码里 ComboBox 的调用点超过二十处走继承路线改造是替换类型名级别的风险可控。第二如果这个控件后续要加「输入关键词过滤」「全选/反选按钮」「分组显示」这类扩展走复合控件路线因为CheckedListBox上面加一个搜索框比在 ComboBox 的自绘逻辑里塞一个过滤状态容易十倍。WPF 那边的情况要单独说一句。WPF 的 ComboBox 里放 CheckBox会遇到「点击 CheckBox 不切换勾选反而把下拉关掉」的问题原因是 ComboBoxItem 的容器把点击事件吃掉了。常见做法是在ItemContainerStyle里把ComboBoxItem.IsSelected和你的IsChecked做双向绑定让「选中」这个动作本身承载勾选语义!-- WPF把 ComboBoxItem 的选中状态当作勾选状态使用 -- ComboBox ItemsSource{Binding Options} IsEditableFalse ComboBox.ItemContainerStyle Style TargetTypeComboBoxItem !-- IsSelected 与业务模型的 IsChecked 双向同步 -- Setter PropertyIsSelected Value{Binding IsChecked, ModeTwoWay} / Setter PropertyTemplate Setter.Value ControlTemplate TargetTypeComboBoxItem CheckBox IsChecked{Binding IsChecked, ModeTwoWay} Content{Binding Name} Margin4,2 / /ControlTemplate /Setter.Value /Setter /Style /ComboBox.ItemContainerStyle /ComboBox这段 XAML 的关键在IsSelected那一行。CheckBox 自己是被模板画出来的它的IsChecked走业务模型而ComboBoxItem的IsSelected也被强行绑到同一个属性上这样即使用户点到的是容器空白区域勾选状态也会跟着变。如果不写这一行用户点文字能勾上点行末空白就勾不上实测中被提过不止一次。3. 复合控件路线落地从 CheckedListBox 到可下拉的多选输入框先把推荐路线写透。这一章给的是一个可以直接编译运行的UserControl包含显示区、展开按钮、下拉面板和变更事件四部分。3.1 控件骨架TextBox 按钮 ToolStripDropDown骨架采用「一个只读 TextBox 撑满宽度 一个箭头按钮贴右边」的布局下拉面板用ToolStripDropDown承载里面放一个ToolStripControlHost包住CheckedListBox。之所以不用ContextMenuStrip是因为它会在点击子控件时自动关闭而我们要的是勾选完继续留在面板里。public class CheckedComboBox : UserControl { private readonly TextBox _display; // 显示汇总文本只读 private readonly Button _arrow; // 右侧展开按钮 private readonly ToolStripDropDown _dropDown; private readonly CheckedListBox _list; private bool _suppressEvent; // 批量勾选时抑制事件避免刷屏 // 超过这个数量就不再全拼改成「A, B 等 3 项」 public int MaxInlineDisplay { get; set; } 2; public event EventHandler? ItemsCheckedChanged; public CheckedComboBox() { _display new TextBox { ReadOnly true, BorderStyle BorderStyle.None, Dock DockStyle.Fill, BackColor SystemColors.Window }; _arrow new Button { Dock DockStyle.Right, Width 22, Text ▼, FlatStyle FlatStyle.Flat }; _arrow.FlatAppearance.BorderSize 0; _list new CheckedListBox { CheckOnClick true, // 单击即勾选不用点两次 BorderStyle BorderStyle.None, IntegralHeight false // 关键允许按设定高度显示不被行高整除 }; _list.ItemCheck OnItemCheck; // AutoClose false点面板内部不关闭关闭时机由我们自己控制 _dropDown new ToolStripDropDown { AutoClose false, Padding Padding.Empty, DropShadowEnabled true }; var host new ToolStripControlHost(_list) { Margin Padding.Empty, Padding Padding.Empty, AutoSize false }; _dropDown.Items.Add(host); Controls.Add(_display); Controls.Add(_arrow); _arrow.Click (_, _) ToggleDropDown(); _display.Click (_, _) ToggleDropDown(); } }几个参数的取舍说明一下。CheckOnClick true让用户单击整行就勾选这是多选下拉的默认预期如果你们的业务需要「先高亮再按空格确认」就把它关掉改成自己处理SelectedIndexChanged。IntegralHeight false是必须的否则CheckedListBox会为了凑整行自动把高度改大或改小面板底部会出现一条空白或者最后一行被切掉这个现象在 125% 缩放下尤其明显。AutoClose false是整条路线能成立的前提代价是「点外面关闭」要自己实现。3.2 展开与收起位置计算和外部点击关闭展开的逻辑里有两个坐标容易搞混Show的第一个参数是相对控件第二个参数是相对控件客户区的点而如果你用PointToScreen自己算就是屏幕坐标两者不能混。这里统一用「相对本控件、出现在下边缘」的写法。private void ToggleDropDown() { if (_dropDown.Visible) { _dropDown.Close(); return; } // 面板宽度跟随控件宽度高度取内容高度但不超过 260 var width Width; var height Math.Min(260, _list.PreferredHeight 2); _dropDown.MinimumSize new Size(width, 0); _list.Width width - 2; _list.Height height - 2; // 相对本控件出现在下边缘下方空间不够时 ToolStripDropDown 会自动翻到上方 _dropDown.Show(this, new Point(0, Height), ToolStripDropDownDirection.BelowRight); } protected override void OnLeave(EventArgs e) { base.OnLeave(e); if (!_dropDown.Focused) _dropDown.Close(); }ToolStripDropDownDirection.BelowRight会处理屏幕边缘的翻转如果下拉展开后超出屏幕底部它会自动改为向上弹。这一点比自己算Screen.FromControl再判断省事。OnLeave里判断_dropDown.Focused是因为焦点从控件移到下拉面板时也会触发OnLeave不判断的话用户一点开就被关掉了——这是接手别人的控件时最常见的「闪一下就没了」的来源。如果要求「点窗口任意其他地方也关闭」光靠OnLeave不够因为用户可能直接点同一窗体上的另一个控件。常见做法是挂一个消息过滤器// 在控件构造或 HandleCreated 时注册Dispose 时务必移除 Application.AddMessageFilter(new DropDownCloseFilter(this)); private sealed class DropDownCloseFilter : IMessageFilter { private readonly CheckedComboBox _owner; public DropDownCloseFilter(CheckedComboBox owner) _owner owner; public bool PreFilterMessage(ref Message m) { const int WM_LBUTTONDOWN 0x0201; if (m.Msg ! WM_LBUTTONDOWN) return false; if (!_owner.DropDownVisible) return false; // 点击落在下拉面板或控件自身范围内不处理 var screenPoint new Point((short)(m.LParam.ToInt32() 0xFFFF), (short)((m.LParam.ToInt32() 16) 0xFFFF)); if (_owner.ContainsScreenPoint(screenPoint)) return false; _owner.CloseDropDown(); return false; // 不吞掉消息让目标控件正常获得点击 } }这里PreFilterMessage返回false是刻意的。如果返回true这条点击消息就被吞了用户点别的按钮会变成「第一次点只关下拉第二次点才生效」手感很差。取出LParam高低位时记得用short强转否则 2560 宽屏下会出现负值坐标判定直接失效。3.3 文本回填全拼还是「已选 N 项」回填策略看着是纯 UI 问题实际会影响用户对「选没选中」的判断。我的做法是给一个可配置的分界点勾选数量不超过MaxInlineDisplay时全拼超过就拼前几项加一个总数。private void RefreshDisplayText() { var names _list.CheckedItems.Castobject() .Select(item _list.GetItemText(item)) .ToArray(); _display.Text names.Length switch { 0 PlaceholderText, // 未选时显示占位文案 var n when n MaxInlineDisplay string.Join(、, names), _ ${string.Join(、, names.Take(MaxInlineDisplay))} 等 {names.Length} 项 }; // 占位文案用灰色真实内容用正常前景色 _display.ForeColor names.Length 0 ? SystemColors.GrayText : SystemColors.ControlText; } private void OnItemCheck(object? sender, ItemCheckEventArgs e) { if (_suppressEvent) return; // ItemCheck 在状态提交之前触发必须用 BeginInvoke 等状态落地后再读 CheckedItems BeginInvoke(new Action(() { RefreshDisplayText(); ItemsCheckedChanged?.Invoke(this, EventArgs.Empty); })); }BeginInvoke那一行是必须的。ItemCheck事件触发时CheckedItems还是旧值直接在里面读会拿到差一项的结果表现出来就是「勾第一个没反应勾第二个才把第一个显示出来」——这个 bug 我在两个项目里各踩过一次血泪经验是「凡是XxxChanging语义的事件读状态一律延后一帧」。_suppressEvent是为批量操作准备的。外部调用SelectAll()时逐项设置勾选会触发几十次ItemCheck每次都BeginInvoke一次RefreshDisplayText界面会明显卡顿。批量前把它置true批量结束置回false再手动刷一次文本一次性解决。3.4 数据绑定与变更事件控件的可用性很大程度取决于「怎么塞数据」。暴露一个泛型方法比暴露Items属性更好用因为调用方通常手里只有一个业务对象集合不需要知道CheckedListBox的存在。public void SetItemsT(IEnumerableT source, FuncT, string display, FuncT, bool? isChecked null) { _suppressEvent true; try { _list.Items.Clear(); foreach (var item in source) { var text display(item); var index _list.Items.Add(text); // 用 Tag 挂业务对象取值时直接拿实体不用再按字符串反查 _list.Items[index] new CheckedItem(item!, text); if (isChecked is not null isChecked(item)) _list.SetItemChecked(index, true); } } finally { _suppressEvent false; } RefreshDisplayText(); } // 取出当前勾选的业务对象 public IReadOnlyListT GetCheckedItemsT() _list.CheckedItems.CastCheckedItem().Select(x (T)x.Value).ToList(); private sealed record CheckedItem(object Value, string Text) { public override string ToString() Text; // CheckedListBox 靠 ToString 显示 }用record把业务对象和显示文本一起塞进Items好处是取值时不用做字符串到实体的反查那个反查在有重名时必然出错。ToString()重写成返回Text是必须的CheckedListBox不认DisplayMember之外的东西而记录类型默认的ToString()会打出一串类型名。这里没有用DataSource。CheckedListBox支持数据源绑定但绑定之后Items集合就只读SetItemChecked和后续的增删都会受影响勾选状态和业务集合的双向同步还得再写一层BindingSource。在「一次性塞入、按需读取」的场景里手动Items.Add反而更省事。4. OwnerDraw 路线落地DrawItem 自绘复选框与 WM_LBUTTONDOWN 命中第二条路线留给老项目。这一章的核心是三个东西自绘流程、下拉列表句柄的获取、命中索引的反查。4.1 DrawMode 与 Index -1 的编辑区绘制继承 ComboBox 后先把绘制模式定下来然后在OnDrawItem里分两种情况e.Index 0是下拉列表里的某一项e.Index -1是收起后的编辑区。public class CheckedComboBoxEx : ComboBox { private readonly HashSetobject _checked new(); // 用对象引用记录勾选状态 public CheckedComboBoxEx() { DrawMode DrawMode.OwnerDrawFixed; // 固定行高性能更好 DropDownStyle ComboBoxStyle.DropDownList; // 必须否则编辑区不进 OnDrawItem ItemHeight 22; } protected override void OnDrawItem(DrawItemEventArgs e) { e.DrawBackground(); // e.Index -1 表示绘制编辑区收起状态的文本 if (e.Index 0) { var summary BuildSummaryText(); TextRenderer.DrawText(e.Graphics, summary, Font, e.Bounds, ForeColor, TextFormatFlags.VerticalCenter | TextFormatFlags.Left | TextFormatFlags.EndEllipsis | TextFormatFlags.NoPrefix); return; } var item Items[e.Index]; var isChecked _checked.Contains(item); // 按 DPI 缩放复选框尺寸13px 是 96 DPI 下的基准值 var scale e.Graphics.DpiX / 96f; var boxSize (int)(13 * scale); var boxRect new Rectangle( e.Bounds.Left (int)(4 * scale), e.Bounds.Top (e.Bounds.Height - boxSize) / 2, boxSize, boxSize); var state isChecked ? CheckBoxState.CheckedNormal : CheckBoxState.UncheckedNormal; if ((e.State DrawItemState.Selected) ! 0) state isChecked ? CheckBoxState.CheckedHot : CheckBoxState.UncheckedHot; CheckBoxRenderer.DrawCheckBox(e.Graphics, boxRect.Location, state); // 文本绘制区从复选框右侧开始保留 2px 间距 var textRect new Rectangle(boxRect.Right (int)(2 * scale), e.Bounds.Top, e.Bounds.Width - boxRect.Right - (int)(4 * scale), e.Bounds.Height); var textColor ((e.State DrawItemState.Selected) ! 0) ? SystemColors.HighlightText : ForeColor; TextRenderer.DrawText(e.Graphics, GetItemText(item), Font, textRect, textColor, TextFormatFlags.VerticalCenter | TextFormatFlags.Left | TextFormatFlags.EndEllipsis); } }两个参数需要展开说。DrawMode.OwnerDrawFixed意味着所有行高一致ItemHeight是全局值性能好但高 DPI 下要手动乘缩放系数OwnerDrawVariable则要求你实现OnMeasureItem每行单独测量能自适应长文本换行代价是列表滚动时会反复触发测量。我在高 DPI 场景下更倾向用OwnerDrawVariable并显式重写OnMeasureItem因为ItemHeight一旦被系统 DPI 缩放覆盖固定行高会出现文字被切掉的情况。CheckBoxRenderer.DrawCheckBox来自System.Windows.Forms.VisualStyles命名空间画出来的复选框和系统原生外观一致选中态、禁用态都有现成的枚举值不用自己拼图片。4.2 用 GetComboBoxInfo 拿到下拉列表句柄自绘解决了「看得见」接下来解决「点得着」。ComboBox 的下拉列表是一个独立的子窗口控件自身的鼠标事件收不到它必须先把句柄取出来。[StructLayout(LayoutKind.Sequential)] private struct RECT { public int Left, Top, Right, Bottom; } [StructLayout(LayoutKind.Sequential)] private struct COMBOBOXINFO { public int cbSize; public RECT rcItem; public RECT rcButton; public int stateButton; public IntPtr hwndCombo; public IntPtr hwndItem; public IntPtr hwndList; // 下拉列表窗口句柄我们要的就是它 } [DllImport(user32.dll, SetLastError true)] private static extern bool GetComboBoxInfo(IntPtr hWnd, ref COMBOBOXINFO pcbi); [DllImport(user32.dll, CharSet CharSet.Auto)] private static extern IntPtr SendMessage(IntPtr hWnd, int msg, IntPtr wParam, IntPtr lParam); private const int LB_ITEMFROMPOINT 0x01A9; private IntPtr _listHandle IntPtr.Zero; protected override void OnHandleCreated(EventArgs e) { base.OnHandleCreated(e); var info new COMBOBOXINFO(); info.cbSize Marshal.SizeOf(typeof(COMBOBOXINFO)); if (GetComboBoxInfo(Handle, ref info)) _listHandle info.hwndList; }cbSize必须在调用前赋值这是所有带版本号的 Win32 结构体的通用要求忘了填就是直接返回false而且GetLastError的信息往往不够用排查起来像黑匣子。句柄在OnHandleCreated里取一次即可但如果控件经历销毁重建比如动态换父容器Handle会变要在OnHandleDestroyed里把_listHandle置回IntPtr.Zero下次创建时重新取。4.3 命中判断与 LB_ITEMFROMPOINT有了句柄接下来在WndProc里拦截鼠标按下。判断逻辑是消息的目标窗口是不是下拉列表如果是用LB_ITEMFROMPOINT把客户区坐标换算成项索引。private const int WM_LBUTTONDOWN 0x0201; protected override void WndProc(ref Message m) { if (m.Msg WM_LBUTTONDOWN _listHandle ! IntPtr.Zero m.HWnd _listHandle) { // 低 16 位是索引高 16 位非 0 表示点在了空白处 var packed (int)SendMessage(_listHandle, LB_ITEMFROMPOINT, IntPtr.Zero, m.LParam); var index packed 0xFFFF; var outside (packed 16) ! 0; if (!outside index 0 index Items.Count) { var item Items[index]; if (!_checked.Remove(item)) _checked.Add(item); // 手动让下拉列表重绘否则勾选状态要等下次鼠标移过才刷新 Invalidate(); m.Result (IntPtr)1; // 吞掉消息阻止 ComboBox 的默认单选行为 return; } } base.WndProc(ref m); }m.Result (IntPtr)1加上return这两行是整条路线的关键。不吞消息的话ComboBox 会在你切换勾选的同时把选中项改成被点的那一项Text属性会跟着变编辑区显示的汇总文本就被污染了。吞掉之后要自己Invalidate()触发重绘因为默认的「选中项变化 → 重绘」链路被切断了。LB_ITEMFROMPOINT的返回值高低位含义容易记反我用一次就写一次注释。低 16 位是索引高 16 位为 1 表示点在这一项之外比如列表底部的空白区域。如果只取索引不判断高位用户在列表空白处点一下会莫名其妙把最后一项勾选上。4.4 高 DPI 下的坐标与尺寸换算自绘控件在 125%、150% 缩放下最容易翻车的是两处一是刚才代码里的boxSize二是ItemHeight。ItemHeight如果在构造函数里写死 22在 150% 缩放下字会被截断因为字体已经被系统放大而行高没有。protected override void OnMeasureItem(MeasureItemEventArgs e) { if (e.Index 0) return; // OwnerDrawVariable 模式下每项单独测量文本高度 上下内边距 var textHeight TextRenderer.MeasureText( GetItemText(Items[e.Index]), Font).Height; e.ItemHeight textHeight LogicalToDeviceUnits(6); e.ItemWidth Width; }LogicalToDeviceUnits是 .NET 提供的换算方法比手动乘DpiX / 96f更稳尤其是在进程不是 PerMonitorV2 感知、但屏幕又缩放的情况下。如果项目还没开 DPI 感知应用清单里的dpiAware设置也要一起确认这部分和控件本身无关但会直接影响观感。5. 避坑与排查下拉不刷新、焦点抢走、勾选丢失这一章是实际替换过程中记录下来的五条问题前三条集中在复合控件路线的下拉面板后两条集中在自绘路线。每条按「现象 → 原因 → 解决」记录遇到同类症状可以直接对号入座。5.1 下拉面板相关的三条记录第一条点一下 CheckBox整个下拉面板立刻消失了。原因是ToolStripDropDown.AutoClose默认是true面板把面板内部的任何一次鼠标点击都当作「用户完成了选择」随即自动关闭。而实际上CheckedListBox的勾选动作发生在点击之后用户看到的就是「勾上了一下面板没了」体验极差多选场景直接报废。解决办法是构造面板时把AutoClose置为false关闭时机改由自己控制控件失焦时关、按 Esc 时关、点击面板外部时关。这三个时机要一起补齐少一个用户就会觉得控件「不听使唤」。补 Esc 的方式是在_list上重写ProcessCmdKey捕获Keys.Escape后主动关闭并把焦点还给显示区。第二条勾了之后文本区没变要再勾一次才把上一次的显示出来。这个现象很有辨识度基本可以锁定为「在ItemCheck事件里直接读了CheckedItems」。ItemCheck的语义是「即将改变」事件触发时内部状态还没提交读到的永远是改动前的集合。表现出来就是回填永远慢半拍第一次勾选因为集合从空变非空会显示成空字符串看着像没反应。解决办法是在ItemCheck里用e.Index和e.NewValue自己算出结果或者用BeginInvoke把读取动作推到消息队列末尾。前者更精确但要自己维护一份状态快照后者更省事但有极短的时序窗口。我在只做展示的场景用BeginInvoke在需要同步写回业务对象的场景用e.NewValue。第三条下拉展开后面板是空白的或者整个跑到窗口左上角去了。ToolStripDropDown第一次Show时如果内部宿主控件还没有尺寸面板会以一个极小的默认尺寸出现在Show指定的相对位置上。如果传入的是屏幕坐标却用了相对定位的重载面板会出现在离控件很远的地方。看起来像「控件没渲染」实际是坐标和尺寸两个参数都错了。处理方式是先给宿主设置明确的Size再调用Show// 先定尺寸再 Show顺序反了会出现面板空白或位置漂移 var host (ToolStripControlHost)_dropDown.Items[0]; host.Size new Size(Width - 2, Math.Min(260, _list.PreferredHeight)); _list.Dock DockStyle.Fill; _dropDown.Show(this, new Point(0, Height), ToolStripDropDownDirection.BelowRight);注意ToolStripControlHost的AutoSize要设成false否则它会被内部控件的首选尺寸反向覆盖你设置的Size白费。5.2 焦点与命中相关的两条记录第四条从下拉面板点回主窗体任意位置要连点两次才生效。面板是独立的顶层窗口展开时抢走了焦点第一次点击被用来「关闭面板」第二次点击才落到目标控件上。这种「明明点了却没反应」的手感比功能缺失更容易被投诉。问题出在消息过滤器的返回值上。如果在PreFilterMessage里关掉面板之后返回true这条WM_LBUTTONDOWN就被吞了目标控件永远收不到。正确做法是返回false让消息继续传递给原本的接收者只是顺手把面板关掉。关面板和放行消息这两件事不冲突很多人第一版写成了return true。第五条自绘路线下点列表空白处会把最后一项勾上。LB_ITEMFROMPOINT的返回值高 16 位表示「坐标不在任何项上」只在列表里点到了有效行时才为 0。如果代码里只取了低 16 位索引不做高位判断点在列表底部的空白区域时会拿到一个越界或最后一项的索引于是最后一项被误勾。修法是先判断高位再判断范围if ((packed 16) 0 index 0 index Items.Count)。另外index是无符号的 16 位值packed 0xFFFF之后不会为负但列表为空时这个索引可能落在 0 附近所以范围判断不能省。5.3 排查顺序先看谁在吃消息这五条我总结出一条通用排查路径带 CheckBox 的 ComboBox 出问题八成出在「消息去哪了」这件事上。先确认点击事件到底被哪个窗口接收了再往下看逻辑。// 临时调试在 WndProc 里打印每条鼠标消息的来源窗口 protected override void WndProc(ref Message m) { if (m.Msg is 0x0200 or 0x0201 or 0x0202) // WM_MOUSEMOVE / DOWN / UP Debug.WriteLine($[{GetType().Name}] msg0x{m.Msg:X4} hwnd0x{m.HWnd:X} self0x{Handle:X}); base.WndProc(ref m); }打出hwnd和self一比就知道消息是从下拉列表窗口来的、还是从控件本体来的、还是根本没进来。如果一条都没打出来问题在上一层Enabled false、被别的控件遮挡、Dock顺序把控件挤成零高度。这条日志我保留在每个自定义控件的调试版本里比断点快得多尤其是涉及跨窗口消息的时候。6. 验收把控件丢进 1000 条数据里跑一遍功能写完只是开始控件类资源最容易翻车的地方在数据量上来之后。我的验收习惯是准备一个 1000 项、其中 300 项默认勾选的测试集把下面四件事各跑一遍任何一项不过都不算交付。第一项是展开耗时。CheckedListBox装 1000 项本身不慢慢的是每次刷新文本时遍历CheckedItems。如果RefreshDisplayText里用了Castobject().Select(...)并且没有做数量截断1000 项全勾的情况下每勾一次就是一次千级遍历。加上MaxInlineDisplay截断之后实际只需要取前两项耗时降到可以忽略。第二项是批量勾选。外部调用「全选」时如果逐项SetItemChecked且每次触发Escape事件界面会冻结几秒_suppressEvent开关就是为这个场景准备的。第三项是键盘可用性。这一点常被忽略但验收时最容易被提。至少覆盖四条路径空格是否切换当前项、上下方向键是否移动高亮、Esc 是否关闭面板并回传焦点、Tab 是否能正常离开控件。最后一条尤其容易坏因为在ToolStripDropDown打开的情况下Form的 Tab 顺序根本轮不到这个控件需要在面板关闭时主动把焦点Focus()回显示区。第四项是高 DPI 下的视觉一致性。验收时至少要在 100% 和 150% 两档缩放下各截一张图对比重点看三处复选框和文字的垂直对齐、长文本是否出现省略号而不是被硬切、下拉面板底部有没有多出一条空白。这三处对应的正是第 3 章里的IntegralHeight、TextFormatFlags.EndEllipsis和第 4 章里的OnMeasureItem。下面这张表是我现在固定会在验收单上勾的项可以直接抄检查项通过标准常见失败表现展开耗时1000 项下点击到面板可见 120ms明显延迟鼠标指针转圈批量勾选全选 300 项不卡顿文本一次刷新界面冻结 1~3 秒键盘操作空格/方向键/Esc/Tab 全部可用Tab 无法离开Esc 无效文本截断超过阈值显示「等 N 项」长文本撑破控件宽度高 DPI100%/150% 下均无错位复选框与文字不齐最后分享一个习惯这个控件我改到第三版才稳定下来前两版的问题都不是功能没写而是「以为写完了就没测」。从那以后我每次改自定义控件都会先把上面那张表跑一遍尤其是 Tab 键和高 DPI 这两项——它们不影响主流程但一定会被用户碰到。希望帮到你。本文还有配套的精品资源点击获取
