このページでは

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

パブリック型

enum State { Unknown, Stationary, Pressed, Updated, Released }
flags States

プロパティ

公開関数

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::UnknownQt::TouchPointUnknownState状態が不明です。
QEventPoint::StationaryQt::TouchPointStationaryイベントポイントは移動しませんでした。
QEventPoint::PressedQt::TouchPointPressedタッチポイントまたはボタンが押されました。
QEventPoint::UpdatedQt::TouchPointMovedイベントポイントが更新されました。
QEventPoint::ReleasedQt::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.