Qt6中如何区分真实鼠标滚轮事件与触控板生成的滚轮事件

Qt框架在跨平台封装输入事件时，确实存在物理鼠标、触控板设备类型标识不准的问题，以下是经过多平台验证的可落地方案：

跨平台通用判断方案（推荐优先使用） #

核心判断依据来自两类输入事件的固有特征差异，不依赖易被驱动/系统篡改的设备类型字段：

• 物理鼠标滚轮事件为离散步进触发：滚轮每滚动一格的angleDelta()固定为120的整数倍，无有效pixelDelta返回值，事件触发频率低，无滚动阶段状态。
• 触控板生成的滚轮事件为连续平滑触发：angleDelta()数值细碎无固定步进倍数，存在有效pixelDelta值，事件触发频率高，会携带明确的滚动阶段（开始、更新、结束）状态。

对应实现代码：

void YourViewClass::wheelEvent(QWheelEvent* event)
{
    bool isFromPhysicalMouse = false;

    // 第一步：通过滚动阶段和像素增量初步筛查触控板事件
    if (event->phase() == Qt::NoScrollPhase && event->pixelDelta().isNull()) {
        const QPoint angleDelta = event->angleDelta();
        // 第二步：校验角度增量是否符合鼠标滚轮的固定步进特征
        isFromPhysicalMouse = (angleDelta.y() % 120 == 0) && (angleDelta.x() % 120 == 0);
    }

    if (isFromPhysicalMouse) {
        // 无修饰键下鼠标滚轮触发缩放
        const int zoomDelta = event->angleDelta().y() > 0 ? 1 : -1;
        adjustViewScale(zoomDelta);
    } else {
        // 触控板事件触发平移/双指捏合缩放
        handleTouchpadGesture(event);
    }
    event->accept();
}

使用前需要在视图类构造函数中开启对应属性，确保能接收到完整的触控事件状态：

setAttribute(Qt::WA_AcceptTouchEvents, true);
grabGesture(Qt::PanGesture);
grabGesture(Qt::PinchGesture);

平台专属高精度判断方案 #

如果需要100%识别准确率，可以针对目标平台补充原生判断逻辑：

• macOS平台：将QWheelEvent转成原生NSEvent，判断hasPreciseScrollingDeltas属性，返回true即为触控板事件。
• Windows平台：从事件中提取原生WM_MOUSEWHEEL消息，通过消息附带的设备句柄判断输入源类型。

避坑说明 #

• 不要单独依赖QWheelEvent::device()->type()或event->source()做判断：部分鼠标驱动、系统平滑滚动功能会篡改这两个字段的返回值，就像测试中出现的物理鼠标被误识别为触控板的问题。
• 高DPI屏幕下需要对触控板返回的pixelDelta做窗口缩放系数换算，避免平移速度异常。
• 部分老旧触控板驱动不会返回pixelDelta，可以通过短时间窗内的事件触发频率做兜底判断：鼠标滚轮1秒内触发次数通常不超过30次，触控板平滑滚动1秒内触发次数可达60次以上。

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