QGestureEvent Class
La classe QGestureEvent fournit la description des gestes déclenchés. En savoir plus...
| En-tête : | #include <QGestureEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QEvent |
- Liste de tous les membres, y compris les membres hérités
- QGestureEvent fait partie des classes d'événements.
Fonctions publiques
| QGestureEvent(const QList<QGesture *> &gestures) | |
| virtual | ~QGestureEvent() |
| void | accept(QGesture *gesture) |
| void | accept(Qt::GestureType gestureType) |
| QList<QGesture *> | activeGestures() const |
| QList<QGesture *> | canceledGestures() const |
| QGesture * | gesture(Qt::GestureType type) const |
| QList<QGesture *> | gestures() const |
| void | ignore(QGesture *gesture) |
| void | ignore(Qt::GestureType gestureType) |
| bool | isAccepted(QGesture *gesture) const |
| bool | isAccepted(Qt::GestureType gestureType) const |
| QPointF | mapToGraphicsScene(const QPointF &gesturePoint) const |
| void | setAccepted(QGesture *gesture, bool value) |
| void | setAccepted(Qt::GestureType gestureType, bool value) |
| QWidget * | widget() const |
Description détaillée
La classe QGestureEvent contient une liste de gestes, accessible via la fonction gestures().
Les gestes sont soit actifs, soit annulés. Une liste de ceux qui sont actuellement en cours d'exécution peut être obtenue à l'aide de la fonction activeGestures(). Une liste de ceux qui étaient précédemment actifs et qui ont été annulés est accessible via la fonction canceledGestures(). Un geste peut être annulé si la fenêtre active perd le focus, par exemple, ou en raison d'un délai d'expiration, ou pour d'autres raisons.
Si le gestionnaire d’événements n’accepte pas l’événement en appelant la fonction générique ` QEvent::accept()`, tous les objets ` QGesture ` individuels qui n’ont pas été acceptés et qui se trouvent à l’état « Qt::GestureStarted » seront propagés vers le haut de la chaîne des widgets parents jusqu’à ce qu’un widget les accepte individuellement, en appelant ` QGestureEvent::accept()` pour chacun d’entre eux, ou qu’un filtre d’événements consomme l’événement.
Pour en savoir plus
Pour une présentation générale de la gestion des gestes dans Qt et des informations sur l'utilisation des gestes dans vos applications, consultez le document « Gestes dans les widgets et la vue graphique ».
Voir également QGesture, QGestureRecognizer, QWidget::grabGesture() et QGraphicsObject::grabGesture().
Documentation sur les fonctions membres
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
Crée un nouvel objet `QGestureEvent` contenant une liste d'objets ` gestures`.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Supprime QGestureEvent.
void QGestureEvent::accept(QGesture *gesture)
Définit l'indicateur « accept » de l'objet ` gesture ` donné, ce qui équivaut à appeler la méthode ` setAccepted(gesture, true)`.
Le fait de définir l'indicateur « accept » indique que le récepteur d'événements souhaite recevoir ce geste. Les gestes indésirables peuvent être propagés au widget parent.
Voir également QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Définit le drapeau « accept » de l'gestureType donné, ce qui équivaut à appeler la méthode setAccepted(gestureType, true).
Le fait de définir l'indicateur « accept » indique que le récepteur d'événements souhaite que le geste soit exécuté. Les gestes indésirables peuvent être propagés au widget parent.
Voir également QGestureEvent::ignore().
QList<QGesture *> QGestureEvent::activeGestures() const
Renvoie une liste des gestes actifs (non annulés).
QList<QGesture *> QGestureEvent::canceledGestures() const
Renvoie une liste des gestes annulés.
QGesture *QGestureEvent::gesture(Qt::GestureType type) const
Renvoie un objet « geste » selon la méthode « type ».
QList<QGesture *> QGestureEvent::gestures() const
Renvoie tous les gestes transmis dans l'événement.
void QGestureEvent::ignore(QGesture *gesture)
Efface le paramètre « accept flag » de l'objet « gesture » donné, ce qui équivaut à appeler la méthode « setAccepted(gesture, false) ».
La réinitialisation de l'indicateur « accept » indique que le récepteur d'événement ne souhaite pas ce geste. Les gestes indésirables peuvent être propagés au widget parent.
Voir également QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Efface le paramètre « accept flag » de l'gestureType donné, ce qui équivaut à appeler la méthode setAccepted(gesture, false).
La réinitialisation de l'indicateur « accept » indique que le récepteur d’événements ne souhaite pas ce geste. Les gestes indésirables peuvent être propagés vers le widget parent.
Voir également QGestureEvent::accept().
bool QGestureEvent::isAccepted(QGesture *gesture) const
Renvoie « true » si l'gesture est acceptée ; sinon, renvoie « false ».
bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const
Renvoie « true » si le geste de type « gestureType » est accepté ; sinon, renvoie « false ».
QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const
Renvoie les coordonnées locales à la scène si l'gesturePoint e se trouve à l'intérieur d'une vue graphique.
Cette fonction peut s'avérer utile lorsque l'événement de geste est transmis à une QGraphicsObject afin de convertir un point exprimé en coordonnées d'écran en coordonnées locales de la scène.
Voir aussi QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Définit l'indicateur « accept » de l'objet « gesture » donné sur la valeur spécifiée « value ».
Le fait de définir l’indicateur d’acceptation indique que le récepteur d’événements souhaite recevoir les événements de type « gesture ». Les gestes indésirables peuvent être propagés vers le widget parent.
Par défaut, les gestes contenus dans les événements de type ` QEvent::Gesture ` sont acceptés, tandis que ceux contenus dans les événements de type ` QEvent::GestureOverride ` sont ignorés.
Pour plus de commodité, l’indicateur « accept » peut également être activé à l’aide de ` accept(gesture)` et désactivé à l’aide de ` ignore(gesture)`.
Voir également isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Définit l'indicateur « accept » de l'objet « gestureType » donné sur la valeur spécifiée « value ».
La définition de l’indicateur d’acceptation indique que le récepteur d’événements souhaite recevoir les gestes du type spécifié, gestureType. Les gestes indésirables peuvent être propagés vers le widget parent.
Par défaut, les gestes contenus dans les événements de type ` QEvent::Gesture ` sont acceptés, tandis que ceux contenus dans les événements de type ` QEvent::GestureOverride ` sont ignorés.
Pour plus de commodité, l'indicateur « accept » peut également être activé avec ` accept(gestureType)` et désactivé avec ` ignore(gestureType)`.
QWidget *QGestureEvent::widget() const
Renvoie le widget sur lequel l'événement s'est produit.
© 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.
