QEventPoint Class
QEventPoint クラスは、QPointerEvent 内の点に関する情報を提供します。詳細...
| ヘッダー: | #include <QEventPoint> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 以下のように: | Qt 6.0 |
パブリック型
プロパティ
|
|
公開関数
| QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition) | |
| QEventPoint(const QEventPoint &other) | |
| QEventPoint(QEventPoint &&other) | |
| ~QEventPoint() | |
| const QPointingDevice * | device() const |
| QSizeF | ellipseDiameters() const |
| QPointF | globalGrabPosition() const |
| QPointF | globalLastPosition() const |
| QPointF | globalPosition() const |
| QPointF | globalPressPosition() const |
| QPointF | grabPosition() const |
| int | id() const |
| bool | isAccepted() const |
| QPointF | lastPosition() const |
| ulong | lastTimestamp() const |
| QPointF | normalizedPosition() const |
| QPointF | position() const |
| QPointF | pressPosition() const |
| ulong | pressTimestamp() const |
| qreal | pressure() const |
| qreal | rotation() const |
| QPointF | sceneGrabPosition() const |
| QPointF | sceneLastPosition() const |
| QPointF | scenePosition() const |
| QPointF | scenePressPosition() const |
| void | setAccepted(bool accepted = true) |
| QEventPoint::State | state() const |
| qreal | timeHeld() const |
| ulong | timestamp() const |
| QPointingDeviceUniqueId | uniqueId() const |
| QVector2D | velocity() const |
| bool | operator!=(const QEventPoint &other) const |
| QEventPoint & | operator=(QEventPoint &&other) |
| QEventPoint & | operator=(const QEventPoint &other) |
| bool | operator==(const QEventPoint &other) const |
メンバ型のドキュメント
enum QEventPoint::State
flags QEventPoint::States
このイベントポイントの状態を指定します。
| 定数 | 値 | 説明 |
|---|---|---|
QEventPoint::Unknown | Qt::TouchPointUnknownState | 状態が不明です。 |
QEventPoint::Stationary | Qt::TouchPointStationary | イベントポイントは移動しませんでした。 |
QEventPoint::Pressed | Qt::TouchPointPressed | タッチポイントまたはボタンが押されました。 |
QEventPoint::Updated | Qt::TouchPointMoved | イベントポイントが更新されました。 |
QEventPoint::Released | Qt::TouchPointReleased | タッチポイントまたはボタンが離されました。 |
States 型は、QFlags<State> の typedef です。State 値の OR 組み合わせを格納します。
プロパティのドキュメント
accepted : bool
このプロパティは、イベントポイントの「受理済み」状態を保持します。
ウィジェットベースのアプリケーションでは、ウィジェットがQInputEvent 全体を受け入れるか拒否するかのみが意味を持つため、このプロパティは使用されません。
一方、Qt Quick では、ItemやEvent Handlerが、QTouchEvent 内のジェスチャーに実際に参加している個々のポイントのみを受け入れ、その他のポイントは他のアイテムやハンドラに配信されるのが一般的です。一貫性を保つため、これはすべてのQPointerEvent に適用され、配信はQPointerEvent 内のすべてのポイントが受け入れられた場合にのみ行われます。
アクセス関数:
| bool | isAccepted() const |
| void | setAccepted(bool accepted = true) |
QEvent::acceptedも参照してください 。
[read-only] device : const QPointingDevice*
このプロパティには、このイベントポイントの発生源となったポインティングデバイスが格納されます。
アクセス関数:
| const QPointingDevice * | device() const |
[read-only] ellipseDiameters : const QSizeF
このプロパティには、タッチポイントのバウンディング楕円の幅と高さが格納されます。
戻り値は論理ピクセル単位です。ほとんどのタッチスクリーンでは接触点の形状を検知できず、マウスやタブレット端末では検出できないため、サイズが null であることが最も一般的です。一部のタッチスクリーンでは、直径が 0 以外で常に等しい場合があります(楕円が円として近似されるため)。
アクセス関数:
| QSizeF | ellipseDiameters() const |
[read-only] globalGrabPosition : const QPointF
このプロパティには、このポイントが取得されたグローバルな位置が格納されます。
グローバル位置は、画面または仮想デスクトップを基準としています。
アクセス関数:
| QPointF | globalGrabPosition() const |
関連項目: globalPosition 、grabPosition 、およびsceneGrabPosition 。
[read-only] globalLastPosition : const QPointF
このプロパティには、前回のクリックまたは移動イベント時の、このポイントのグローバルな位置が格納されます。
グローバル位置は、画面または仮想デスクトップを基準としています。
アクセス関数:
| QPointF | globalLastPosition() const |
関連項目: globalPosition 、lastPosition 、およびsceneLastPosition 。
[read-only] globalPosition : const QPointF
このプロパティは、この点のグローバルな位置を保持します。
グローバル位置は、画面または仮想デスクトップを基準としています。
アクセス関数:
| QPointF | globalPosition() const |
関連項目: globalPressPosition 、position 、およびscenePosition 。
[read-only] globalPressPosition : const QPointF
このプロパティは、このポイントが押された際のグローバルな位置を保持します。
グローバル位置は、画面または仮想デスクトップを基準としています。
アクセス関数:
| QPointF | globalPressPosition() const |
関連項目 :globalPosition 、pressPosition 、およびscenePressPositionも参照してください 。
[read-only] grabPosition : const QPointF
このプロパティには、このポイントがグラブされた位置が格納されます。
この位置は、イベントを受信したウィジェットまたはアイテムを基準としています。
アクセス関数:
| QPointF | grabPosition() const |
関連項目: position 。
[read-only] id : const int
このプロパティには、このイベントポイントのID番号が格納されています。
注: ID番号が0から始まる、あるいは連番であるとは仮定しないでください 。基盤となるドライバの動作方式により、そのような仮定は多くの場合誤りとなります。
アクセス関数:
| int | id() const |
[read-only] lastPosition : const QPointF
このプロパティは、前回のクリックまたは移動イベント時のこのポイントの位置を保持します。
この位置は、イベントを受信したウィジェットまたはアイテムを基準としています。
アクセス関数:
| QPointF | lastPosition() const |
関連項目: ` position ` および `pressPosition`。
[read-only] lastTimestamp : const ulong
このプロパティは、このポイントが含まれていた前回のQPointerEvent からの経過時間を保持します。
アクセス関数:
| ulong | lastTimestamp() const |
「globalLastPosition」も参照してください 。
[read-only] position : const QPointF
このプロパティは、このポイントの位置を保持します。
位置は、イベントを受け取ったウィジェットまたはアイテムを基準としています。
アクセス関数:
| QPointF | position() const |
[read-only] pressPosition : const QPointF
このプロパティは、このポイントが押された位置を保持します。
この位置は、イベントを受け取ったウィジェットまたはアイテムを基準としています。
アクセス関数:
| QPointF | pressPosition() const |
関連項目: position 。
[read-only] pressTimestamp : const ulong
このプロパティは、このポイントが押された最新の時刻を保持しています。
アクセス関数:
| ulong | pressTimestamp() const |
関連項目: timestamp 。
[read-only] pressure : const qreal
このプロパティには、この地点の圧力が格納されます。
戻り値の範囲は、0.0 から1.0 です。
アクセス関数:
| qreal | pressure() const |
[read-only] rotation : const qreal
このプロパティには、この点の角度方向が格納されます。
戻り値は度単位で、0(デフォルト)は指、トークン、またはスタイラスが上を向いていることを示し、負の角度は左に回転していることを、正の角度は右に回転していることを意味します。ほとんどのタッチスクリーンは回転を検知しないため、0が最も一般的な値です。
アクセス関数:
| qreal | rotation() const |
[read-only] sceneGrabPosition : const QPointF
このプロパティには、この点が取得された際のシーン上の位置が格納されます。
シーン位置とは、QQuickItem::event() で処理される場合はQQuickWindow に対する相対位置、QGraphicsItem::touchEvent() のオーバーライドで処理される場合はQGraphicsScene 座標、ウィジェットアプリケーションの場合はウィンドウ上の位置を指します。
アクセス関数:
| QPointF | sceneGrabPosition() const |
関連項目: scenePosition 、grabPosition 、およびglobalGrabPosition 。
[read-only] sceneLastPosition : const QPointF
このプロパティには、前回のクリックまたは移動イベント時の、この点のシーン上の位置が保持されます。
シーン位置とは、QQuickItem::event() で処理される場合は `QQuickWindow ` に対する相対位置、`QGraphicsItem::touchEvent()` のオーバーライドで処理される場合は `QGraphicsScene ` 座標系における位置、あるいはウィジェットアプリケーションの場合はウィンドウ上の位置を指します。
アクセス関数:
| QPointF | sceneLastPosition() const |
scenePosition およびscenePressPositionも参照してください 。
[read-only] scenePosition : const QPointF
このプロパティには、この点のシーン上の位置が格納されます。
シーン位置とは、QQuickItem::event() で処理される場合はQQuickWindow に対する相対位置、QGraphicsItem::touchEvent()のオーバーライドで処理される場合はQGraphicsScene 座標、あるいはウィジェットアプリケーションの場合はウィンドウ上の位置を指します。
アクセス関数:
| QPointF | scenePosition() const |
関連項目: scenePressPosition 、position 、およびglobalPosition 。
[read-only] scenePressPosition : const QPointF
このプロパティには、このポイントが押されたときのシーン位置が格納されます。
シーン位置とは、QQuickItem::event() で処理される場合はQQuickWindow に対する相対位置、QGraphicsItem::touchEvent()のオーバーライドで処理される場合はQGraphicsScene 座標、ウィジェットアプリケーションの場合はウィンドウ上の位置を指します。
アクセス関数:
| QPointF | scenePressPosition() const |
関連項目: scenePosition 、pressPosition 、およびglobalPressPosition 。
[read-only] state : const State
このプロパティには、イベントポイントの現在の状態が格納されます。
アクセス関数:
| QEventPoint::State | state() const |
[read-only] timeHeld : const qreal
このプロパティには、このポイントが押されてから離されていないまでの経過時間(秒単位)が格納されます。
アクセス関数:
| qreal | timeHeld() const |
関連項目: pressTimestamp およびtimestamp 。
[read-only] timestamp : const ulong
このプロパティは、このポイントがQPointerEvent に含まれていた最も新しい時刻を保持します。
アクセス関数:
| ulong | timestamp() const |
関連項目: ` QPointerEvent::timestamp()`。
[read-only] uniqueId : const QPointingDeviceUniqueId
このプロパティには、このポイントまたはトークン(存在する場合)の一意のIDが格納されます。
タッチスクリーンでは指を一意に識別できないため、このプロパティは無効な場合が多い(isValid() を参照)。
QTabletEvent から取得された場合、これは使用中のスタイラスのシリアル番号を識別します。
TUIO ドライバが、それらをサポートするタッチスクリーンで使用されている場合、特定のトークン(基準オブジェクト)を識別することがあります。
アクセス関数:
| QPointingDeviceUniqueId | uniqueId() const |
[read-only] velocity : const QVector2D
このプロパティは、画面またはデスクトップの座標系において、1秒あたりのピクセル単位で表される速度ベクトルを保持します。
注: デバイスの機能に「QInputDevice::Velocity 」が含まれている場合 、速度はオペレーティングシステムから取得されます(おそらくタッチハードウェアやドライバが提供しているものです)。しかし、通常、「Velocity 」機能は設定されておらず、これは速度が Qt によって計算されていることを示しています。Qt は単純なカルマンフィルタを使用して、瞬時値ではなく平滑化された平均速度を提供します。 実質的には、直近の数回のイベントにおいて、ユーザーがこのポイントをどのくらいの速さで、どの方向にドラッグしてきたかを示しており、最も最近のイベントの影響が最も強くなります。
アクセス関数:
| QVector2D | velocity() const |
QInputDevice::capabilities() およびQInputEvent::device()も参照してください 。
メンバ関数のドキュメント
QEventPoint::QEventPoint(int pointId, QEventPoint::State state, const QPointF &scenePosition, const QPointF &globalPosition)
指定されたpointId 、state 、scenePosition 、およびglobalPosition を使用して、イベントポイントを構築します。
[noexcept] QEventPoint::QEventPoint(const QEventPoint &other)
other の浅いコピーを作成して、イベントポイントを構築します。
[constexpr noexcept default] QEventPoint::QEventPoint(QEventPoint &&other)
other を移動させて、イベントポイントを生成します。
[noexcept] QEventPoint::~QEventPoint()
イベントポイントを削除します。
QPointF QEventPoint::normalizedPosition() const
この点の正規化された位置を返します。
座標は、globalPosition() をQInputDevice::availableVirtualGeometry() の空間に変換することで計算されます。つまり、(0, 0) が左上隅、(1, 1) が右下隅となります。
globalPositionも参照してください 。
[noexcept] bool QEventPoint::operator!=(const QEventPoint &other) const
このイベントポイントが `other` と等しくない場合は `true ` を返し、それ以外の場合は `false` を返します。
[noexcept] QEventPoint &QEventPoint::operator=(QEventPoint &&other)
other をこのイベントポイントのインスタンスに割り当てます。
[noexcept] QEventPoint &QEventPoint::operator=(const QEventPoint &other)
このイベントポイントにother を割り当て、このイベントポイントへの参照を返します。
[noexcept] bool QEventPoint::operator==(const QEventPoint &other) const
このイベントポイントが `other` と等しい場合は `true ` を返し、そうでない場合は `false` を返します。
© 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.