WheelEvent QML Type

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

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

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

詳細説明

マウスの位置はx とy プロパティで知ることができます。

WheelHandler とMouseAreaも参照して ください。

プロパティの説明

accepted : bool

accepted をtrue に設定することで、受け取ったアイテムやハンドラより下のアイテムに wheel イベントが伝搬されるのを防ぐことができます。

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

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 - キーパッドのボタンが押された。

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

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()も参照してください 。