QNativeGestureEvent Class
QNativeGestureEventクラスは、ジェスチャーイベントを記述するパラメータを含んでいます。詳細...
| Header: | #include <QNativeGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Inherits: | QSinglePointEvent |
- 継承されたメンバを含む、すべてのメンバのリスト
- 非推奨メンバー
- QNativeGestureEvent はイベントクラスの一部です。
パブリック関数
(since 6.2) | QNativeGestureEvent(Qt::NativeGestureType type, const QPointingDevice *device, int fingerCount, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, qreal value, const QPointF &delta, quint64 sequenceId = UINT64_MAX) |
(since 6.2) QPointF | delta() const |
(since 6.2) int | fingerCount() const |
| Qt::NativeGestureType | gestureType() const |
| qreal | value() const |
詳細説明
ネイティブのジェスチャ・イベントはオペレーティング・システムによって生成され、通常はトラックパッドのタッチ・イベントを解釈します。ジェスチャ・イベントは、ズーム、回転、パンなどの高レベルのイベントです。つまり、value （）とdelta （）は、前のイベントから現在のイベントまでの差分を提供します。
| イベントタイプ | 説明 | タッチシーケンス |
|---|---|---|
| Qt::ZoomNativeGesture | パーセント単位の倍率の差。 | macOSとWayland：2本指ピンチ。 |
| Qt::SmartZoomNativeGesture | ブール値の拡大状態。 | macOS: 2本指ダブルタップ（トラックパッド）/ 1本指ダブルタップ（マジックマウス）。 |
| Qt::RotateNativeGesture | 回転のデルタ（度単位）。 | macOS および Wayland：2本指回転。 |
| Qt::SwipeNativeGesture | スワイプ角度（度単位）。 | macOS: トラックパッド設定で設定可能。 |
| Qt::PanNativeGesture | ピクセル単位の変位デルタ。 | Wayland：3本以上の指をグループとして任意の方向に動かす。 |
さらに、BeginNativeGestureとEndNativeGestureは、ジェスチャー・イベント・ストリームの前後に送信されます：
BeginNativeGesture ZoomNativeGesture ZoomNativeGesture EndNativeGesture。
例えば、2本指のピンチ・ジェスチャーはZoomとRotateイベントのストリームを生成し、プラットフォームによっては、PanNativeGestureはこれらとインターリーブされることがあります。
その他のタイプは独立したイベントです：SmartZoomNativeGestureとSwipeNativeGestureは、ジェスチャーが検出されるたびに1回だけ発生します。
注: タッチパッドでは、2 本の指を 1 つのグループとして動かすジェスチャ（2 本指フリック）は通常、スクロールのために予約されています。このため、PanNativeGestureを生成するには3本以上の指が必要になります。
Qt::NativeGestureType,QGestureEvent,QWheelEventも参照して ください。
メンバ関数の説明
[since 6.2] QNativeGestureEvent::QNativeGestureEvent(Qt::NativeGestureType type, const QPointingDevice *device, int fingerCount, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, qreal value, const QPointF &delta, quint64 sequenceId = UINT64_MAX)
fingerCount の指が関与するscenePos でのジェスチャーを記述するdevice を起点とするtype タイプのネイティブ ジェスチャー イベントを構築します。
ポイントlocalPos 、scenePos 、globalPos は、それぞれ、受信ウィジェットまたはアイテム、ウィンドウ、画面またはデスクトップに対するジェスチャ位置を指定します。
value RotateNativeGesture または SwipeNativeGesture の場合は、度単位の角度です。ZoomNativeGestureの場合、 は増分スケーリング係数で、通常は1よりずっと小さいです。ターゲットアイテムが次のようにスケールを調整する必要があることを示します： item.scale = item.scale * (1 + event.value)value
PanNativeGestureでは、delta 、ビューポート、ウィジェット、またはアイテムが移動またはパンされるべき距離をピクセル単位で示します。
注: delta は単精度 (QVector2D) で保存されるため、delta() は、場合によっては若干異なる値を返すかもしれません。これは Qt の将来のバージョンで変更される可能性があります。
この関数は Qt 6.2 で導入されました。
[since 6.2] QPointF QNativeGestureEvent::delta() const
前のイベントからの移動距離をピクセル単位で返します。Pan ジェスチャは、ターゲットのウィジェット、アイテム、またはビューポートのコンテンツを移動する距離をピクセル単位で返します。
この関数は Qt 6.2 で導入されました。
QPanGesture::delta()も参照してください 。
[since 6.2] int QNativeGestureEvent::fingerCount() const
既知の場合、ジェスチャに参加している指の数を返します。gestureType() がQt::BeginNativeGesture またはQt::EndNativeGesture の場合、多くの場合この情報は不明で、fingerCount() は0 を返します。
この関数は Qt 6.2 で導入されました。
Qt::NativeGestureType QNativeGestureEvent::gestureType() const
ジェスチャの種類を返します。
qreal QNativeGestureEvent::value() const
ジェスチャの値を返します。この値は、ジェスチャのタイプに基づいて解釈する必要があります。例えば、Zoom ジェスチャはスケール・ファクタのデルタを返し、Rotate ジェスチャは回転のデルタを返します。
QNativeGestureEvent およびgestureType()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
