WheelEvent QML Type (Uncreatable)

マウスホイールイベントに関する情報を提供します。詳細...

注：これは作成不可能な型です。QML ではインスタンス化できません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• accepted : bool
• angleDelta : point
• buttons : int
• inverted : bool
• modifiers : int
• pixelDelta : point
• x : real
• y : real

詳細な説明

マウスの位置は、x およびy プロパティを使用して取得できます。

「 WheelHandler 」および「MouseArea 」も参照してください 。

プロパティのドキュメント

accepted : bool

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

一般的に、アイテムがホイールイベントに対して処理を行う場合は、そのイベントを受け入れる必要があります。そうすることで、スタック順が下位のアイテムが同じイベントに反応してしまうのを防ぐことができます。

「QWheelEvent::accepted」も参照してください 。

angleDelta : point [read-only]

このプロパティには、ホイールが回転した相対的な角度が、8分の1度単位で格納されます。このプロパティのx およびy 座標には、それぞれ水平方向および垂直方向の角度の差が格納されます。

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

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

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

buttons : int [read-only]

このプロパティには、ホイールイベントが発生した時点で押されていたマウスボタンが格納されます。

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

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

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

inverted : bool [read-only]

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

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

ただし、一部のプラットフォームではこれを設定可能であり、上記の同じ操作でも負のデルタ値（ただし絶対値は同じ）が生成される場合があります。 たとえば、システム設定に関係なく、項目の移動や回転をホイールの方向と同期させることが適切な QML コンポーネント（タンブラーやスライダーなど）では、ホイールイベントハンドラは `inverted` プロパティを使用して、`angleDelta ` または `pixelDelta ` の値を反転させるかどうかを決定できます。

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

modifiers : int [read-only]

このプロパティには、イベントが発生する直前に存在していたキーボード修飾フラグが格納されます。

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

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

たとえば、ホイールイベント中にCtrlキーが押された場合に反応させるには：

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

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

pixelDelta : point [read-only]

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

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

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

これらのプロパティには、ホイールイベントによって渡された位置の座標が格納されています。

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