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()も参照のこと 。

QPoint QWheelEvent::angleDelta() const

ホイールを回転させた相対量を、8 分の 1 度単位で返します。正の値は、ホイールがユーザーから遠ざかる方向に回転されたことを示し、負の値は、ホイールがユーザーに向かって後方に回転されたことを示す。angleDelta().y() は、一般的な垂直方向のマウスホイールが、前のイベント以降に回転された角度を提供する。angleDelta().x() は、マウスに水平方向のホイールがある場合、水平方向のマウスホイールが回転された角度を提供し、そうでない場合はゼロのままである。angleDelta().x()一部のマウスでは、ユーザーがホイールを傾けて水平スクロー ルを行うことができ、一部のタッチパッドは水平スクロールジェスチャをサ ポートしている。

この場合、デルタ値は120の倍数になります。つまり、120単位 * 1/8 = 15度です。

しかし、一部のマウスはより細かい解像度のホイールを持ち、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)。

pixelDelta()も参照 。

bool QWheelEvent::inverted() const

イベントとともに配信されるデルタ値が反転しているかどうかを返します。

通常、ホイールの上部が操作している手から離れて回転している場合、垂直ホイールは正のデルタ値を持つQWheelEvent を生成します。同様に、水平方向のホイールの動きは、ホイールの上部が左に移動している場合、正のデルタ値を持つQWheelEvent を生成する。

ただし、一部のプラットフォームでは、上記と同じ操作で負のデルタ値（ただし、大きさは同じ）を生成するように、これを設定できます。invertedプロパティを使用すると、ホイールイベントコンシューマは、システム設定に関係なく、常にホイールの方向に従うことを選択できます。(このようなユースケースの1つは、ビジュアルタンブラーが回転するのと同じ方向に、ユーザがホイールを回転させる場合です。もう1つの使用例は、システム設定に関係なく、タッチパッド上の指の移動方向にスライダーハンドルを追従させることです)。

[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)。