如何控制Win32 ListBox按PgUp/PgDn时的跳过条目数量？

Win32 ListBox默认的PgUp/PgDn行为是跳转一整页（当前可见条目数），要自定义跳转幅度，需要通过子类化ListBox并拦截键盘消息来实现，具体步骤如下：

1. 子类化ListBox窗口 #

替换ListBox的窗口过程，捕获并处理键盘消息。可使用SetWindowSubclass函数（需链接comctl32.lib）：

#include <windows.h>
#include <commctrl.h>

// 自定义窗口过程
LRESULT CALLBACK CustomListBoxProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, UINT_PTR uIdSubclass, DWORD_PTR dwRefData)
{
    switch (uMsg)
    {
        case WM_KEYDOWN:
            // 拦截PgUp和PgDn键
            if (wParam == VK_PRIOR || wParam == VK_NEXT)
            {
                int jumpStep = 5; // 此处设置自定义跳转条目数
                int currentSel = SendMessage(hWnd, LB_GETCURSEL, 0, 0);
                int itemCount = SendMessage(hWnd, LB_GETCOUNT, 0, 0);
                
                if (currentSel == LB_ERR) currentSel = 0; // 无选中项时默认从第一项开始
                
                int newSel;
                if (wParam == VK_PRIOR)
                {
                    newSel = currentSel - jumpStep;
                    newSel = newSel < 0 ? 0 : newSel;
                }
                else // VK_NEXT
                {
                    newSel = currentSel + jumpStep;
                    newSel = newSel >= itemCount ? itemCount - 1 : newSel;
                }
                
                // 设置新选中项并滚动到可视区域
                SendMessage(hWnd, LB_SETCURSEL, newSel, 0);
                SendMessage(hWnd, LB_SETTOPINDEX, newSel, 0);
                
                // 返回0表示已处理消息，阻止默认行为
                return 0;
            }
            break;
            
        case WM_DESTROY:
            // 取消子类化
            RemoveWindowSubclass(hWnd, CustomListBoxProc, uIdSubclass);
            break;
    }
    
    // 其他消息交给原窗口过程处理
    return DefSubclassProc(hWnd, uMsg, wParam, lParam);
}

2. 为ListBox设置子类 #

在ListBox创建完成后（或对话框初始化阶段），调用SetWindowSubclass：

// 假设hListBox是你的ListBox句柄
SetWindowSubclass(hListBox, CustomListBoxProc, 0, 0);

注意事项 #

• jumpStep变量可按需调整为任意数值，比如3、5等。
• 若ListBox为多选模式（LBS_MULTIPLESEL），需调整选中逻辑，比如保持原有选中状态仅滚动位置，或批量选中跳转后的条目。
• 确保项目链接comctl32.lib，否则SetWindowSubclass和RemoveWindowSubclass无法正常使用。

内容的提问来源于stack exchange，提问作者NS studios