QGestureRecognizer Class

Description détaillée

Les reconnaisseurs de gestes sont chargés de créer et de gérer des objets ` QGesture `, ainsi que de surveiller les événements d'entrée envoyés aux sous-classes ` QWidget ` et ` QGraphicsObject `. `QGestureRecognizer` est la classe de base permettant d'implémenter des gestes personnalisés.

Les développeurs qui ont uniquement besoin d'assurer la reconnaissance des gestes standard n'ont pas besoin d'utiliser directement cette classe. Les instances seront créées en arrière-plan par le framework.

Pour une présentation générale de la gestion des gestes dans Qt et des informations sur leur utilisation dans vos applications, consultez le document « Gestes dans les widgets et la vue graphique ».

Reconnaissance des gestes

Le processus de reconnaissance des gestes consiste à filtrer les événements d’entrée envoyés à des objets spécifiques, puis à modifier les objets ` QGesture ` associés afin d’y inclure les informations pertinentes concernant l’entrée de l’utilisateur.

Les gestes sont créés lorsque le framework appelle la méthode ` create()` pour traiter la saisie de l’utilisateur pour une instance particulière d’une sous-classe de ` QWidget ` ou ` QGraphicsObject `. Un objet ` QGesture ` est créé pour chaque widget ou élément configuré pour utiliser les gestes.

Une fois qu’un objet ` QGesture ` a été créé pour un objet cible, le reconnaisseur de gestes recevra les événements le concernant dans sa fonction de gestion ` recognize()`.

Lorsqu’un geste est annulé, la fonction ` reset()` est appelée, ce qui permet au système de reconnaissance de mettre à jour les propriétés appropriées dans l’objet ` QGesture ` correspondant.

Prise en charge de nouveaux gestes

Pour prendre en charge de nouveaux gestes, vous devez dériver de QGestureRecognizer afin de créer une classe de reconnaissance personnalisée, construire une instance de cette classe et l’enregistrer auprès de l’application en appelant QGestureRecognizer::registerRecognizer(). Vous pouvez également créer une sous-classe de QGesture pour créer une classe de geste personnalisée, ou utiliser des propriétés dynamiques pour définir les détails spécifiques du geste que vous souhaitez gérer.

Votre sous-classe personnalisée de `QGestureRecognizer` doit réimplémenter la fonction ` recognize()` afin de gérer et de filtrer les événements d'entrée entrants pour les sous-classes de ` QWidget ` et ` QGraphicsObject `. Bien que la logique de reconnaissance des gestes soit implémentée dans cette fonction, vous pouvez stocker des informations persistantes sur l'état du processus de reconnaissance dans l'objet ` QGesture ` fourni. La fonction recognize() doit renvoyer une valeur de type QGestureRecognizer::Result indiquant l’état de la reconnaissance pour un geste et un objet cible donnés. Cela détermine si un événement de geste sera ou non transmis à un objet cible.

Si vous choisissez de représenter un geste à l'aide d'une sous-classe personnalisée de ` QGesture `, vous devrez réimplémenter la fonction ` create()` pour créer des instances de votre classe de geste. De même, vous devrez peut-être réimplémenter la fonction ` reset()` si vos objets de geste personnalisés doivent faire l'objet d'un traitement particulier lorsqu'un geste est annulé.