Qt鼠标事件

🖱️ Qt鼠标事件全解析：从基础到实战代码详解

---

引言

在 GUI 开发中，鼠标事件处理是构建交互式应用的核心能力。本文通过一个继承自 QLabel 的自定义控件，完整演示 Qt 框架中各类鼠标事件的处理技巧，涵盖点击、移动、双击、滚轮等场景

---

一、核心代码实现

1. 头文件 label.h

#ifndef LABEL_H
#define LABEL_H

#include <QLabel>
#include <QDebug>
#include <QMouseEvent>
#include <QWheelEvent>

class Label : public QLabel {
    Q_OBJECT
public:
    explicit Label(QWidget *parent = nullptr);
    
    // 鼠标事件重写
    void mousePressEvent(QMouseEvent *event) override;
    void mouseReleaseEvent(QMouseEvent *event) override;
    void mouseDoubleClickEvent(QMouseEvent *event) override;
    void mouseMoveEvent(QMouseEvent *event) override;
    
    // 滚轮事件
    void wheelEvent(QWheelEvent *event) override;

private:
    int total; // 累计滚轮滚动值
};

#endif // LABEL_H

2. 源文件 label.cpp

#include "label.h"

Label::Label(QWidget *parent) 
    : QLabel(parent), total(0) 
{
    this->setMouseTracking(true); // ✨ 启用鼠标移动追踪
}

// 鼠标按下事件
void Label::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        qDebug() << "🖱️ 左键按下";
    } else if (event->button() == Qt::RightButton) {
        qDebug() << "🖱️ 右键按下";
    }
    
    // 输出点击坐标（相对于控件和屏幕）
    qDebug() << "局部坐标:" << event->x() << ", " << event->y();
    qDebug() << "全局坐标:" << event->globalX() << ", " << event->globalY();
}

// 鼠标释放事件
void Label::mouseReleaseEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        qDebug() << "🖱️ 左键释放";
    } else if (event->button() == Qt::RightButton) {
        qDebug() << "🖱️ 右键释放";
    }
}

// 鼠标双击事件
void Label::mouseDoubleClickEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        qDebug() << "🖱️ 左键双击";
    } else if (event->button() == Qt::RightButton) {
        qDebug() << "🖱️ 右键双击";
    }
}

// 鼠标移动事件
void Label::mouseMoveEvent(QMouseEvent *event) {
    qDebug() << "📍 移动坐标:" << event->x() << ", " << event->y();
}

// 滚轮事件
void Label::wheelEvent(QWheelEvent *event) {
    total += event->delta(); // 🎡 累计滚动值
    qDebug() << "🎯 累计滚动:" << total;
}

---

二、关键功能解析

1. 鼠标事件覆盖机制

Qt 通过事件重写实现交互控制，需重写以下关键虚函数：

事件类型	函数名	触发场景
鼠标按下	mousePressEvent	任意按键按下
鼠标释放	mouseReleaseEvent	按键释放
鼠标双击	mouseDoubleClickEvent	快速双击（间隔可配置）
鼠标移动	mouseMoveEvent	光标在控件内移动
滚轮滚动	wheelEvent	滚动滚轮

2. 坐标系统详解

• 局部坐标 (event->x()/y())
  以控件左上角为原点 (0,0)，适合处理控件内相对位置

  qDebug() << "局部坐标:" << event->x() << ", " << event->y();
  

• 全局坐标 (event->globalX()/globalY())
  以屏幕左上角为原点，用于多屏或多窗口交互

  qDebug() << "全局坐标:" << event->globalX() << ", " << globalY();
  

3. 鼠标移动追踪

默认情况下，Qt 仅在按下鼠标时触发移动事件。通过以下设置可启用持续追踪：

this->setMouseTracking(true); // 🚀 构造函数中启用

• 优势：实时获取光标位置（如绘图工具）
• 代价：高频事件可能引发性能问题，需优化处理逻辑

---