WheelHandler QML Type

このハンドラをアクティブにできるポインティングデバイスのタイプ。

デフォルトでは、このプロパティはPointerDevice.Mouse に設定されており、実際のマウスホイールからのイベントのみに反応するようになっています。

WheelHandler は、acceptedDevices を に設定することで、マウスホイールとタッチパッドの両方のスクロールに反応するようにすることができます。PointerDevice.Mouse | PointerDevice.TouchPad

このプロパティが設定されると、ホイール・イベントに反応するために、指定されたキーボード修飾子が押される必要があり、そうでなければ無視される。

このプロパティがQt.KeyboardModifierMask （デフォルト値）に設定されている場合、WheelHandler は修飾キーを無視する。

例えば、Item は2つのハンドラを持つことができ、1つは必要なキーボード修飾子が押された場合のみ有効になり、もう1つはどの修飾子が押されてもイベントを無視する：

import QtQuick

Rectangle {
    width: 170; height: 120
    color: "green"; antialiasing: true

    WheelHandler {
        property: "rotation"
        acceptedModifiers: Qt.ControlModifier
    }

    WheelHandler {
        property: "scale"
        acceptedModifiers: Qt.NoModifier
    }
}

使用可能な修飾子は以下の通りです：

Qt::KeyboardModifierも参照のこと 。

これは、WheelHandler が最近QWheelEvent を見て、そのプロパティを最新に保ち、そのターゲットをアクティブに操作しているときはいつでも、true を保持します（もしあれば）。

activeTimeout も参照 。

これ以上 wheel イベントを受信しないと、active プロパティがfalse に戻るまでの時間を秒単位で指定します。デフォルトは0.1 (100 ms)。

いくつかのタッチパッドからのイベントなど、WheelHandler がscroll phase 情報を含むイベントを処理する場合、active プロパティはQt::ScrollEnd フェーズのイベントを受信するとすぐにfalse になります。しかし、従来のホイール付きマウスはスクロールフェーズを提供しません。マウスは、ユーザーがスクロールを停止することを決定したときを検出できないため、active プロパティは、この時間が経過した後にfalse に遷移します。

QWheelEvent::phase()も参照してください 。

このハンドラが、その後ろにある他のアイテムやハンドラが同じホイールイベントを処理するのを防ぐかどうか。このプロパティはデフォルトでtrue です。

このプロパティは Qt 6.3 で導入されました。

PointerHandler が無効な場合、すべてのイベントを拒否し、シグナルは発せられません。

QWheelEvent::inverted がtrue の場合、プロパティの変更方向を逆にするかどうか。デフォルトはtrue 。

オペレーティングシステムが、スクロールを指の動きと同じ方向にする「自然スクロール」設定を持っている場合、このプロパティがtrue に設定され、WheelHandler がターゲットのプロパティを直接設定する場合、動きの方向はシステム設定に対応する。このプロパティがfalse に設定されている場合、rotation を反転させ、移動方向が常に指の移動方向と同じになるようにする。

WheelHandler が反応できるparent 項目の境界を超えたマージン。例えば、margin が10 に設定されている場合、カーソルをアイテムの可視エッジから 10 ピクセル外側まで配置しても、ホイールに反応します：

import QtQuick

Rectangle {
    width: 170; height: 120
    color: "green"; antialiasing: true

    WheelHandler {
        property: "rotation"
        margin: 10
    }
}

デフォルト値は0 です。

どのホイールに反応するか。デフォルトはQt.Vertical です。

すべてのマウスにHorizontal ホイールがあるわけではありません。ホイールを横に傾けることでエミュレートされることもあります。タッチパッドは通常、縦方向と横方向の両方のホイールイベントを生成できる。

ハンドラのスコープであるItem 。ハンドラはこのItemに代わってイベントを処理する。つまり、eventPoints の少なくとも1つがItemの内部で発生した場合、ポインタイベントが関連する。最初はtarget() が同じであるが、再割り当てが可能である。

target およびQObject::parent()も参照のこと 。

eventPoint 現在扱われている点。現在扱われている点がない場合、このオブジェクトはデフォルト値（すべての座標が0）にリセットされます。

マウスホ イ ールが回転 さ れた と き にタ ーゲ ッ ト上で変更 さ れ る プ ロ パテ ィ 。

デフォルトはプロパティなし（空文字列）です。ターゲットのプロパティが自動的に変更されない場合、バインディングを使用して任意の方法でマウスホイールの回転に反応させることができます。

任意の数値プロパティを調整するためにマウスホイールを使用することができます。た と えば、property がx に設定 さ れてい る と き は、タ ーゲ ッ トはホイールの回転に伴って水平方向に移動 し ます。以下のプロパティは特別な動作をします：

指定されたターゲットプロパティの調整は、常にrotationScale でスケーリングされる。

このプロパティが最後に設定されたときから、マウスホイールが回転された角度をホイール度で表す。

正の値は、ホイールが上/右に回転されたことを示し、負の値は、ホイールが下/左に回転されたことを示す。

基本的なマウスのクリックホイールは15度単位で動作します。

起動時のデフォルトは0 です。プログラムによっていつでも任意の値に設定することができます。ユーザーがマウスホイールを回転させると、値が調整されます。

orientationも参照のこと 。

rotation プロパティに適用されるスケーリングと、ターゲット・アイテムのproperty に適用されるスケーリング（もしあれば）。デフォルトは 1 で、rotation は回転度単位になります。負の数を設定すると、マウスホイールの回転方向の効果を反転させることができます。

このハンドラが操作するアイテム。

デフォルトでは、ハンドラが宣言されているItem（parent ）と同じである。しかし、あるItem内のイベントを処理し、別のItemを操作するために、ターゲットを別のItemに設定したり、null 、デフォルトの動作を無効にし、代わりに別の動作を行うために、ターゲットを別のItemに設定すると便利な場合がある。

rotation が 15 度変化するたびに、ターゲット scale が乗算される量。これは、property が"scale" のときのみ関係する。

scale にはtargetScaleMultiplier ^{angleDelta *rotationScale / 15} が掛けられる。デフォルトは2 ^1/3 で、これはrotationScale がデフォルト値のままで、マウスホイールが1回 "クリック" (15度) 回転されると、ターゲットがおよそ1.25倍拡大されることを意味します。3回 "クリック" すると、ホイールの回転方向によって、そのサイズは2倍または半分になります。ホイールを2回クリックするごとに2倍または半分にしたい場合は、2 ^1/2(1.4142)に設定します。ホイールの回転方向と逆にスケールさせたい場合は、rotationScale に負の値を設定します。

property が調整されている間、ターゲットがマウスカーソルの位置を中心に変形するように自動的に再配置されるべきかどうか。デフォルトはtrue 。

property が"rotation" に設定され、targetTransformAroundCursor がtrue である場合、ホイールが回転されるにつれて、ターゲットアイテムはマウスカーソルの位置を中心にその場で回転する。targetTransformAroundCursor がfalse の場合、代わりにtransformOrigin を中心に回転する。

このシグナルは、このハンドラがQWheelEvent 型のevent を受信するたびに発行されます : つまり、ホイールが移動されるか、スクロールジェスチャが更新されるたびに発行されます。