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 に応答している間、ポイントは最新に保たれますが、 ポイントが解放された後、または現在のポイントが別のハンドラによって処理されている 場合、position.x とposition.y は 0 になります。

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

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

device : PointerDevice [read-only]

このプロパティは、ポイント（およびそのイベント）が発生したデバイスを保持する。

ellipseDiameters : size [read-only]

このプロパティは、イベントがタッチポイントから発生し、デバイスがこの情報を提供する場合、コンタクトパッチの直径を保持する。

タッチポイントは、指がタッチスクリーンに押し付けられる楕円形の領域としてモデル化されます。(実際にはビットマップとしてモデル化することもできますが、その場合はイベントが送信される前に楕円の境界推定が接触パッチにフィットされることを期待します)。ユーザーが強く押せば押すほど、接触パッチは大きくなります。したがって、これらの直径は、デバイスに別の圧力センサーが含まれていない場合に、圧力を検出する代替方法を提供します。楕円の中心はscenePosition （PointerHandler'Itemのローカル座標では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 項目内の位置

これはparent の境界線に対するeventPoint の位置である。

pressPosition : point [read-only]

parent アイテム内の押された位置

これは、このポイントが押された位置で、parent の境界からの相対位置です。

pressedButtons : enumeration [read-only]

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

MouseArea::pressedButtonsもご参照ください 。

pressure : real [read-only]

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

圧力を測定できる特定のタブレットとタッチスクリーンでのみ有効です。それ以外の場合はゼロになります。

rotation : real [read-only]

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

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

sceneGrabPosition : point [read-only]

シーン内で掴まれた位置

このポイントがポインタハンドラまたはアイテムによってグラブされた場合、そのオブジェクトがこのポイントの移動とリリースの処理を一手に引き受けたことを意味する。その場合、これはシーングラフの座標系で、グラブが発生した位置である。

scenePosition : point [read-only]

シーン内の位置

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

scenePressPosition : point [read-only]

シーン内の押された位置

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

uniqueId : pointingDeviceUniqueId [read-only]

もしあれば、そのポイントのユニークID

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

タッチスクリーンの種類によっては、特にTUIOドライバを使用しているものでは、指に加えて認識可能な物理的なトークン（fiducial object）を使用することが可能です。そのため、このポイントがタッチポイントであり、uniqueIdが設定されている場合、そのようなオブジェクトの識別子になります。

グラフィック・タブレットでは、スタイラスやその他のツールの種類ごとに固有のIDやシリアル番号が設定されていることが多く、ツールごとに異なる方法で対応するのに便利です。

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

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

velocity : vector2d [read-only]

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

これは移動方向を指す速度ベクトルで、1秒あたりの論理ピクセル数で表される。x成分とy成分があり、この点が動いているときは、少なくとも一方はゼロでない。これは最近の平均速度を保持する。eventPoint が最近どの方向にどれくらいの速さで移動したかを示す。

QtQuick::TouchPoint::velocity およびQEventPoint::velocityも参照の こと。