QWheelEvent Class

成员函数文档

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 ` 指示该事件是真实事件还是人工（合成）事件。

如果系统配置为反转事件中传递的增量值（例如 macOS 上触控板的自然滚动），则inverted 应为true 。否则，inverted 应为false

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

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

[protected delete] QWheelEvent::QWheelEvent(QWheelEvent &&)

通过移动构造一个QWheelEvent 实例。该函数已被删除。

QPoint QWheelEvent::angleDelta() const

返回滚轮旋转的相对角度，单位为八分之一度。 正值表示滚轮向前旋转（远离用户）；负值表示滚轮向后旋转（朝向用户）。angleDelta().y() 提供自上次事件以来普通垂直鼠标滚轮的旋转角度。angleDelta().x() 提供水平鼠标滚轮的旋转角度（如果鼠标配备水平滚轮）； 否则该值保持为零。部分鼠标允许用户通过倾斜滚轮实现水平滚动，部分触控板也支持水平滚动手势；这些操作同样会显示在 `angleDelta().x()` 中。

大多数鼠标以 15 度为步长工作，在这种情况下，增量值是 120 的倍数；即 120 单位 * 1/8 = 15 度。

然而，有些鼠标的滚轮分辨率更高，发送的 delta 值小于 120 单位（小于 15 度）。 为支持这种情况，您可以将事件中的 delta 值累加，直到累加值达到 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 ）。

另请参阅 pixelDelta()。

bool QWheelEvent::inverted() const

返回事件随附的增量值是否被反转。

通常情况下，如果垂直方向的滚轮顶部远离操作者方向旋转，则会生成一个QWheelEvent ，其增量值为正。同样地，如果水平方向的滚轮顶部向左移动，则会生成一个QWheelEvent ，其增量值为正。

然而，在某些平台上此行为可配置，因此上述相同的操作可能会产生负的delta值（但绝对值相同）。通过inverted属性，滚轮事件处理程序可以选择始终遵循滚轮的旋转方向，无论系统设置如何，但仅限于特定的控件。 （一个典型的用例是：用户旋转滚轮的方向与视觉上的“转盘”旋转方向一致。另一个用例是让滑块手柄始终跟随触摸板上手指的移动方向，而与系统配置无关。）

[override virtual] bool QWheelEvent::isBeginEvent() const

重新实现了：QSinglePointEvent::isBeginEvent() const。

如果该事件的phase()返回Qt::ScrollBegin ，则返回true 。

[override virtual] bool QWheelEvent::isEndEvent() const

重新实现了：QSinglePointEvent::isEndEvent() const。

如果该事件的phase()返回Qt::ScrollEnd ，则返回true 。

[override virtual] bool QWheelEvent::isUpdateEvent() const

重新实现了：QSinglePointEvent::isUpdateEvent() const。

如果该事件的phase()返回值为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 ）。

[protected delete] QWheelEvent &QWheelEvent::operator=(QWheelEvent &&)

将other 通过“移动赋值”操作赋值给此QWheelEvent 实例。该函数已被删除。

[noexcept protected default] QWheelEvent &QWheelEvent::operator=(const QWheelEvent &other)

将other 复制并赋值给此QWheelEvent 实例。