WINAPI/C++：鼠标悬停子控件无响应的可能原因有哪些？

问题根因 #

标准Win32子控件（包括按钮）的鼠标输入消息（WM_MOUSEMOVE/WM_MOUSEHOVER/WM_MOUSELEAVE）默认直接发送到控件自身的窗口过程，不会路由到父窗口的WndProc：

• 你在父窗口WndProc中写的WM_MOUSEMOVE处理逻辑，只有鼠标落在父窗口未被子控件遮挡的区域时才会触发，移到按钮上时这段逻辑根本不会执行
• 就算你手动给按钮调用了TrackMouseEvent，触发的WM_MOUSEHOVER/WM_MOUSELEAVE消息也会发送给按钮本身，父窗口收不到，所以没有任何反应

推荐解决方案：给目标按钮子类化 #

直接替换按钮的默认窗口过程，在自定义的控件窗口过程中处理鼠标悬停相关逻辑，是最稳定、兼容性最好的实现方式。

实现步骤 #

1. 定义按钮子类的窗口过程，以及子类化相关逻辑：

#include <commctrl.h>
// MSVS环境可直接添加下面的编译指令链接依赖库，也可在项目配置中手动添加comctl32.lib
#pragma comment(lib, "comctl32.lib")

// 按钮子类化的自定义窗口过程
LRESULT CALLBACK ButtonSubProc(HWND hBtn, UINT msg, WPARAM wParam, LPARAM lParam, UINT_PTR subId, DWORD_PTR refData)
{
    static bool isTracking = false;
    switch (msg)
    {
    case WM_MOUSEMOVE:
        if (!isTracking)
        {
            TRACKMOUSEEVENT tme = {sizeof(TRACKMOUSEEVENT)};
            tme.dwFlags = TME_HOVER | TME_LEAVE;
            tme.hwndTrack = hBtn;
            tme.dwHoverTime = HOVER_DEFAULT;
            TrackMouseEvent(&tme);
            isTracking = true;
        }
        break;
    case WM_MOUSEHOVER:
        OutputDebugStringW(L"按钮悬停触发\n");
        MessageBoxW(nullptr, L"进入按钮区域", L"提示", MB_OK);
        // 如果需要通知父窗口处理，可发送自定义消息：SendMessageW(GetParent(hBtn), WM_USER + 100, (WPARAM)hBtn, 0);
        break;
    case WM_MOUSELEAVE:
        isTracking = false;
        OutputDebugStringW(L"按钮离开触发\n");
        MessageBoxW(nullptr, L"离开按钮区域", L"提示", MB_OK);
        break;
    case WM_NCDESTROY:
        // 控件销毁前移除子类化，避免内存泄漏
        RemoveWindowSubclass(hBtn, ButtonSubProc, subId);
        break;
    }
    // 未处理的消息交给按钮默认窗口过程处理
    return DefSubclassProc(hBtn, msg, wParam, lParam);
}

2. 在创建按钮后注册子类化：

hBox = CreateWindowW(WC_BUTTON, L"TEST BOX", WS_TABSTOP | WS_VISIBLE | WS_CHILD, 300, 250, 100, 33, hWnd, (HMENU)IDC_BUTN10, NULL, NULL);
// 给按钮注册子类化，第三个参数为子类ID，多个控件子类化时保证唯一即可
SetWindowSubclass(hBox, ButtonSubProc, 1, 0);

其他可选方案 #

如果需要批量处理多个子控件的悬停逻辑，也可以在父窗口中调用SetCapture捕获全局鼠标输入，每次收到WM_MOUSEMOVE时通过WindowFromPoint接口判断当前鼠标下的控件句柄，自行计算悬停时间触发对应逻辑。但该方案需要手动处理捕获释放边界，容易出现异常，更推荐使用子类化方案。

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