Back to Qt.io
Contact Us Blog Download Qt

handlerPoint QML Type

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

Import Statement: import QtQuick

プロパティ

詳細説明

ハンドラが所有する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 になります。

注: これはeventPoint と実質的に同じである。しかしeventPoint は、ジェスチャーの間に無効化され、後続のイベント配信のために再利用される、長寿命のQ_GADGET の短命コピーである。そのプロパティへの継続的なバインディングは不可能であり、個々のハンドラは、そのポイントがそのハンドラがハンドリングしているアクティブなジェスチャの一部である期間外は、それに依存することはできません。handlerPointは、ハンドラが所有するQ_GADGET 。これにより、そのプロパティのライフタイム バインディングを行うことができます。

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を持つことになります。

注： 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]

シーン内の掴まれた位置

このポイントがPointer HandlerまたはItemによってグラブされた場合、そのオブジェクトがこのポイントの移動とリリースを処理するための唯一の責任を負うことを意味します。その場合、これはシーングラフの座標系で、グラブが発生した位置である。


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成分を持っていて、この点が動いているとき、少なくともそのうちの1つはゼロでない。これは最近の平均速度を保持する。eventPoint が最近どの方向にどれくらいの速さで移動したかを示す。

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


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.