QGesture Class

詳細説明

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

Qt におけるジェスチャ処理の概要およびアプリケーションでのジェスチャの使用方法については、『Qt Widgets およびグラフィックスビューにおけるジェスチャ』ドキュメントを参照してください。

ジェスチャーのプロパティ

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

カスタムジェスチャ認識機能の開発者は、ジェスチャに関する追加情報を提供するために、プロパティを追加することができます。これは、QGesture オブジェクトに新しい動的プロパティを追加するか、QGesture クラス（またはそのサブクラスのいずれか）をサブクラス化することで実現できます。

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

QGestureインスタンスは、必要に応じて暗黙的に作成され、Qtによって管理されます。Qtは特定のインスタンスを破棄し、それを置き換えるために新しいインスタンスを作成する場合があるため、開発者は決してそれらを破棄したり、後で使用するために保存したりしてはなりません。

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

対応するジェスチャーがアクティブであるか、または直前にキャンセルされた場合、ジェスチャーオブジェクトはQGestureEvent 内でターゲットオブジェクトに配信されることがあります。ターゲットオブジェクトに対して複数のジェスチャーが有効になっている可能性があるため、配信される各イベントにはジェスチャーオブジェクトのリストが含まれます。Qtにおけるイベント処理の仕組み上、ジェスチャーイベントは他のオブジェクトによってフィルタリングされる場合があります。