QGesture Class

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

Header: #include <QGesture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QObject
Inherited By:

QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture, and 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()

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

このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。