QNativeGestureEvent Class
QNativeGestureEvent クラスには、ジェスチャーイベントを表すパラメータが含まれています。詳細...
| ヘッダー: | #include <QNativeGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | 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 |
保護された関数
| QNativeGestureEvent(QNativeGestureEvent &&) | |
| QNativeGestureEvent & | operator=(QNativeGestureEvent &&) |
| QNativeGestureEvent & | operator=(const QNativeGestureEvent &other) |
詳細な説明
ネイティブのジェスチャーイベントは、通常、トラックパッドのタッチイベントを解釈することで、オペレーティングシステムによって生成されます。ジェスチャーイベントは、ズーム、回転、パンなどの高レベルのイベントです。いくつかのタイプは増分値を保持しています。つまり、value() およびdelta() は、前のイベントと現在のイベントとの差分を提供します。
| イベントタイプ | 説明 | タッチシーケンス |
|---|---|---|
| Qt::ZoomNativeGesture | 拡大率の差分(パーセント)。 | macOS および Wayland:2 本指のピンチ。 |
| Qt::SmartZoomNativeGesture | 拡大・縮小の状態(ブール値)。 | macOS:2本指のダブルタップ(トラックパッド)/1本指のダブルタップ(Magic Mouse)。 |
| Qt::RotateNativeGesture | 回転のデルタ(度単位)。 | macOS および Wayland:2 本指の回転。 |
| Qt::SwipeNativeGesture | スワイプ角度(度単位)。 | macOS:トラックパッド設定で変更可能。 |
| Qt::PanNativeGesture | 変位デルタ(ピクセル単位)。 | Wayland:3 本以上の指をグループとして、任意の方向に動かす。 |
さらに、ジェスチャーイベントストリームの前後に BeginNativeGesture および EndNativeGesture が送信されます:
BeginNativeGesture ZoomNativeGesture ZoomNativeGesture ZoomNativeGesture EndNativeGesture
イベントストリームには、異なる種類のジェスチャーが混在する場合があります。たとえば、2本指のピンチジェスチャーは Zoom イベントと Rotate イベントのストリームを生成し、プラットフォームによっては PanNativeGesture がそれらと混在することもあります。
その他のタイプは単独のイベントです。SmartZoomNativeGesture および SwipeNativeGesture は、ジェスチャーが検出されるたびにそれぞれ 1 回だけ発生します。
注:タッチパッドでは 、2 本の指をまとめて動かす操作(2 本指のフリックジェスチャ)は通常、スクロール用に予約されています。その場合、Qt は QWheelEvents を生成します。これが、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)
device を発生源とし、scenePos におけるジェスチャーを記述する、type 型のネイティブジェスチャーイベントを生成します。このジェスチャーには、fingerCount 本の指が関与しています。
点localPos 、scenePos 、およびglobalPos は、それぞれ、受信ウィジェットまたはアイテム、ウィンドウ、および画面またはデスクトップに対するジェスチャーの位置を指定します。
value には、ジェスチャーに応じた解釈があります。RotateNativeGesture や SwipeNativeGesture の場合、これは度単位の角度を表します。 ZoomNativeGesture の場合、value は増分スケーリング係数であり、通常は 1 よりもはるかに小さい値です。これは、ターゲットアイテムのスケールを次のように調整すべきであることを示しています:item.scale = item.scale * (1 + event.value)
PanNativeGestureの場合、delta は、ビューポート、ウィジェット、またはアイテムを移動またはパンすべき距離をピクセル単位で表します。
この関数は Qt 6.2 で導入されました。
[protected delete] QNativeGestureEvent::QNativeGestureEvent(QNativeGestureEvent &&)
QNativeGestureEvent のインスタンスをMoveコンストラクタで生成します。この関数は削除されています。
[since 6.2] QPointF QNativeGestureEvent::delta() const
前回のイベント以降に移動した距離をピクセル単位で返します。パンジェスチャーでは、ターゲットとなるウィジェット、アイテム、またはビューポートの内容を移動させるべき距離がピクセル単位で指定されます。
この関数は 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
ジェスチャーの値を返します。この値は、ジェスチャーの種類に基づいて解釈する必要があります。たとえば、ズームジェスチャーは拡大率の差分を提供し、回転ジェスチャーは回転角の差分を提供します。
QNativeGestureEvent およびgestureType()も参照してください 。
[protected delete] QNativeGestureEvent &QNativeGestureEvent::operator=(QNativeGestureEvent &&)
other をこのQNativeGestureEvent インスタンスに割り当てます。この関数は削除されます。
[noexcept protected default] QNativeGestureEvent &QNativeGestureEvent::operator=(const QNativeGestureEvent &other)
other をこのQNativeGestureEvent インスタンスにコピーして割り当てます。
© 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.