焦点在List控件时触摸滚动触发WM_GESTURE而非WM_MOUSEMOVE问题咨询

问题场景复现 #

我们搭建了一个Win32应用程序（SampleApp.exe），包含List控件和派生自CWnd的自定义子窗口，用来复现实际遇到的触摸滚动问题：

• 当用户选中List控件项使其获得焦点后，在子窗口的垂直滚动区域（参考SampleApp截图）执行触摸PAN/垂直滚动操作时，程序最先收到的是WM_GESTURE消息，而非预期的WM_MOUSEMOVE消息。
• 等待大约5秒后再次执行相同的滚动操作，此时程序就能正常获取到WM_MOUSEMOVE消息。

示例核心代码片段：

// 自定义子窗口的消息处理函数
LRESULT CMyCustomWnd::WndProc(UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
        case WM_GESTURE:
            // 当前会优先触发手势消息处理
            break;
        case WM_MOUSEMOVE:
            // 仅在等待5秒后才会触发
            break;
        // 其他消息处理分支
        default:
            return CWnd::WndProc(message, wParam, lParam);
    }
    return 0;
}

问题根源分析 #

这个现象本质是Windows触摸输入的默认机制导致的：

• 当List控件（系统原生控件）获得焦点后，系统会自动开启触摸手势识别（比如PAN滚动手势），此时触摸操作会先被系统手势识别模块捕获，优先发送WM_GESTURE消息。
• 等待5秒后，系统手势识别模块会触发超时逻辑，释放对触摸输入的捕获，此时触摸操作就会被转化为传统的鼠标消息（WM_MOUSEMOVE）。
• 另外，List控件的焦点状态会影响整个窗口的触摸事件路由，导致自定义子窗口的触摸输入被上层手势处理逻辑拦截。

解决方案 #

针对这个问题，你可以根据实际需求选择以下几种解决思路：

1. 禁用自定义子窗口的手势识别 #

在自定义子窗口的初始化阶段（比如OnCreate函数中），调用SetGestureConfig函数直接禁用手势识别，强制让触摸操作直接转化为鼠标消息：

GESTURECONFIG gc = {0};
gc.dwID = GESTURE_ID_PAN;
gc.dwWant = 0;          // 禁用PAN手势
gc.dwBlock = GESTURECONFIG_ALLGESTURES; // 阻止所有手势类型

BOOL result = SetGestureConfig(m_hWnd, 0, 1, &gc, sizeof(GESTURECONFIG));

2. 手动将WM_GESTURE转化为WM_MOUSEMOVE #

如果需要保留手势功能，也可以在WM_GESTURE消息处理中，提取触摸坐标并手动发送WM_MOUSEMOVE消息，实现两种消息的兼容：

case WM_GESTURE:
    GESTUREINFO gi = {sizeof(GESTUREINFO)};
    if (GetGestureInfo((HGESTUREINFO)lParam, &gi))
    {
        if (gi.dwID == GESTURE_ID_PAN)
        {
            // 提取触摸点坐标并转换为客户端坐标
            POINT pt = {gi.ptsLocation.x, gi.ptsLocation.y};
            ScreenToClient(m_hWnd, &pt);
            // 手动发送WM_MOUSEMOVE消息
            SendMessage(m_hWnd, WM_MOUSEMOVE, 0, MAKELPARAM(pt.x, pt.y));
        }
        CloseGestureInfoHandle((HGESTUREINFO)lParam);
    }
    break;

3. 主动调整焦点状态 #

避免List控件长时间持有焦点，在用户操作自定义子窗口时，主动将焦点转移到子窗口上：

// 在子窗口的触摸按下事件中设置焦点
case WM_TOUCH:
    SetFocus(m_hWnd);
    break;

总结 #

通过禁用手势识别、手动转换消息或调整焦点状态，都可以解决触摸滚动时消息切换的异常问题。你可以根据自己的业务需求选择最合适的方案。

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