QGesture Class
La classe QGesture représente un geste et contient des propriétés qui décrivent l'entrée utilisateur correspondante. Plus d'informations...
| En-tête : | #include <QGesture> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite : | QObject |
| Inherited By : | QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture, et QTapGesture |
Types publics
| enum | GestureCancelPolicy { CancelNone, CancelAllInContext } |
Propriétés
|
Fonctions publiques
| 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() |
Description détaillée
Les objets gestuels ne sont pas construits directement par les développeurs. Ils sont créés par l'objet QGestureRecognizer qui est enregistré avec l'application ; voir QGestureRecognizer::registerRecognizer().
Pour une vue d'ensemble de la gestion des gestes dans Qt et des informations sur l'utilisation des gestes dans vos applications, voir le document Gestures in Widgets and Graphics View (Gestes dans les widgets et la vue graphique).
Propriétés des gestes
La classe possède une liste de propriétés qui peuvent être interrogées par l'utilisateur pour obtenir des arguments spécifiques au geste. Par exemple, le geste de pincement a un facteur d'échelle qui est exposé en tant que propriété.
Les développeurs d'outils de reconnaissance de gestes personnalisés peuvent ajouter des propriétés supplémentaires afin de fournir des informations complémentaires sur un geste. Cela peut se faire en ajoutant de nouvelles propriétés dynamiques à un objet QGesture, ou en sous-classant la classe QGesture (ou l'une de ses sous-classes).
Cycle de vie d'un objet Gesture
Une instance de QGesture est implicitement créée en cas de besoin et appartient à Qt. Les développeurs ne doivent jamais les détruire ou les stocker pour une utilisation ultérieure, car Qt peut détruire des instances particulières et en créer de nouvelles pour les remplacer.
Le reconnaissant de geste enregistré surveille les événements d'entrée pour l'objet cible via sa fonction recognize(), mettant à jour les propriétés de l'objet de geste si nécessaire.
L'objet gestuel peut être transmis à l'objet cible sur QGestureEvent si le geste correspondant est actif ou vient d'être annulé. Chaque événement transmis contient une liste d'objets gestuels, étant donné que la prise en charge de plusieurs gestes peut être activée pour l'objet cible. En raison de la manière dont les événements sont gérés dans Qt, les événements de geste peuvent être filtrés par d'autres objets.
Voir également QGestureEvent et QGestureRecognizer.
Documentation sur les types de membres
enum QGesture::GestureCancelPolicy
Cette énumération décrit comment l'acceptation d'un geste peut annuler automatiquement d'autres gestes.
| Constante | Valeur | Description |
|---|---|---|
QGesture::CancelNone | 0 | L'acceptation de ce geste n'affecte aucun autre geste. |
QGesture::CancelAllInContext | 1 | L'acceptation de ce geste entraîne l'annulation de tous les gestes actifs dans le contexte (en respectant l'adresse Qt::GestureFlag spécifiée lors de l'inscription au geste). |
Propriété Documentation
gestureCancelPolicy : QGesture::GestureCancelPolicy
Cette propriété contient la politique permettant de décider ce qui se passe lors de l'acceptation d'un geste
Lors de l'acceptation d'un geste, Qt peut automatiquement annuler d'autres gestes appartenant à d'autres cibles. La politique est normalement définie pour ne pas annuler d'autres gestes et peut être définie pour annuler tous les gestes actifs dans le contexte. Par exemple, pour tous les widgets enfants.
Fonctions d'accès :
| QGesture::GestureCancelPolicy | gestureCancelPolicy() const |
| void | setGestureCancelPolicy(QGesture::GestureCancelPolicy policy) |
[read-only] gestureType : Qt::GestureType
Cette propriété contient le type de geste
Fonctions d'accès :
| Qt::GestureType | gestureType() const |
[read-only] hasHotSpot : bool
Cette propriété indique si le geste comporte un point chaud.
Fonctions d'accès :
| bool | hasHotSpot() const |
hotSpot : QPointF
Cette propriété contient le point utilisé pour trouver le récepteur de l'événement gestuel.
Le point chaud est un point dans le système de coordonnées global, utilisez QWidget::mapFromGlobal() ou QGestureEvent::mapToGraphicsScene() pour obtenir un point chaud local.
Le point chaud doit être défini par l'outil de reconnaissance gestuelle pour permettre la transmission d'un événement gestuel à un site QGraphicsObject.
Fonctions d'accès :
| QPointF | hotSpot() const |
| void | setHotSpot(const QPointF &value) |
| void | unsetHotSpot() |
[read-only] state : Qt::GestureState
Cette propriété contient l'état actuel du geste
Fonctions d'accès :
| Qt::GestureState | state() const |
Fonction membre Documentation
[explicit] QGesture::QGesture(QObject *parent = nullptr)
Construit un nouvel objet gestuel avec l'adresse parent.
Les objets QGesture sont créés par les reconnaisseurs de gestes dans la fonction QGestureRecognizer::create().
[virtual noexcept] QGesture::~QGesture()
Détruit l'objet du geste.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
