如何实现columns>0时CheckListBox控件的垂直滚动功能

WinForm平台下的CheckListBox继承自ListBox，当Columns属性大于0时，底层逻辑会强制切换为多列水平布局模式，默认禁用垂直滚动、只响应水平滚动，这个是控件原生写死的行为，可以通过以下几种方案实现需求：

方案1：Windows消息拦截轻量Hack #

这个方案不需要重写整个控件的绘制逻辑，侵入性最低，适合快速修改现有项目的问题：

• 核心逻辑：拦截控件收到的垂直滚动相关Windows消息，绕开基类对多列模式下垂直滚动的屏蔽，手动通过TopIndex属性控制内容偏移。
• 实现步骤：
  • 自定义一个继承自CheckListBox的控件类，重写WndProc方法，拦截消息码为0x115（即WM_VSCROLL）的垂直滚动消息，不要交给基类处理。
  • 根据消息携带的滚动类型（行滚动、页滚动、滚动条拖动），计算对应的目标TopIndex值，手动赋值实现内容滚动。
  • 控件初始化时调用Win32接口ShowScrollBar，传入SB_VERT参数强制显示垂直滚动条，同时拦截滚动条拖动消息同步更新位置。
• 核心实现代码参考：

public class MultiColumnCheckListBox : CheckedListBox
{
    private const int WM_VSCROLL = 0x115;
    private const int SB_LINEUP = 0;
    private const int SB_LINEDOWN = 1;
    private const int SB_PAGEUP = 2;
    private const int SB_PAGEDOWN = 3;
    private const int SB_THUMBTRACK = 5;

    protected override void WndProc(ref Message m)
    {
        if (Columns > 0 && m.Msg == WM_VSCROLL)
        {
            int scrollAction = m.WParam.ToInt32() & 0xFFFF;
            int perColVisibleCount = ClientSize.Height / ItemHeight;
            int maxValidTop = Math.Max(0, Items.Count - perColVisibleCount * Columns);
            switch (scrollAction)
            {
                case SB_LINEUP:
                    TopIndex = Math.Max(0, TopIndex - 1);
                    break;
                case SB_LINEDOWN:
                    TopIndex = Math.Min(maxValidTop, TopIndex + 1);
                    break;
                case SB_PAGEUP:
                    TopIndex = Math.Max(0, TopIndex - perColVisibleCount);
                    break;
                case SB_PAGEDOWN:
                    TopIndex = Math.Min(maxValidTop, TopIndex + perColVisibleCount);
                    break;
                case SB_THUMBTRACK:
                    int thumbPos = (m.WParam.ToInt32() >> 16) & 0xFFFF;
                    TopIndex = thumbPos * maxValidTop / 100;
                    break;
            }
            return;
        }
        base.WndProc(ref m);
    }

    protected override void OnHandleCreated(EventArgs e)
    {
        base.OnHandleCreated(e);
        // 强制显示垂直滚动条
        ShowScrollBar(Handle, 1 /*SB_VERT*/, true);
    }

    // 引入Win32 API
    [System.Runtime.InteropServices.DllImport("user32.dll")]
    private static extern bool ShowScrollBar(IntPtr hWnd, int wBar, bool bShow);
}

方案2：自定义多列布局的正规实现 #

如果不想用消息Hack，追求长期稳定的效果，可以完全接管控件的布局逻辑：

• 把原生Columns属性固定设为0，禁用自带的多列模式，此时控件原生的垂直滚动条可以正常工作。
• 重写OnMeasureItem、OnDrawItem方法，按照自己设定的列数、列宽，手动计算每个项的排列位置（默认排列逻辑和原生多列一致：纵向排满一列再排下一列），自行绘制复选框、项文本、焦点框。
• 重写鼠标点击、键盘导航的命中测试逻辑，判断输入位置对应的项索引，触发选中状态切换。
• 这个方案的优点是没有消息兼容问题，滚动行为和原生完全一致，还可以自定义列间距、项边距等样式，缺点是需要处理的绘制细节较多。

方案3：嵌套容器快速实现 #

如果项目工期紧、项数量不大，可以用嵌套容器的方式绕开控件本身的限制：

• 外层放置一个Panel控件，开启AutoScroll属性，根据总项数、列数、项高度计算内容总高度，赋值给Panel的AutoScrollMinSize。
• 内层放置原生CheckListBox，设置对应Columns值，把控件的高度调整为足够容纳单列所有项的高度，关闭CheckListBox自身的所有滚动条。
• 直接通过外层Panel的滚动条实现垂直滚动，不需要修改CheckListBox的逻辑。
• 这个方案实现最快，少量代码就能搞定，缺点是项数超过1000条时会因为CheckListBox一次性加载所有项出现性能卡顿，适合小数据量场景。

注意：如果用第一种Hack方案，记得在控件大小变化、列宽变化、项集合增减时，重新计算最大有效TopIndex，避免出现滚动错位、选中项偏移的问题。

内容的提问来源于stack exchange，提问作者Svetlana M