TapHandler QML Type

このポインタハンドラをアクティブにできるマウスボタン。

デフォルトでは、このプロパティはQt.LeftButton に設定されています。 マウスボタンの OR の組み合わせに設定することができ、他のボタンからのイベントは無視されます。

例えば、コントロールが左クリックと右クリックに異なる方法で反応するように、2つのハンドラを設定することができます：

Item {
    TapHandler {
        onTapped: console.log("left clicked")
    }
    TapHandler {
        acceptedButtons: Qt.RightButton
        onTapped: console.log("right clicked")
    }
}

このポインタハンドラをアクティブにできるポインティングデバイスのタイプ。

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

例えば、マウスやスタイラスのクリックに反応するコントロールと、タッチスクリーンのタップに反応するコントロールを、2つのハンドラで使い分けることができます：

Item {
   TapHandler {
       acceptedDevices: PointerDevice.Mouse | PointerDevice.TouchPad | PointerDevice.Stylus
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedDevices: PointerDevice.TouchScreen
       onTapped: console.log("tapped")
   }
}

このプロパティが設定されると、ポインタ・イベントに反応するために、指定されたキーボード修飾子が押されることを要求し、そうでなければ無視します。

このプロパティがQt.KeyboardModifierMask （デフォルト値）に設定されている場合、PointerHandler は修飾キーを無視します。

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

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier
       onTapped: console.log("control-tapped")
   }
   TapHandler {
       acceptedModifiers: Qt.NoModifier
       onTapped: console.log("tapped")
   }
}

acceptedModifiers を修飾キーの OR の組み合わせに設定した場合、ハンドラを有効にするには、それらの修飾キーがすべて押されなければならないことを意味します：

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier | Qt.AltModifier | Qt.ShiftModifier
       onTapped: console.log("control-alt-shift-tapped")
   }
}

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

複数のハンドラと複数の修飾子フラグの組み合わせで実現できるよりもさらに複雑な動作が必要な場合は、JavaScriptコードで修飾子をチェックできます：

Item {
    TapHandler {
        onTapped:
            switch (point.modifiers) {
            case Qt.ControlModifier | Qt.AltModifier:
                console.log("CTRL+ALT");
                break;
            case Qt.ControlModifier | Qt.AltModifier | Qt.MetaModifier:
                console.log("CTRL+META+ALT");
                break;
            default:
                console.log("other modifiers", point.modifiers);
                break;
            }
    }
}

Qt::KeyboardModifierも参照してください 。

このポインタ・ハンドラをアクティブにできるポインティング・インストゥルメントのタイプ（指、スタイラス、消しゴムなど）。

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

たとえば、マウス、タッチ、スタイラスのクリックには何らかの方法で反応するが、グラフィック・タブレットの消しゴムツールでタップすると自身を削除するようなコントロールを、2つのハンドラで作成することができます：

Rectangle {
   id: rect
   TapHandler {
       acceptedPointerTypes: PointerDevice.Generic | PointerDevice.Finger | PointerDevice.Pen
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedPointerTypes: PointerDevice.Eraser
       onTapped: rect.destroy()
   }
}

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

このプロパティは、active がtrue である間、マウスがparent アイテムの上に置かれるたびに表示されるカーソル形状を保持する。

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

• 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

デフォルト値は設定されていないため、parent アイテムのcursor が表示されます。このプロパティは、undefined に設定することで、同じ初期状態に戻すことができます。

Qt::CursorShape 、QQuickItem::cursor()、HoverHandler::cursorShapeも参照のこと 。

ドラッグ ジェスチャとして扱うために、ユーザーがeventPoint をドラッグしなければならない距離をピクセル単位で指定します。

デフォルト値はプラットフォームと画面解像度によって異なります。undefinedに設定することで、デフォルト値に戻すことができます。ドラッグ ジェスチャが開始したときの動作は、ハンドラによって異なります。

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

singleTapped() とdoubleTapped() シグナルの排他性を決定します。

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

longPressThreshold が経過する前にリリースされなければならないという制約に加えて、タップまたは長押しジェスチャが認識されるための空間的制約。これらの制約が満たされない場合、tapped シグナルは発行されず、tapCount はインクリメントされません。空間的制約に違反した場合、pressed 、保持された時間に関係なく、直ちにtrueからfalseに遷移する。

gesturePolicy は、後述するグラブの動作にも影響する。

Item {
    width: 120; height: 80

    component Button : Rectangle {
        TapHandler {
            id: tapHandler
            gesturePolicy: TapHandler.DragThreshold // the default
            onTapped: tapFlash.start()
        }
    }

    Button { x: 10; y: 10 }
    Button { x: 30; y: 30 }
}

TapHandler {
    id: tapHandler
    gesturePolicy: TapHandler.WithinBounds
    onTapped: tapFlash.start()
}

TapHandler {
    id: tapHandler
    gesturePolicy: TapHandler.ReleaseWithinBounds
    onTapped: tapFlash.start()
}

TapHandler {
    id: menuPopupHandler
    gesturePolicy: TapHandler.DragWithinBounds
    onPressedChanged:
        if (pressed) {
            menu.x = point.position.x - menu.width / 2
            menu.y = point.position.y - menu.height / 2
        } else {
            feedback.text = menu.highlightedMenuItem
            selectFlash.start()
        }
    onCanceled: feedback.text = "canceled"
}

Qt Quick Examples - Pointer Handlersでは、これらの使用例をいくつか示している。

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

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

この値が0 より大きい場合、長押しジェスチャーをトリガーしてlongPressed() シグナルを発するためにeventPoint が押されなければならない時間（秒）を指定します。 この制限時間前にポイントが離された場合、gesturePolicy 制約が満たされていれば、タップを検出できます。longPressThreshold が0 の場合、タイマーは無効になり、信号は発せられない。longPressThreshold がundefined に設定されている場合、代わりにデフォルト値が使用され、このプロパティから読み出すことができます。

デフォルト値は、QStyleHints::mousePressAndHoldInterval （）を秒に変換したものである。

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

デフォルト値は0です。

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

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

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

マウスまたはタッチポイントが押されたときは常に真を保持し、押されてからの動きは現在のgesturePolicy に準拠する。eventPoint が離されるか、ポリシーに違反すると、pressed はfalse に変更されます。

1つのジェスチャーとみなされる時間と空間の制約内で発生したタップの数。ボタンが変更された場合、カウンタは 1 にリセットされます。たとえば、トリプルタップを検出するには、次のように記述します：

Rectangle {
    width: 100; height: 30
    signal tripleTap
    TapHandler {
        acceptedButtons: Qt.AllButtons
        onTapped: if (tapCount == 3) tripleTap()
    }
}

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

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

ドラッグしきい値を超えて移動することなく、押されたポイントが保持されている時間（秒）。これはレンダリングされるフレームごとに少なくとも1回更新され、長押しによってトリガーされるアクションの進行状況を示すアニメーションをレンダリングすることができます。また、長押しの長さに応じて、一連のアクションのいずれかをトリガーすることも可能です。

ゼロ未満の値は、このハンドラのItem 内にポイントが保持されていないことを意味する。

このハンドラがすでに与えられたpoint をつかんでいる場合、このシグナルは、別のポインタハンドラまたはアイテムによってつかみが奪われたときに発行されます。

このシグナルは、parent アイテムが短い時間 (QStyleHints::mouseDoubleClickInterval()) と距離 (QStyleHints::mouseDoubleClickDistance() またはQStyleHints::touchDoubleTapDistance()) の間に 2 回タップされたときに発せられます。このシグナルは常にsingleTapped 、tapped 、tapCountChanged の後に発生する。eventPoint シグナル・パラメータには、タップされたポイントに関するリリース・イベントの情報が含まれ、button はクリックされたmouse button であり、タッチスクリーンではNoButton である。

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

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

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

このシグナルは、longPressThreshold を超える時間、parent アイテムが押されたまま保持されたときに発せられます。つまり、タッチポイントまたはボタンを押されたまま保持し ても、どの動きもドラッグしきい値を超えない場合、timeHeld がlongPressThreshold を超えた時点で、longPressed シグナルが発せられます。

このシグナルは、parent アイテムが1回タップされたときに発せられます。QStyleHints::mouseDoubleClickInterval を超える時間が経過すると、再度タッ プすることができますが、次のタップまでの時間が短い場合、tapCount が増加します。eventPoint シグナル・パラメータには、タップされたポイントに関するリリース・イベントの情報が含まれ、button はクリックされたmouse button であり、タッチスクリーンではNoButton である。

このシグナルは、parent アイテムが（指定された時間と距離の範囲内で）1 回以上タップされたとき、および現在のtapCount が前のtapCount と異なるときに発行される。

このシグナルは、parent アイテムがタップされるたびに発せられます。

つまり、longPressThreshold 未満の時間内にタッチ ポイントまたはボタンを押してから離すと、どの動きもドラッグしきい値を超えないため、離した時点でtapped シグナルが発信されます。eventPoint シグナル・パラメータには、タップされたポイントに関するリリース・イベントの情報が含まれ、button はクリックされたmouse button 、タッチスクリーンではNoButton です。

import QtQuick

Rectangle {
    width: 100
    height: 100

    TapHandler {
        acceptedButtons: Qt.LeftButton | Qt.RightButton
        onTapped: (eventPoint, button)=> console.log("tapped", eventPoint.device.name,
                                             "button", button,
                                             "@", eventPoint.scenePosition)
    }
}