WheelEvent QML Type

これらのプロパティは、ホイールイベントによって提供された位置の座標を保持する。

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

accepted をtrue に設定することで、ホイールイベントが受信アイテムまたはハンドラより下のアイテムに伝搬されるのを防ぐことができる。

一般的に、アイテムが wheel イベントで動作する場合、積み重ね順の下位のアイテムも同じイベントに反応しないように、それを受け付ける必要があります。

QWheelEvent::acceptedも参照のこと 。

このプロパティは、ホイールが回転した相対的な量を、8 分の 1 度単位で保持する。このプロパティのx とy 座標は、それぞれ水平方向と垂直方向のデルタを保持する。

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

ほとんどのマウスタイプは、15 度のステップで動作する。この場合、デルタ値は120 の倍数、すなわち120 units * 1/8 = 15 degrees となる。

QWheelEvent::angleDelta()も参照 。

このプロパティは、ホイールイベントが生成されたときに押されたマウスボタンを保持する。

のビット単位の組み合わせを含む：

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

QWheelEvent::buttons()も参照 。

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

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

しかし、プラットフォームによっては、上記と同じ操作で負のデルタ値（ただし大きさは同じ）を生成するように設定できます。例えば、QMLコンポーネント（タンブラーやスライダーなど）において、システムの設定に関係なく、アイテムの移動や回転をホイールの方向と同期させることが適切な場合、ホイールイベントハンドラーはinvertedプロパティを使用して、angleDelta とpixelDelta のどちらの値を否定するかを決定することができます。

QWheelEvent::inverted()も参照のこと 。

このプロパティは、イベントが発生する直前に存在したキーボード修飾フラグを保持する。

このプロパティには、以下のビット単位の組み合わせが含まれます：

• Qt.NoModifier - 修飾キーが押されていない。
• Qt.ShiftModifier - キーボードのShiftキーが押されている。
• Qt.ControlModifier - キーボードのCtrlキーが押されている。
• Qt.AltModifier - キーボードのAltキーが押された。
• Qt.MetaModifier - キーボードのMetaキーが押された。
• Qt.KeypadModifier - キーパッドのボタンが押された。

例えば、ホイールイベント中に押されたControlキーに反応する：

WheelHandler {
    onWheel: (wheel)=> {
        if (wheel.modifiers & Qt.ControlModifier) {
            adjustZoom(wheel.angleDelta.y / 120);
        }
    }
}

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

このプロパティは、スクリーンピクセル単位でデルタを保持し、macOSのような高解像度trackpads を持つプラットフォームで利用可能です。このプロパティのx とy 座標は、それぞれ水平方向と垂直方向のデルタを保持する。こ の値は、 画面上の コ ン テ ン ツ を ス ク ロールす る ために直接用い る こ と がで き ます。

high-resolution trackpad をサポートしていないプラットフォームでは、pixelDelta は常に(0,0) となり、代わりにangleDelta を使用する必要があります。

QWheelEvent::pixelDelta()も参照のこと 。