如何在Qt项目中调整鼠标光标移动速度及MouseArea操作灵敏度

方案1：2D界面MouseArea自定义灵敏度（最常用） #

该方案仅作用于当前程序内的MouseArea交互，不会修改系统全局鼠标设置，无性能损耗，适配Qt 5.14及以上所有版本，运行流畅。
实现原理是对鼠标移动偏移量做自定义缩放，代码示例如下：

import QtQuick 2.14

MouseArea {
    id: root
    // 自定义灵敏度属性：1.0为系统默认灵敏度，小于1操作更慢，大于1操作更快
    property real sensitivity: 1.0
    property point lastPressPos: Qt.point(0,0)
    property bool pressState: false

    onPressed: {
        lastPressPos = Qt.point(mouse.x, mouse.y)
        pressState = true
    }
    onReleased: {
        pressState = false
    }
    onPositionChanged: {
        if (!pressState) return
        // 计算原始偏移量
        let rawDeltaX = mouse.x - lastPressPos.x
        let rawDeltaY = mouse.y - lastPressPos.y
        // 应用灵敏度缩放
        let adjustDeltaX = rawDeltaX * sensitivity
        let adjustDeltaY = rawDeltaY * sensitivity
        // 此处替换为自身业务逻辑，例如拖动目标元素移动
        targetItem.x += adjustDeltaX
        targetItem.y += adjustDeltaY
        // 更新坐标基准，使用原始鼠标坐标避免累积误差
        lastPressPos = Qt.point(mouse.x, mouse.y)
    }
}

方案2：Qt3D环境下使用原生MouseDevice属性 #

3D场景可直接调用Qt3D.Input模块内置的灵敏度属性，仅作用于当前3D窗口输入事件：

import Qt3D.Input 2.14

MouseDevice {
    id: sceneMouseDevice
    // 直接设置灵敏度，0.5为默认灵敏度的一半
    sensitivity: 0.5
}
// 关联到3D场景的输入处理器
KeyboardMouseInput {
    mouseDevice: sceneMouseDevice
}

方案3：C++ Widget项目实现方法 #

Widget项目可通过重写控件的鼠标事件实现灵敏度调整，示例代码如下：

// 自定义控件头文件
class CustomWidget : public QWidget
{
    Q_OBJECT
public:
    explicit CustomWidget(QWidget *parent = nullptr);
    // 可自定义调整的灵敏度参数
    qreal sensitivity = 1.0;
protected:
    void mousePressEvent(QMouseEvent *event) override;
    void mouseMoveEvent(QMouseEvent *event) override;
    void mouseReleaseEvent(QMouseEvent *event) override;
private:
    QPoint lastPressPos;
    bool pressState = false;
};

// 实现部分
void CustomWidget::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        lastPressPos = event->pos();
        pressState = true;
    }
    QWidget::mousePressEvent(event);
}

void CustomWidget::mouseMoveEvent(QMouseEvent *event)
{
    if (pressState && (event->buttons() & Qt::LeftButton)) {
        int deltaX = event->x() - lastPressPos.x();
        int deltaY = event->y() - lastPressPos.y();
        // 应用灵敏度后执行业务逻辑，例如移动窗口
        move(pos() + QPoint(deltaX * sensitivity, deltaY * sensitivity));
        lastPressPos = event->pos();
    }
    QWidget::mouseMoveEvent(event);
}

void CustomWidget::mouseReleaseEvent(QMouseEvent *event)
{
    pressState = false;
    QWidget::mouseReleaseEvent(event);
}

注意事项 #

SPI_SETMOUSESPEED属于Windows系统级API，会修改全局鼠标设置，需要管理员权限才能生效，不推荐在单业务程序中使用。

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