qt QWheelEvent详解

1、概述

QWheelEvent是Qt框架中用于处理鼠标滚轮事件的一个类。当用户滚动鼠标滚轮时，Qt会生成一个QWheelEvent事件，并将其发送到相应的窗口或控件。开发者可以通过重载窗口或控件的wheelEvent()方法来响应这个事件，并执行相应的操作，如滚动视图、缩放内容等。

2、重要方法

QWheelEvent类提供了一些方法来获取事件的相关信息：

angleDelta()：返回滚轮滚动的角度差。这个值是一个QPoint对象，其x()和y()分量分别表示水平和垂直滚动的角度差。通常，垂直滚动的角度差更为常用，而水平滚动的角度差可能在一些特定的应用程序中才有用。
pixelDelta()：返回滚轮滚动的像素差。这个值也是一个QPoint对象，其x()和y()分量分别表示水平和垂直滚动的像素差。与angleDelta()相比，pixelDelta()提供了更直接的滚动距离信息，但可能不如angleDelta()跨平台和跨设备的一致性高。
globalPos()：返回滚轮事件的全局位置，即滚轮事件在屏幕上的坐标。
pos()：返回滚轮事件的相对位置，即滚轮事件相对于接收事件窗口或控件的坐标。
buttons()：返回滚轮事件发生时按下的鼠标按钮。这可以用于区分简单的滚轮滚动和结合了鼠标按钮按下的复杂操作。
modifiers()：返回滚轮事件发生时按下的键盘修饰键（如Shift、Ctrl、Alt等）。

3、重要信号

与QResizeEvent类似，QWheelEvent本身并不提供信号。Qt的事件处理机制和信号/槽机制是两种独立的通信方式。QWheelEvent通过事件处理机制传递给相应的窗口或控件，开发者需要在这些对象中重载wheelEvent()方法来处理这个事件。

如果需要在滚轮事件后通知其他对象或执行某些操作，可以在wheelEvent()方法内部使用信号/槽机制或其他通信方式。然而，通常的做法是在wheelEvent()方法中直接处理滚轮事件，因为它是一个低级别的、需要即时响应的用户交互。

#include <QWidget>  
#include <QWheelEvent>  
#include <QLabel>  
#include <QVBoxLayout>  class MyWidget : public QWidget {  Q_OBJECT  public:  MyWidget(QWidget *parent = nullptr) : QWidget(parent) {  QVBoxLayout *layout = new QVBoxLayout(this);  scrollLabel = new QLabel("Scroll to change text", this);  layout->addWidget(scrollLabel);  setLayout(layout);  // 初始化文本滚动位置  scrollPosition = 0;  }  protected:  void wheelEvent(QWheelEvent *event) override {  // 获取滚轮滚动的像素差  int pixelsScrolled = event->angleDelta().y();  // 根据滚动的方向增加或减少滚动位置  if (pixelsScrolled > 0) {  scrollPosition++;  } else if (pixelsScrolled < 0) {  scrollPosition--;  }  // 更新标签文本以显示滚动位置  scrollLabel->setText(QString("Scroll position: %1").arg(scrollPosition));  // 调用基类的wheelEvent方法（虽然在这个例子中不是必需的）  QWidget::wheelEvent(event);  }  private:  QLabel *scrollLabel;  int scrollPosition; // 用于跟踪滚动位置的变量  
};  // 在主程序中使用MyWidget  
#include <QApplication>  int main(int argc, char *argv[]) {  QApplication app(argc, argv);  MyWidget window;  window.show();  return app.exec();  
}