Qt中的鼠标事件和滚轮事件（附带实例）

在 Qt 中，QMouseEvent 类用来表示一个鼠标事件，在窗口部件中按下鼠标或者移动鼠标指针时，都会产生鼠标事件。

利用 QMouseEvent 类可以获知鼠标是哪个键按下了、鼠标指针的当前位置等信息。一般是通过重定义部件的鼠标事件处理函数来进行一些自定义的操作。

QWheelEvent 类用来表示鼠标滚轮事件，在这个类中主要是获取滚轮移动的方向和距离。

下面我们看一个实际的例子，实现的效果是：可以在界面上按住鼠标左键来拖动窗口，双击鼠标左键来使其全屏，按住鼠标右键则使指针变为一个自定义的图片，而使用滚轮可以放大或者缩小编辑器中的内容。

新建 Qt Widgets 应用，项目名称为 mymouseevent，基类选择 QWidget，类名保持 Widget 不变。在设计模式中向界面上拖入一个 Text Edit。在 widget.h 文件中进行 protected 函数声明：

protected:
    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;

再添加一个私有位置变量：

QPointF offset; // 用来储存鼠标指针位置与窗口位置的差值

然后到 widget.cpp 文件中，添加头文件 #include <QMouseEvent>，并在构造函数中添加代码：

QCursor cursor;                        // 创建光标对象
cursor.setShape(Qt::OpenHandCursor);   // 设置光标形状
setCursor(cursor);                     // 使用光标

这几行代码可以使鼠标指针进入窗口后改为小手掌形状，Qt 提供了常用的鼠标指针的形状，可以在帮助中通过 Qt::CursorShape 关键字查看。

下面添加几个事件处理函数的定义：

void Widget::mousePressEvent(QMouseEvent *event) // 鼠标按下事件
{
   if(event->button() == Qt::LeftButton){        // 如果是鼠标左键按下
      QCursor cursor;
      cursor.setShape(Qt::ClosedHandCursor);
      QApplication::setOverrideCursor(cursor);   // 使鼠标指针暂时改变形状
      offset = event->globalPosition() - pos();  // 获取指针位置和窗口位置的差值
   }
   else if(event->button() == Qt::RightButton){  // 如果是鼠标右键按下
      QCursor cursor(QPixmap("../mymouseevent/logo.png"));
      QApplication::setOverrideCursor(cursor);   // 使用自定义的图片作为鼠标指针
   }
}

在鼠标按下事件处理函数中，先判断是哪个按键按下，如果是鼠标左键按下，那么就更改指针的形状，并且存储当前指针位置与窗口位置的差值。这里使用了 globalPosition() 函数来获取鼠标指针的位置，这个位置是指针在桌面上的位置，因为窗口的位置就是指它在桌面上的位置。另外，还可以使用 QMouseEvent 类的 position() 函数获取鼠标指针在窗口中的位置。如果是鼠标右键按下，那么就将指针显示为自定义的图片。

void Widget::mouseMoveEvent(QMouseEvent *event) // 鼠标移动事件
{
   if(event->buttons() & Qt::LeftButton){       // 这里必须使用buttons()
      QPointF temp;
      temp = event->globalPosition() - offset;
// 用鼠标指针当前的位置减去差值，就得到了窗口应该移动的位置
      move(temp.x(), temp.y());
   }
}

在鼠标移动事件处理函数中，先判断是不是鼠标左键按下，如果是，那么就使用前面获取的差值来重新设置窗口的位置。因为在鼠标移动时，会检测所有按下的键，而这时使用 QMouseEvent 的 button() 函数无法获取哪个按键被按下，只能使用 buttons() 函数，所以这里使用 buttons() 和 Qt::LeftButton 进行按位与的方法来判断是不是鼠标左键按下。

void Widget::mouseReleaseEvent(QMouseEvent *event) // 鼠标释放事件
{
   Q_UNUSED(event);
   QApplication::restoreOverrideCursor();         // 恢复鼠标指针形状
}

在鼠标释放函数中进行了恢复鼠标形状的操作，这里使用的 restoreOverrideCursor() 函数要和前面的 setOverrideCursor() 函数配合使用。

void Widget::mouseDoubleClickEvent(QMouseEvent *event) // 鼠标双击事件
{
   if(event->button() == Qt::LeftButton){              // 如果是鼠标左键按下
      if(windowState() != Qt::WindowFullScreen)        // 如果现在不是全屏
         setWindowState(Qt::WindowFullScreen);         // 将窗口设置为全屏
      else setWindowState(Qt::WindowNoState);          // 否则恢复以前的大小
   }
}

在鼠标双击事件处理函数中，使用 setWidowState() 函数来使窗口处于全屏状态或者恢复以前的大小。

void Widget::wheelEvent(QWheelEvent *event)           // 滚轮事件
{
   if(event->angleDelta().y() > 0){                   // 当滚轮远离使用者时
      ui->textEdit->zoomIn();                         // 进行放大
   }else{                                             // 当滚轮向使用者方向旋转时
      ui->textEdit->zoomOut();                        // 进行缩小
   }
}

在滚轮事件处理函数中，使用 QWheelEvent 类的 angleDelta().y() 函数获取了垂直滚轮移动的距离，每当滚轮旋转一下，默认是 15°，这时 delta() 函数就会返回 15×8 即整数 120。

当滚轮向远离使用者的方向旋转时，返回正值；当向靠近使用者的方向旋转时，返回负值。这样便可以利用这个函数的返回值来判断滚轮的移动方向，从而进行编辑器中内容的放大或者缩小操作。如果鼠标还有水平滚轮，可以使用 angleDelta().x() 来获取移动距离。

这时运行程序，进行双击、按下鼠标右键等操作，看一下具体的效果。程序中使用了图片，所以还要往源码目录中添加一张图片。另外，默认是当按下鼠标按键时移动鼠标，鼠标移动事件才会产生，如果想不按鼠标按键，也可以获取鼠标移动事件，那么就要在构造函数中添加下面一行代码：

setMouseTracking(true);

这样便会开启窗口部件的鼠标跟踪功能。

Qt中的鼠标事件和滚轮事件（附带实例）

相关文章