QGestureEvent Class
La classe QGestureEvent fournit la description des gestes déclenchés. Plus d'informations...
| En-tête : | #include <QGestureEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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, qui peut être obtenue à l'aide de la fonction gestures().
Les gestes sont soit actifs, soit annulés. La liste de ceux qui sont 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 peut être obtenue en utilisant la fonction canceledGestures(). Un geste peut être annulé si la fenêtre actuelle perd le focus, par exemple, ou en raison d'un délai d'attente, ou pour d'autres raisons.
Si le gestionnaire d'événement 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 dans l'état Qt::GestureStarted seront propagés dans 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énement consomme l'événement.
Pour en savoir plus
Pour une vue d'ensemble de la gestion des gestes dans Qt Widgets et des informations sur l'utilisation des gestes dans vos applications, consultez le document Gestures in Widgets and Graphics View (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 nouveau QGestureEvent contenant une liste de gestures.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Détruit QGestureEvent.
void QGestureEvent::accept(QGesture *gesture)
Définit l'indicateur d'acceptation de l'objet gesture donné, ce qui équivaut à appeler setAccepted(gesture, true).
L'activation de l'indicateur d'acceptation indique que le récepteur de l'événement veut le geste. Les gestes non désirés peuvent être propagés au widget parent.
Voir aussi QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Définit l'indicateur d'acceptation de gestureType, ce qui équivaut à appeler setAccepted(gestureType, true).
L'activation de l'indicateur d'acceptation indique que le récepteur de l'événement veut le geste. Les gestes non désirés peuvent être propagés au widget parent.
Voir aussi QGestureEvent::ignore().
QList<QGesture *> QGestureEvent::activeGestures() const
Renvoie une liste de gestes actifs (non annulés).
QList<QGesture *> QGestureEvent::canceledGestures() const
Renvoie une liste de gestes annulés.
QGesture *QGestureEvent::gesture(Qt::GestureType type) const
Renvoie un objet gestuel par type.
QList<QGesture *> QGestureEvent::gestures() const
Renvoie tous les gestes effectués dans le cadre de l'événement.
void QGestureEvent::ignore(QGesture *gesture)
Efface le paramètre d'acceptation de l'objet gesture donné, ce qui équivaut à appeler setAccepted(gesture, false).
L'effacement de l'indicateur d'acceptation indique que le récepteur de l'événement ne veut pas du geste. Les gestes non désirés peuvent être propagés au widget parent.
Voir aussi QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Efface l'indicateur d'acceptation du paramètre gestureType, ce qui équivaut à appeler setAccepted(gesture, false).
L'effacement de l'indicateur d'acceptation indique que le récepteur de l'événement ne veut pas du geste. Les gestes non désirés peuvent être propagés au widget parent.
Voir aussi QGestureEvent::accept().
bool QGestureEvent::isAccepted(QGesture *gesture) const
Renvoie true si gesture est accepté ; 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 le site gesturePoint se trouve à l'intérieur d'une vue graphique.
Cette fonction peut être utile lorsque l'événement de geste est transmis à QGraphicsObject pour traduire un point en coordonnées d'écran en coordonnées locales à la scène.
Voir également QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Définit l'indicateur d'acceptation de l'objet gesture donné à l'indicateur value spécifié.
L'activation de l'indicateur d'acceptation indique que le récepteur de l'événement souhaite recevoir l'objet gesture. Les gestes non souhaités peuvent être transmis au widget parent.
Par défaut, les gestes dans les événements de type QEvent::Gesture sont acceptés, et les gestes dans les événements QEvent::GestureOverride sont ignorés.
Par commodité, l'indicateur d'acceptation peut également être activé avec accept(gesture) et désactivé avec ignore(gesture).
Voir aussi isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Définit l'indicateur d'acceptation de l'objet gestureType donné sur l'indicateur spécifié value.
La définition de l'indicateur d'acceptation indique que le récepteur d'événements souhaite recevoir des gestes du type spécifié, gestureType. Les gestes non désirés peuvent être propagés au widget parent.
Par défaut, les gestes dans les événements de type QEvent::Gesture sont acceptés, et les gestes dans les événements QEvent::GestureOverride sont ignorés.
Pour plus de commodité, l'indicateur d'acceptation 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.
