QWheelEvent 类

成员函数文档

QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF &globalPos, QPoint pixelDelta, QPoint angleDelta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::ScrollPhase phase, bool inverted, Qt::MouseEventSource source = Qt::MouseEventNotSynthesized, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

构造一个滚轮事件对象。

pos 提供鼠标光标在窗口内的位置。全局坐标下的位置由 globalPos 指定。

pixelDelta 包含屏幕上滚动的像素距离，而 angleDelta 包含滚轮的旋转角度。 pixelDelta 是可选的，可以是 null。

事件发生时鼠标和键盘的状态由 buttons 和 modifiers 指定。

事件滚动的相位由 phase 指定，而 source 表示这个事件是真实的还是人工的（合成的）。

如果系统配置为反转随着事件传递的 delta 值（如 macOS 上触摸板的自然滚动），则 inverted 应为 true。否则，inverted 是 false

指定产生滚轮事件的设备 device。

另请参阅 position()，globalPosition()，angleDelta()，pixelDelta()，phase()，inverted() 以及 device。

QPoint QWheelEvent::angleDelta() const

返回滚轮旋转的相对量，以十分之一度为单位。正值表示滚轮远离用户前旋；负值表示滚轮朝向用户后旋。 angleDelta().y() 提供自上次事件以来通用垂直鼠标滚轮旋转的角度。 angleDelta().x() 提供如果鼠标具有水平滚轮，则水平鼠标滚轮旋转的角度；否则它保持在零。某些鼠标允许用户倾斜滚轮以执行水平滚动，某些触摸板支持水平滚动手势；这也会出现在 angleDelta().x() 中。

大多数鼠标类型以 15 度的步骤工作，在这种情况下，delta 值是 120 的倍数；即，120 个单位 * 1/8 = 15 度。

然而，一些鼠标的轮子分辨率更高，发送的delta值小于120单位（小于15度）。为了支持这种情况，您可以累积添加事件直到值达到120，然后滚动小部件，或者响应每个滚动事件时部分滚动小部件。但是，为了提供更自然的体验，应优先使用可在该平台上使用的pixelDelta()。

示例

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• 即将开始滚动但距离尚未改变（Qt::ScrollBegin），
• 或者滚动已结束且距离不再改变（Qt::ScrollEnd）时，delta可能为null。

另请参阅：pixelDelta。

bool QWheelEvent::inverted() const

返回事件传递的delta值是否被反转。

通常，如果滚轮的顶部远离操作该滚轮的手旋转，则垂直滚轮将产生具有正delta值的QWheelEvent。类似地，如果将滚轮顶部向左移动，则水平滚轮运动将产生具有正delta值的QWheelEvent。

但是，在某些平台上这是可配置的，因此上面描述的相同操作将产生具有相同幅度的负delta值。使用反转属性，轮事件消费者可以选择始终跟随滚轮的方向，不考虑系统设置，但仅适用于特定的小部件。（一个这样的用例是用户正在以与视觉转盘一致的同一方向旋转滚轮。另一个用例是让滑动条的处理器始终按照触摸板的指尖移动方向滚动，而无论系统配置如何。）

[重写虚函数] bool QWheelEvent::isBeginEvent() const

重实现：QSinglePointEvent::isBeginEvent() const.

如果此事件的阶段() 是 Qt::ScrollBegin，则返回 true。

[重写虚函数] bool QWheelEvent::isEndEvent() const

重实现：QSinglePointEvent::isEndEvent() const.

如果此事件的阶段() 是 Qt::ScrollEnd，则返回 true。

[重写虚函数] bool QWheelEvent::isUpdateEvent() const

重实现：QSinglePointEvent::isUpdateEvent() const.

如果此事件的阶段() 是 Qt::ScrollUpdate 或 Qt::ScrollMomentum，则返回 true。

Qt::ScrollPhase QWheelEvent::phase() const

返回此轮事件的滚动阶段。

QPoint QWheelEvent::pixelDelta() const

返回屏幕上的滚动距离（以像素为单位）。此值在支持高分辨率基于像素的增量值的平台上提供，例如 macOS。该值应直接用于在屏幕上滚动内容。

示例

void MyWidget::wheelEvent(QWheelEvent *event)
{
    QPoint numPixels = event->pixelDelta();
    QPoint numDegrees = event->angleDelta() / 8;

    if (!numPixels.isNull()) {
        scrollWithPixels(numPixels);
    } else if (!numDegrees.isNull()) {
        QPoint numSteps = numDegrees / 15;
        scrollWithDegrees(numSteps);
    }

    event->accept();
}

• 即将开始滚动但距离尚未改变（Qt::ScrollBegin），
• 或者滚动已结束且距离不再改变（Qt::ScrollEnd）时，delta可能为null。