handlerPoint QML Type

イベントポイント。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• device : PointerDevice
• ellipseDiameters : size
• id : int
• modifiers : enumeration
• position : point
• pressPosition : point
• pressedButtons : enumeration
• pressure : real
• rotation : real
• sceneGrabPosition : point
• scenePosition : point
• scenePressPosition : point
• uniqueId : pointingDeviceUniqueId
• velocity : vector2d

詳細な説明

QEventPoint の、ハンドラーが所有するQML表現。

ハンドラの現在のpoint またはcentroid のプロパティに対してバインディングを設定することが可能です。例：

import QtQuick

Item {
    width: 640
    height: 480

    DragHandler {
        id: handler
        target: null
    }

    Text {
        color: handler.active ? "darkgreen" : "black"
        text: handler.centroid.position.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1)
        x: handler.centroid.position.x - width / 2
        y: handler.centroid.position.y - height
    }
}

DragHandler がeventPoint に対してアクティブに応答している間は、pointは最新の状態に保たれます。しかし、pointが解放された後、または現在のpointが別のハンドラーによって処理されている場合、position.x およびposition.y は0になります。

SinglePointHandler::point およびMultiPointHandler::centroidも参照してください 。

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

device : PointerDevice [read-only]

このプロパティには、そのポイント（およびそのイベント）の発生元となったデバイスが格納されます。

ellipseDiameters : size [read-only]

このプロパティには、イベントがタッチポイントから発生し、かつデバイスがこの情報を提供している場合、接触領域の直径が格納されます。

タッチポイントは、指がタッチスクリーンに押し付けられている楕円形の領域としてモデル化されます。（実際にはビットマップとしてモデル化することも可能ですが、その場合は、イベントが送信される前に、接触領域に楕円形の境界推定値が適合されることが想定されます。） ユーザーが強く押せば押すほど、接触領域は大きくなります。したがって、デバイスに独立した圧力センサーが搭載されていない場合、これらの直径は圧力を検出する別の手段となります。楕円の中心はscenePosition にあります（PointerHandler のアイテムのローカル座標系ではposition ）。rotation プロパティは、楕円の回転角（既知の場合）を提供します。通常、手は画面上を上方または外側に向かって伸ばす姿勢をとるため、rotation がゼロの場合、height はより長い辺（長軸）になると想定されます。

接触領域が不明の場合、またはデバイスがタッチスクリーンでない場合、これらの値はゼロになります。

QtQuick::TouchPoint::ellipseDiameters およびQEventPoint::ellipseDiametersも参照してください 。

id : int [read-only]

ポイントのID番号

タッチジェスチャーの間、最初の指が押された時点から最後の指が離される時点まで、各タッチポイントには一意のID番号が割り当てられます。同様に、複数のデバイスからの入力が発生した場合（例えば、マウスとタッチの同時操作など）、すべてのデバイスからの現在のeventPoints には一意のIDが割り当てられます。

QEventPoint::idも参照してください 。

modifiers : enumeration [read-only]

現在押されている修飾キー

このプロパティには、イベントが発生した時点で押されていたキーボードの修飾キーが格納されます。

position : point [read-only]

parent 内の位置

これは、`eventPoint `が`parent`の境界に対して持つ位置です。

pressPosition : point [read-only]

parent アイテム内の押下位置

これは、parent の境界を基準として、このポイントが押された位置です。

pressedButtons : enumeration [read-only]

現在、マウスまたはスタイラスのどのボタンが押されているか

「MouseArea::pressedButtons」も参照してください 。

pressure : real [read-only]

このプロパティは、ユーザーがグラフィックタブレット上でスタイラスを押す力、あるいはタッチスクリーン上で指を押す力の強さを表します。値の範囲は、0 （測定可能な圧力なし）から1.0 （デバイスが測定可能な最大圧力）までです。

このプロパティは、筆圧を測定できる特定のタブレットやタッチスクリーンでのみ有効です。それ以外の場合は、値はゼロになります。

rotation : real [read-only]

このプロパティは、グラフィックタブレット上のスタイラスの回転角度、またはタッチスクリーン上のタッチポイントの接触領域の回転角度を保持します。

このプロパティは、回転角度を測定できる特定のタブレット用スタイラスデバイスおよびタッチスクリーンでのみ有効です。それ以外の場合は、0 になります。

sceneGrabPosition : point [read-only]

シーン内での把持位置

この点がポインタハンドラまたはアイテムによってグラブされている場合、そのオブジェクトが、この点の移動および解放の処理を単独で担当していることを意味します。その場合、これはシーングラフの座標系における、グラブが発生した位置となります。

scenePosition : point [read-only]

シーン内での位置

これは、`eventPoint ` が `Qt Quick ` シーンの境界（通常はウィンドウ全体）に対して占める位置です。

scenePressPosition : point [read-only]

シーンス内でのタップ位置

これは、シーングラフの座標系において、このポイントが押された位置です。

uniqueId : pointingDeviceUniqueId [read-only]

そのポイントの一意のID（存在する場合）

通常、これは空欄です。タッチスクリーンでは指を一意に識別できないためです。

一部のタッチスクリーン、特にTUIOドライバを使用するタイプでは、指に加えて、識別可能な物理的なトークン（フィデューシャルオブジェクト）を使用することが可能です。したがって、このポイントがタッチポイントであり、uniqueIdが設定されている場合、それはそのようなオブジェクトの識別子となります。

グラフィックスタブレットでは、スタイラスやその他のツールの種類ごとに一意の ID やシリアル番号が割り当てられていることが多く、ツールごとに異なる反応をさせる場合に役立ちます。

このIDの内容を解釈するには、使用されているハードウェアやドライバに関する知識が必要です。

QTabletEvent::uniqueId およびQtQuick::TouchPoint::uniqueIdも参照してください 。

velocity : vector2d [read-only]

平均速度と移動方向を表すベクトル

これは、移動方向を指す速度ベクトルであり、単位は論理ピクセル/秒です。x成分とy成分を持ち、このポイントが移動しているときは、少なくとも一方の成分が0以外になります。これは直近の平均速度、つまりeventPoint が直近でどのくらいの速さで、どの方向へ移動していたかを表します。

「 QtQuick::TouchPoint::velocity 」および「QEventPoint::velocity 」も参照してください 。