QGesture Class

QGesture クラスはジェスチャーを表し、対応するユーザー入力を記述するプロパティを含んでいます。詳細...

ヘッダー #include <QGesture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
を継承する: QObject
によって継承される:

QPanGesture,QPinchGesture,QSwipeGesture,QTapAndHoldGesture, およびQTapGesture

パブリックタイプ

enum GestureCancelPolicy { CancelNone, CancelAllInContext }

プロパティ

パブリック機能

QGesture(QObject *parent = nullptr)
virtual ~QGesture()
QGesture::GestureCancelPolicy gestureCancelPolicy() const
Qt::GestureType gestureType() const
bool hasHotSpot() const
QPointF hotSpot() const
void setGestureCancelPolicy(QGesture::GestureCancelPolicy policy)
void setHotSpot(const QPointF &value)
Qt::GestureState state() const
void unsetHotSpot()

詳細説明

ジェスチャーオブジェクトは開発者が直接作成することはできません。アプリケーションに登録されているQGestureRecognizer オブジェクトによって作成されます。QGestureRecognizer::registerRecognizer() を参照してください。

Qt におけるジェスチャ処理の概要と、アプリケーションでジェスチャを使用するための情報については、「ウィジェットとグラフィックスビューにおけるジェスチャ」を参照してください。

ジェスチャのプロパティ

このクラスには、ユーザがジェスチャ固有の引数を取得するためにクエリできるプロパティのリストがあります。たとえば、ピンチ・ジェスチャーにはスケール・ファクタがあり、プロパティとして公開されています。

カスタムジェスチャレコグナイザの開発者は、ジェスチャに関する追加情報を提供するためにプロパティを追加できます。これは、QGesture オブジェクトに新しいダイナミック・プロパティを追加するか、QGesture クラス(またはそのサブクラスの 1 つ)をサブクラス化することによって行うことができます。

ジェスチャー・オブジェクトのライフサイクル

QGesture インスタンスは必要なときに暗黙的に生成され、Qt によって所有されます。Qt は特定のインスタンスを破棄し、それに代わる新しいインスタンスを作成することがあります。

登録されたジェスチャ・レコグナイザは、recognize ()関数を介してターゲット・オブジェクトの入力イベントを監視し、必要に応じてジェスチャ・オブジェクトのプロパティを更新します。

対応するジェスチャがアクティブな場合、またはキャンセルされたばかりの場合、ジェスチャオブジェクトはQGestureEvent でターゲットオブジェクトに配信されることがあります。ターゲット・オブジェクトでは複数のジェスチャのサポートが有効になっている場合があるため、配信される各イベントにはジェスチャ・オブジェクトのリストが含まれます。Qt ではイベントが処理されるため、ジェスチャ イベントは他のオブジェクトによってフィルタされることがあります。

QGestureEvent およびQGestureRecognizerも参照してください

メンバ型のドキュメント

enum QGesture::GestureCancelPolicy

この列挙型は、ジェスチャーを受け入れると他のジェスチャーが自動的にキャンセルされることを記述します。

定数説明
QGesture::CancelNone0このジェスチャを受け入れると、他のジェスチャは影響を受けない。
QGesture::CancelAllInContext1このジェスチャを受け入れると、コンテキストでアクティブなすべてのジェスチャ (ジェスチャにサブスクライブしたときに指定されたQt::GestureFlag を尊重する) がキャンセルされます。

プロパティの説明

gestureCancelPolicy : QGesture::GestureCancelPolicy

このプロパティは、ジェスチャを受け取ったときに何が起こるかを決定するためのポリシーを保持します。

あるジェスチャを受け入れると、Qt は他のターゲットに属する他のジェスチャを自動的にキャンセルすることができます。このポリシーは通常、他のジェスチャをキャンセルしないように設定され、コンテキスト内のすべてのアクティブなジェスチャをキャンセルするように設定できます。例えば、すべての子ウィジェットに対してです。

アクセス関数:

QGesture::GestureCancelPolicy gestureCancelPolicy() const
void setGestureCancelPolicy(QGesture::GestureCancelPolicy policy)

[read-only] gestureType : const Qt::GestureType

このプロパティは、ジェスチャーのタイプを保持します。

アクセス関数:

Qt::GestureType gestureType() const

[read-only] hasHotSpot : const bool

このプロパティは、ジェスチャにホットスポットがあるかどうかを保持します。

アクセス関数:

bool hasHotSpot() const

hotSpot : QPointF

このプロパティは、ジェスチャ・イベントのレシーバを見つけるために使用されるポイントを保持します。

ホットスポットはグローバル座標系の点であり、ローカルのホットスポットを取得するにはQWidget::mapFromGlobal() またはQGestureEvent::mapToGraphicsScene() を使用します。

ホットスポットは、ジェスチャ・イベントをQGraphicsObject に配信できるように、ジェスチャ・レコグナイザが設定する必要があります。

アクセス関数:

QPointF hotSpot() const
void setHotSpot(const QPointF &value)
void unsetHotSpot()

[read-only] state : const Qt::GestureState

このプロパティは、ジェスチャーの現在の状態を保持します。

関数にアクセスします:

Qt::GestureState state() const

メンバ関数ドキュメント

[explicit] QGesture::QGesture(QObject *parent = nullptr)

与えられたparent で新しいジェスチャーオブジェクトを構築します。

QGesture オブジェクトは、QGestureRecognizer::create() 関数のジェスチャ認識機能によって作成されます。

[virtual noexcept] QGesture::~QGesture()

ジェスチャーオブジェクトを破棄する。

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