MultiPointTouchArea QML Type

これらのプロパティは、タッチ領域が扱うタッチ点の範囲を保持します。

これらのプロパティは、例えば、入れ子になった MultiPointTouchAreas を持ち、1 つは 2 本の指のタッチを処理し、もう 1 つは 3 本の指のタッチを処理することができる便利なものです。

デフォルトでは、タッチ領域内のすべてのタッチポイントが処理されます。

mouseEnabled たとえば、maximumTouchPoints が 2 の場合、マウスを 1 つのタッチ ポイントとして使用し、指をもう 1 つのタッチ ポイントとして使用して、合計 2 つのタッチ ポイントを使用できます。

このプロパティは、MultiPointTouchArea がマウス・イベントも処理するかどうかを制御します。true（デフォルト）の場合、タッチエリアはマウスを1つのタッチポイントと同じように扱います。falseの場合、タッチエリアはマウスイベントを無視し、下にある他のアイテムで扱えるように「通過」させます。

このプロパティは、バインド可能なユーザー定義のタッチポイントオブジェクトのセットを保持します。

mouseEnabled （デフォルト）がtrueで、マウスがタッチ・エリア上にあるときにマウスの左ボタンが押されると、現在のマウス位置がこれらのタッチ・ポイントの1つになります。

以下の例では、2つの小さな矩形がタッチポイントに続いています。

import QtQuick

Rectangle {
    width: 400; height: 400
    MultiPointTouchArea {
        anchors.fill: parent
        touchPoints: [
            TouchPoint { id: point1 },
            TouchPoint { id: point2 }
        ]
    }

    Rectangle {
        width: 30; height: 30
        color: "green"
        x: point1.x
        y: point1.y
    }

    Rectangle {
        width: 30; height: 30
        color: "yellow"
        x: point2.x
        y: point2.y
    }
}

デフォルトでは、このプロパティは空のリストを保持します。

TouchPointも参照してください 。

このシグナルは、タッチイベントの処理が他のアイテムに奪われ、新しいタッチイベントがキャンセルされたときに発行されます。

このシグナルは上級者向けです。入力を処理するMultiPointTouchArea が複数ある場合や、Flickable の中にMultiPointTouchArea がある場合に便利です。後者の場合、onPressed シグナルハンドラで何らかのロジックを実行してからドラッグを開始すると、Flickable がMultiPointTouchArea からタッチ処理を奪う可能性があります。 このような場合、MultiPointTouchArea がFlickable にタッチ処理を奪われたときにロジックをリセットするには、released に加えてcanceled も処理する必要があります。

touchPoints はキャンセルされたポイントのリストである。

onCanceled: (points) => console.log("canceled", points.length)

このシグナルは、グローバルドラッグのしきい値に達したときに発行されます。

このシグナルは通常、MultiPointTouchArea が Flickable や他のMultiPointTouchArea にネストされている場合に使用されます。閾値に達してシグナルが処理されると、タッチ領域が現在のタッチポイントをつかむかどうかを決定できます。デフォルトでは、タッチ点はつかまれません。タッチ点をつかむには、gesture.grab() を呼び出します。ジェスチャーが掴まれない場合、例えば入れ子になっているFlickableも掴まれる機会があります。

gesture オブジェクトには、現在のtouchPoints とdragThreshold のセットに関する情報も含まれます。

このシグナルは新しいタッチポイントが追加されたときに発せられる。touchPoints はこれらの新しいポイントのリストである。

minimumTouchPoints が1より大きい値に設定されている場合、必要なタッチポイントの最小数に達するまで、このシグナルは発せられない。

onPressed: (points) => console.log("pressed", points.length)

このシグナルは既存のタッチポイントが削除されたときに発せられます。touchPoints は削除されたタッチポイントのリストです。

onReleased: (points) => console.log("released", points.length)

このシグナルはMultiPointTouchArea が扱うタッチポイントが変更されたときに発せられます。これには新しいタッチポイントの追加、以前のタッチポイン トの削除やキャンセル、現在のタッチポイントデータの更新などが含まれる。touchPoints は現在のすべてのタッチポイントのリストである。

このシグナルは既存のタッチポイントが更新されたときに発行されます。touchPoints は更新されたタッチポイントのリストです。

onUpdated: (points) => console.log("updated", points.length)