HoverHandler QML Type

ポインタハンドラを起動できるポインティングデバイスの種類。

デフォルトでは、このプロパティはPointerDevice.AllDevices に設定されています。 デバイスタイプの OR の組み合わせに設定すると、一致しないデバイスからのポインタイベントは無視されます。

例えば、あるアイテムがマウスのホバーに反応するように、そしてスタイラスのホバーに反応するように、2つのハンドラを設定することができます：

import QtQuick

Rectangle {
    width: 150; height: 50; radius: 3
    color: mouse.hovered ? "goldenrod" : stylus.hovered ? "tomato" : "wheat"

    HoverHandler {
        id: stylus
        acceptedDevices: PointerDevice.Stylus
        cursorShape: Qt.CrossCursor
    }

    HoverHandler {
        id: mouse
        acceptedDevices: PointerDevice.Mouse | PointerDevice.TouchPad
        cursorShape: Qt.PointingHandCursor
    }
}

使用可能なデバイスタイプは以下の通りです：

QInputDevice::DeviceTypeも参照のこと 。

このプロパティが設定されている場合、指定されたキーボード修飾子が押された場合のみ、ホバーイベントが処理されます。修飾子がない場合、イベントは無視されます。

このプロパティはデフォルトでQt.KeyboardModifierMask に設定されており、修飾キーに関係なくホバーイベントが処理されます。

例えば、Item は、同じタイプのハンドラを2つ持つことができ、そのうちの1つは、必要なキーボード修飾子が押された場合にのみ有効になります：

import QtQuick

Rectangle {
    width: 150; height: 50; radius: 3
    color: control.hovered ? "goldenrod" : shift.hovered ? "wheat" : "beige"

    HoverHandler {
        id: control
        acceptedModifiers: Qt.ControlModifier
        cursorShape: Qt.PointingHandCursor
    }

    HoverHandler {
        id: shift
        acceptedModifiers: Qt.ShiftModifier
        cursorShape: Qt.CrossCursor
    }
}

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

Qt::KeyboardModifierも参照のこと 。

ポインタハンドラを起動できるポインティング機器の種類（一般的なもの、スタイラス、消しゴムなど）。

デフォルトでは、このプロパティはPointerDevice.AllPointerTypes に設定されています。 デバイスタイプの OR の組み合わせに設定すると、一致しないイベントからのイベントは無視されます。

例えば、スタイラスや消しゴムがグラフィック・タブレットの上にあるかどうかによってカーソルを変化させ、フィードバックを提供することができます：

import QtQuick

Rectangle {
    id: rect
    width: 150; height: 150

    HoverHandler {
        id: stylus
        acceptedPointerTypes: PointerDevice.Pen
        cursorShape: Qt.CrossCursor
    }

    HoverHandler {
        id: eraser
        acceptedPointerTypes: PointerDevice.Eraser
        cursorShape: Qt.BlankCursor
        target: Image {
            parent: rect
            source: "images/cursor-eraser.png"
            visible: eraser.hovered
            x: eraser.point.position.x
            y: eraser.point.position.y - 32
        }
    }
}

使用可能なポインタタイプは以下の通りです：

QPointingDevice::PointerTypeも参照してください 。

このInput Handlerが1つまたは複数のeventPoints 、それらの点の排他的なグラブを成功させることで、それらの点のハンドリングに単独で責任を負うときはいつでも、このtrue が保持されます。これは、このハンドラがそれらのイベントポイントの動きに応じてそのプロパティを最新に保ち、target （もしあれば）を積極的に操作していることを意味する。

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

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

このプロパティは、hovered がtrue で、他のハンドラがそれをオーバーライドしていない場合に表示されるカーソル形状を保持します。

利用可能なカーソル形状は以下の通りです：

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.SizeVerCursor
• Qt.SizeHorCursor
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.BlankCursor
• Qt.SplitVCursor
• Qt.SplitHCursor
• Qt.PointingHandCursor
• Qt.ForbiddenCursor
• Qt.WhatsThisCursor
• Qt.BusyCursor
• Qt.OpenHandCursor
• Qt.ClosedHandCursor
• Qt.DragCopyCursor
• Qt.DragMoveCursor
• Qt.DragLinkCursor

このプロパティのデフォルト値は設定されていないため、同じ親アイテム上でアクティブなハンドラがカーソル形状を決定することができます。このプロパティは、undefined に設定することで初期状態に戻すことができます。

cursorShape が定義されたハンドラがactive の場合、そのカーソルが表示される。そうでない場合、HoverHandler にcursorShape が定義されていれば、そのカーソルが表示される。そうでない場合は、親アイテムの cursor が表示されます。

Qt::CursorShape およびQQuickItem::cursor()も参照のこと 。

PointerHandler が無効になっている場合、すべてのイベントは拒否され、シグナルは発せられない。

このプロパティは、このハンドラのロジックが排他グラブを引き継ぐことを決定したとき、または他のハンドラからグラブの引き継ぎやキャンセルを承認するよう求められたときのパーミッションを指定します。

デフォルトはPointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything で、ほとんどの引き継ぎシナリオを許可しますが、例えば2つのPinchHandlerが同じタッチポイントを取り合うことを避けます。

ポインティングデバイスのカーソル（マウスまたはタブレット）が、parent アイテムの境界内にある場合は、margin によって拡張されます。

eventPoint がこのハンドラをアクティブにできるparent アイテムの境界を超えたマージン。たとえば、target がparent でもあるPinchHandler では、parent が非常に小さなサイズに縮小されてもピンチ・ジェスチャーが可能なように、一般的なユーザーの指の幅の半分以上の距離に設定すると便利です。また、TapHandler ベースのボタンがスクリーンエッジの近くに配置されている場合、フィッツの法則に従うために使用することができます：ボタンが視覚的にエッジから数ピクセル離れていても、スクリーンエッジでのマウスクリックに反応します。

デフォルト値は0です。

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

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

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

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

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

このハンドラがすでに指定されたpoint をグラブしている場合、グラブが別のポインタハンドラまたはItemに奪われると、このシグナルが発行されます。

このシグナルは、このハンドラに関連する何らかの方法でグラブが変更されたときに発行されます。

transition (動詞)は何が起こったかを示す。point (オブジェクト)は、グラブされた、またはグラブされなかったポイントです。

transition の有効な値は以下の通りです：