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::CancelNone | 0 | このジェスチャを受け入れると、他のジェスチャは影響を受けない。 |
QGesture::CancelAllInContext | 1 | このジェスチャを受け入れると、コンテキストでアクティブなすべてのジェスチャ (ジェスチャにサブスクライブしたときに指定された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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。