QT::鼠标事件简单介绍

引言：

https://github.com/0voice

在图形界面应用开发中，鼠标交互是用户体验的核心组成部分。Qt 框架提供了一套完整的鼠标事件处理机制，让开发者能够轻松捕获和响应用户的鼠标操作。本文将通过一个完整的示例程序，详细介绍 Qt 中鼠标事件的处理方法。

一、Qt 鼠标事件基础

Qt 中的鼠标事件主要通过重写 QWidget 类的事件处理函数来实现，最常用的有以下几个：

mousePressEvent(QMouseEvent *e)：鼠标按键按下时触发
mouseReleaseEvent(QMouseEvent *e)：鼠标按键释放时触发
mouseMoveEvent(QMouseEvent *e)：鼠标移动时触发
mouseDoubleClickEvent(QMouseEvent *e)：鼠标双击时触发

这些事件函数都接收一个QMouseEvent对象作为参数，通过这个对象我们可以获取鼠标的位置、按下的按键等关键信息。

二、完整示例代码解析

下面是一个完整的鼠标事件演示程序，它能够实时显示鼠标位置，并响应鼠标的按下和释放操作。

mainwindow.h

cpp 复制代码

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QLabel>

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

protected:
    // 重写鼠标事件处理函数
    void mouseMoveEvent(QMouseEvent *e) override;
    void mousePressEvent(QMouseEvent *e) override;
    void mouseReleaseEvent(QMouseEvent *e) override;

private:
    QLabel *srtatusLabel;  // 状态标签
    QLabel *mouseLablePos; // 鼠标位置标签
};

#endif // MAINWINDOW_H

mainwindow.cpp

cpp 复制代码

#include "mainwindow.h"
#include <QStatusBar>
#include <QMouseEvent>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    resize(1000, 500);
    setWindowTitle("测试鼠标事件程序");
    
    // 初始化状态标签
    srtatusLabel = new QLabel;
    srtatusLabel->setText("鼠标事件测试");
    
    // 初始化鼠标位置标签
    mouseLablePos = new QLabel;
    mouseLablePos->setText("");
    mouseLablePos->setFixedWidth(200);

    // 状态栏添加窗口小控件
    statusBar()->addPermanentWidget(srtatusLabel);
    statusBar()->addPermanentWidget(mouseLablePos);

    // 启用鼠标实时追踪（即使没有按键按下也能捕获mouseMoveEvent）
    this->setMouseTracking(true);
}

MainWindow::~MainWindow()
{
}

// 鼠标移动事件处理
void MainWindow::mouseMoveEvent(QMouseEvent *e)
{
    // 显示鼠标当前坐标
    mouseLablePos->setText("("
         + QString::number(e->x()) + "," + QString::number(e->y()) + ")");
}

// 鼠标按下事件处理
void MainWindow::mousePressEvent(QMouseEvent *e)
{
    QString qstr = "(" + QString::number(e->x()) + "," +
            QString::number(e->y()) + ")";
    
    // 判断按下的是哪个鼠标按键
    if(e->button() == Qt::LeftButton) {
        statusBar()->showMessage("用户按下了鼠标[左键]坐标" + qstr);
    } else if(e->button() == Qt::RightButton) {
        statusBar()->showMessage("用户按下了鼠标[右键]坐标" + qstr);
    } else if(e->button() == Qt::MidButton) {
        statusBar()->showMessage("用户按下了鼠标[中键]坐标" + qstr);
    }
}

// 鼠标释放事件处理
void MainWindow::mouseReleaseEvent(QMouseEvent *e)
{
    QString qstr = "(" + QString::number(e->x()) + "," +
            QString::number(e->y()) + ")";
    statusBar()->showMessage("用户释放了鼠标坐标" + qstr);
}

三、关键技术点说明

setMouseTracking(true) ：默认情况下，mouseMoveEvent只有在按下鼠标按键并移动时才会触发。调用setMouseTracking(true)后，即使没有按下任何按键，只要鼠标在窗口内移动，就会触发mouseMoveEvent，实现实时追踪。
QMouseEvent 常用方法：
- e->x() / e->y()：获取鼠标相对于当前窗口的坐标
- e->globalX() / e->globalY()：获取鼠标相对于屏幕的全局坐标
- e->button()：获取触发事件的具体鼠标按键（Qt::LeftButton、Qt::RightButton、Qt::MidButton）
- e->buttons()：获取当前按下的所有鼠标按键（用于处理组合按键）
状态栏消息显示：
- statusBar()->showMessage()：在状态栏显示临时消息，默认会自动消失
- statusBar()->addPermanentWidget()：添加永久显示的控件，不会自动消失

四、扩展与应用

除了上述基础事件外，Qt 还提供了更多高级的鼠标交互处理：

滚轮事件 ：通过重写wheelEvent(QWheelEvent *e)处理鼠标滚轮滚动
事件过滤 ：使用installEventFilter()实现更灵活的事件拦截和处理
拖拽操作：结合鼠标事件实现自定义的拖拽功能

掌握鼠标事件处理是 Qt 界面开发的基础技能，通过合理运用这些事件，可以创建出交互丰富、响应及时的用户界面。

总结

Qt 通过重写mousePressEvent、mouseReleaseEvent、mouseMoveEvent等虚函数来处理鼠标事件。
setMouseTracking(true)是实现鼠标实时追踪的关键设置。
QMouseEvent对象包含了鼠标位置、按键状态等关键信息，是处理鼠标事件的核心。