このページでは

TouchPoint QML Type

MultiPointTouchArea におけるタッチポイントを記述する

Import Statement: import QtQuick

プロパティ

詳細説明

TouchPointタイプには、現在の位置、圧力、面積などのタッチポイントに関する情報が含まれます。

プロパティの説明

ellipseDiameters : size [read-only]

このプロパティは、タッチポイントのカバー領域を表す楕円の長軸と短軸を保持する。

pointId : int [read-only]

このプロパティはタッチポイントのポイントIDを保持する。

MultiPointTouchArea 内の各タッチポイントは一意の ID を持ちます。

pressed : bool [read-only]

このプロパティは、タッチポイントが現在押されているかどうかを保持する。

pressure : real [read-only]

velocity : vector2d [read-only]

これらのプロパティは、タッチポイントの現在の状態に関する追加情報を保持する。

  • pressure は0.0から1.0の範囲の値である。
  • velocity はベクトルで、大きさはピクセル毎秒で表されます。

すべてのタッチデバイスが速度をサポートしているわけではありません。速度がサポートされていない場合、0,0として報告されます。

previousX : real [read-only]

previousY : real [read-only]

これらのプロパティは、タッチポイントの以前の位置を保持する。

rotation : real [read-only]

このプロパティは、このタッチポイントの角度の向きを保持する。戻り値は度単位で、ゼロ(デフォルト)は指またはトークンが上を向いていることを示し、負の角度は左に回転していることを、正の角度は右に回転していることを示します。ほとんどのタッチスクリーンは回転を検出しないため、ゼロが最も一般的な値です。

QEventPoint::rotation()も参照のこと

sceneX : real [read-only]

sceneY : real [read-only]

これらのプロパティは、シーン座標におけるタッチポイントの現在位置を保持する。

startX : real [read-only]

startY : real [read-only]

これらのプロパティは、タッチポイントの開始位置を保持する。

uniqueId : pointingDeviceUniqueId [read-only]

このプロパティは、タッチポイントまたはトークンの一意なIDを保持する。

タッチスクリーンは指を一意に識別できないため、通常は空である。しかし、このIDが設定されている場合、特定のトークン(fiducial object)を一意に識別することが期待されます。

このIDの内容を解釈するには、使用されているハードウェアとドライバ(例えば、様々なTUIOベースのタッチサーフェス)の知識が必要です。

x : real [read-only]

y : real [read-only]

これらのプロパティは、タッチポイントの現在位置を保持する。

© 2026 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.