Windows下鼠标点击窗口无法激活的原因分析

我开发了一个Win32程序，运行初期窗口可正常工作。点击其他窗口使主窗口失活后，再次点击主窗口却无法激活它。注释掉SetCapture(hWnd)函数后，窗口激活功能恢复正常，请问该问题的原因是什么？

最小复现代码 #

#include <Windows.h>
#include <strsafe.h>

const int width = 800;
const int height = 600;
LRESULT CALLBACK WindowProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {
    case WM_MOUSEMOVE:
    {
        const POINTS pt = MAKEPOINTS(lParam);
        // in client region -> log move, and log enter + capture mouse (if not previously in window)
        if (pt.x >= 0 && pt.x < width && pt.y >= 0 && pt.y < height)
        {
            SetCapture(hWnd);
            TCHAR buffer[256];
            StringCchPrintf(buffer, 256, TEXT("xPos: %d, yPos: %d"), pt.x, pt.y);
            SetWindowText(hWnd, buffer);
        }
        // not in client -> log move / maintain capture if button down
        else
        {
            ReleaseCapture();
            SetWindowText(hWnd, TEXT("OnMouseLeave"));
        }
        break;
    }
    case WM_LBUTTONDOWN:
    {
        SetWindowText(hWnd, TEXT("WM_LBUTTONDOWN"));
        break;
    }
    case WM_RBUTTONDOWN:
    {
        SetWindowText(hWnd, TEXT("WM_RBUTTONDOWN"));
        break;
    }
    case WM_LBUTTONUP:
    {
        SetWindowText(hWnd, TEXT("WM_LBUTTONUP"));
        break;
    }
    case WM_RBUTTONUP:
    {
        SetWindowText(hWnd, TEXT("WM_RBUTTONUP"));
        break;
    }
    case WM_CLOSE:
    {
        DestroyWindow(hWnd);
    }
    break;
    case WM_DESTROY:
    {
        PostQuitMessage(0);
    }
    break;
    default:
    {
    }
    }
    return DefWindowProc(hWnd, uMsg, wParam, lParam);
}

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{
    WNDCLASS wc;
    wc.cbClsExtra = 0;
    wc.cbWndExtra = 0;
    wc.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH);
    wc.hCursor = LoadCursor(NULL, IDC_ARROW);
    wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);
    wc.hInstance = hInstance;
    wc.lpfnWndProc = WindowProc;
    wc.lpszClassName = TEXT("main");
    wc.lpszMenuName = NULL;
    wc.style = CS_HREDRAW | CS_VREDRAW;

    RegisterClass(&wc);

    RECT wr;
    wr.left = 100;
    wr.right = width + wr.left;
    wr.top = 100;
    wr.bottom = height + wr.top;
    if (AdjustWindowRect(&wr, WS_CAPTION | WS_MINIMIZEBOX | WS_SYSMENU, FALSE) == 0)
    {
        MessageBox(NULL, TEXT("Error"), TEXT("Error"), MB_OK);
    }
    HWND hWnd = CreateWindow(wc.lpszClassName, TEXT("Windows"), WS_OVERLAPPEDWINDOW,
                             CW_USEDEFAULT,
                             CW_USEDEFAULT,
                             wr.right - wr.left, wr.bottom - wr.top,
                             NULL, NULL, hInstance, NULL);
    if (hWnd == NULL)
    {
        return 0;
    }
    ShowWindow(hWnd, SW_SHOWNORMAL);
    UpdateWindow(hWnd);

    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return 0;
}

程序运行效果 #

• 鼠标捕获的特性干扰激活逻辑：调用SetCapture(hWnd)后，系统会将所有鼠标消息定向到该窗口，即便鼠标移出窗口范围。当窗口处于非激活状态时，这种无条件的捕获会打乱系统的窗口激活流程——系统原本会通过WM_MOUSEACTIVATE消息触发窗口激活，再处理鼠标事件，但捕获提前抢占了鼠标消息处理权，导致激活步骤被跳过。
• 错误的捕获时机：SetCapture的设计初衷是用于需要持续跟踪鼠标的场景（比如拖拽操作），通常在鼠标按下（如WM_LBUTTONDOWN）时调用，操作结束后释放。而当前代码在WM_MOUSEMOVE中只要鼠标进入客户区就调用捕获，完全不符合该API的正确使用场景。

修复建议 #

• 仅在需要持续跟踪鼠标操作时调用SetCapture，比如在WM_LBUTTONDOWN中启用捕获，在WM_LBUTTONUP或操作完成时调用ReleaseCapture释放。
• 若只是需要监听鼠标进入/离开窗口的事件，应使用WM_MOUSEENTER和WM_MOUSELEAVE消息，这类消息是系统专门为该场景设计的，无需手动调用鼠标捕获API。

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