QGestureRecognizer Class

詳細な説明

ジェスチャ認識器は、QGesture オブジェクトの作成と管理、およびQWidget およびQGraphicsObject のサブクラスに送信される入力イベントの監視を担当します。QGestureRecognizer は、カスタムジェスチャを実装するための基底クラスです。

標準的なジェスチャーの認識のみを提供すればよい開発者は、このクラスを直接使用する必要はありません。インスタンスはフレームワークによって内部で自動的に作成されます。

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

ジェスチャーの認識

ジェスチャーの認識プロセスでは、特定のオブジェクトに送信される入力イベントをフィルタリングし、関連するQGesture オブジェクトを修正して、ユーザーの入力に関する関連情報を含める必要があります。

ジェスチャは、フレームワークが `create()` を呼び出し、QWidget またはQGraphicsObject のサブクラスの特定のインスタンスに対するユーザー入力を処理する際に生成されます。ジェスチャを使用するように設定された各ウィジェットまたはアイテムに対して、QGesture オブジェクトが作成されます。

対象オブジェクトに対してQGesture が作成されると、ジェスチャー認識器はrecognize()ハンドラ関数内でそのオブジェクトに関するイベントを受け取ります。

ジェスチャーがキャンセルされると、reset() 関数が呼び出され、認識器は対応するQGesture オブジェクトの適切なプロパティを更新することができます。

新しいジェスチャーのサポート

新しいジェスチャーをサポートするには、`QGestureRecognizer` を継承してカスタム認識クラスを作成し、そのクラスのインスタンスを生成して、`QGestureRecognizer::registerRecognizer()` を呼び出してアプリケーションに登録する必要があります。また、`QGesture ` をサブクラス化してカスタムジェスチャークラスを作成したり、動的プロパティを利用して処理したいジェスチャーの具体的な詳細を表現したりすることもできます。

カスタムの QGestureRecognizer サブクラスでは、QWidget およびQGraphicsObject のサブクラスに対する入力イベントを処理・フィルタリングするために、recognize() 関数を再実装する必要があります。ジェスチャ認識のロジックはこの関数内で実装されますが、認識プロセスの状態に関する永続的な情報は、渡されるQGesture オブジェクトに格納することができます。recognize() 関数は、指定されたジェスチャーおよびターゲットオブジェクトに対する認識状態を示すQGestureRecognizer::Result の値を返さなければなりません。これにより、ジェスチャーイベントがターゲットオブジェクトに配信されるかどうかが決定されます。

ジェスチャーをカスタムQGesture サブクラスで表現する場合は、create()関数を再実装して、ジェスチャークラスのインスタンスを生成する必要があります。同様に、ジェスチャーがキャンセルされた際にカスタムジェスチャーオブジェクトを特別に処理する必要がある場合は、reset()関数を再実装する必要がある場合があります。