4. 鼠标事件：QMouseEvent、鼠标按下/释放/移动、鼠标跟踪

鼠标事件，说白了就是用户跟界面最直接的交互方式。点一下、拖一下、松一下，这些动作背后都是 QMouseEvent 在干活。我刚开始学 Qt 的时候，觉得鼠标事件不就是重写几个函数嘛，后来踩了几个坑才发现，这里面的门道还真不少。

4.1 QMouseEvent 的核心结构

每个鼠标事件都携带了一堆信息。你想想看，系统得告诉你：按了哪个键？在哪个位置？有没有按着 Ctrl？这些数据都封装在 QMouseEvent 里。

成员函数	返回值	说明
pos()	QPoint	鼠标在 widget 内的坐标（相对坐标）
globalPos()	QPoint	鼠标在屏幕上的坐标（绝对坐标）
button()	Qt::MouseButton	触发事件的鼠标按键
buttons()	Qt::MouseButtons	当前按下的所有按键（组合状态）
modifiers()	Qt::KeyboardModifiers	键盘修饰键（Ctrl/Shift/Alt）

这里有个容易混淆的点：button() 和 buttons() 的区别。前者告诉你「这次事件是因为哪个键触发的」，后者告诉你「现在有哪些键被按着」。举个例子，你按住左键不放，再点右键——button() 返回的是右键，而 buttons() 返回的是左键+右键。

4.2 鼠标按下与释放

重写 mousePressEvent() 和 mouseReleaseEvent() 是最基本的操作。我习惯把按下事件当作「动作的起点」，释放事件当作「动作的终点」。

void MyWidget::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        // 记录起始点
        m_lastPoint = event->pos();
        m_isDrawing = true;
        qDebug() << "左键按下，位置：" << m_lastPoint;
    }
}

void MyWidget::mouseReleaseEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        m_isDrawing = false;
        qDebug() << "左键释放，位置：" << event->pos();
    }
}

4.3 鼠标移动与跟踪

默认情况下，只有当你按住鼠标按键时，mouseMoveEvent() 才会被触发。这个设计其实是为了节省性能——你想想看，如果鼠标每动一个像素就发事件，那 CPU 得忙死。

但有些场景需要实时跟踪鼠标位置，比如绘图时的笔迹预览、游戏里的瞄准线。这时候就需要开启「鼠标跟踪」功能。

// 在构造函数中开启
setMouseTracking(true);

void MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    // 现在鼠标不动按键也能收到事件
    QPoint currentPos = event->pos();
    update();  // 触发重绘，显示鼠标位置
}

4.4 鼠标事件的处理流程

事件来了之后，Qt 是怎么找到你的处理函数的？我画了张图，帮你理清这个流程。

这个流程其实很简单：系统产生事件 → Qt 的事件循环收到 → event() 根据事件类型分发 → 最终调用你重写的那个函数。嗯，这里要注意：如果你在 event() 里拦截了事件，那后面的处理函数就不会被调用了。

4.5 实际项目中的常见场景

我整理了几个实际开发中经常遇到的鼠标事件场景，每个都附带了代码片段。

场景一：拖拽绘制矩形

void MyWidget::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton) {
        m_startPoint = event->pos();
        m_endPoint = m_startPoint;
        m_isDragging = true;
    }
}

void MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    if (m_isDragging) {
        m_endPoint = event->pos();
        update();  // 实时更新绘制
    }
}

void MyWidget::mouseReleaseEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton && m_isDragging) {
        m_isDragging = false;
        // 保存最终矩形
        m_rects.append(QRect(m_startPoint, m_endPoint).normalized());
        update();
    }
}

场景二：判断双击与单击

双击事件 mouseDoubleClickEvent() 会在第二次按下时触发。但有个细节：双击之前会先触发一次按下和释放。如果你同时处理单击和双击，需要加个延时判断。

4.6 鼠标跟踪的开关与性能

setMouseTracking(true) 开启后，鼠标每移动一个像素都会触发 mouseMoveEvent。这在某些场景下是必要的，但也要注意性能。

场景	是否开启跟踪	建议
按钮悬停变色	否	用 enterEvent/leaveEvent 更高效
绘图板/白板	是	配合采样或定时器优化
拖拽选择区域	是	只在拖拽过程中处理移动事件
游戏中的瞄准	是	考虑使用 QGraphicsView 的坐标映射

可可精品资料库