HoverHandler QML Type

マウスとタブレットのホバー用ハンドラ。もっと見る...

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

プロパティ

• acceptedDevices : flags
• acceptedModifiers : flags
• acceptedPointerTypes : flags
• active : bool
• blocking : bool (since 6.3)
• cursorShape : Qt::CursorShape
• enabled : bool
• grabPermissions : flags
• hovered : bool
• margin : real
• parent : Item
• point : handlerPoint
• target : Item

信号

• canceled(eventPoint point)
• grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

詳細説明

HoverHandler は、マウスまたはタブレットのスタイラス カーソルのホバリングを検出します。

hovered プロパティへのバインディングは、カーソルがparent アイテムに入ったり出たりしたときに反応する最も簡単な方法です。point プロパティは、カーソル位置など、より詳細な情報を提供します。acceptedDevices 、acceptedPointerTypes 、acceptedModifiers プロパティを使用すると、特定の種類のデバイスのホバリングを検出したり、修飾キーを押している間の動作を絞り込むことができます。

cursorShape プロパティは、hovered がtrue に変わるたびにカーソルを変更することができます。

MouseArea,PointHandler,Qt Quick Examples - Pointer Handlersも参照してください 。

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

acceptedDevices : flags

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

デフォルトでは、このプロパティは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も参照して ください。

acceptedModifiers : flags

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

このプロパティはデフォルトで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も参照のこと 。

acceptedPointerTypes : flags

ポインタハンドラをアクティブにできるポインティングデバイスのタイプ（汎用、スタイラス、消しゴムなど）。

デフォルトでは、このプロパティは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も参照 。

active : bool [read-only]

これは、この入力ハンドラが1つ以上のeventPoints 、それらのポ イントの排他的なグラブに成功することで、それらのハンドラをハンドリングす るための唯一の責任を取ったときはいつでも、true を保持する。これは、この入力ハンドラが、それらのイベントポイントの動きに応じてその プロパティを最新に保ち、target （もしあれば）を積極的に操作してい ることを意味する。

blocking : bool [since 6.3]

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

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

cursorShape : Qt::CursorShape

このプロパティは、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()も参照のこと 。

enabled : bool

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

HoverHandler のparent がdisabled の場合、HoverHandler はデフォルトでホバーイベントに反応し続ける。これは、コントロールが無効化されていても、ホバーフィードバック効果やツールチップが有用な場合があるためです。親が無効になっているときにHoverHandler を無効にしたい場合は、バインディングを追加します：

Item {
    HoverHandler {
        enabled: parent.enabled
    }
}

grabPermissions : flags

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

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

hovered : bool [read-only]

ポインティングデバイスのカーソル（マウスまたはタブレット）が、parent アイテムの境界（もしあれば、margin によって拡張される）内にあるときはいつでも true を保持する。

margin : real

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

デフォルト値は0です。

parent : Item

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

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

point : handlerPoint [read-only]

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

target : Item

このハンドラが操作するItem。

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

シグナルのドキュメント

canceled(eventPoint point)

このハンドラがすでに与えられたpoint をグラブしている場合、グラブが別のポインタハンドラまたはアイテムに奪われると、このシグナルが発せられる。

grabChanged(PointerDevice::GrabTransition transition, eventPoint point)

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

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

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