QGestureEvent

La classe QGestureEvent décrit les gestes déclenchés. Plus d'informations...

#include <QGestureEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QEvent.

Cette classe a été introduite dans Qt 4.6.

Description détaillée

La classe QGestureEvent décrit les gestes déclenchés.

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 fonction activeGestures() donne la liste des gestes actuellement en cours d'exécution. La fonction canceledGestures() donne la liste des gestes précédemment actifs et qui ont été annulés. Un geste peut par exemple être annulé si la fenêtre courante perd le focus, ou à cause de l'expiration d'un délai.

Si le gestionnaire d'événements refuse l'événement en n'appelant pas la fonction QEvent::accept(), tous les objets QGesture qui ont été refusés et qui sont dans l'état Qt::GestureStarted seront propagés (individuellement) dans la chaîne des widgets parents, jusqu'à ce qu'un widget parent les accepte en appelant QGestureEvent::accept() pour chacun d'eux, ou qu'un filtre d'événements les consomme.

Plus d'informations

Pour une vue d'ensemble de la gestion des gestes dans Qt et des informations sur l'usage des gestes dans vos applications, voir le document Gestures Programming.

Voir aussi QGesture, QGestureRecognizer, QWidget::grabGesture() et QGraphicsObject::grabGesture().

Fonctions membres

QGestureEvent::QGestureEvent ( const QList<QGesture *> & gestures )

Crée un nouveau QGestureEvent contenant la liste de gestes gestures.

QGestureEvent::~QGestureEvent ()

Détruit QGestureEvent.

void QGestureEvent::accept ()

Accepte l'événement, équivaut à l'appel de setAccepted(true).

Voir aussi QEvent::accept().

void QGestureEvent::accept ( QGesture * gesture )

Active le drapeau d'acceptation pour l'objet gesture donné, ce qui équivaut à l'appel de setAccepted(gesture, true).

Cet appel indique que le récepteur de l'événement accepte le geste. Les gestes refusés peuvent être propagés au widget parent.

Voir aussi QGestureEvent::ignore().

void QGestureEvent::accept ( Qt::GestureType gestureType )

Active le drapeau d'acceptation pour le type gestureType donné, ce qui équivaut à l'appel de setAccepted(gestureType, true).

Cet appel indique que le récepteur de l'événement accepte le geste. Les gestes refusés peuvent être propagés au widget parent.

Voir aussi 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 identifié par type.

QList<QGesture *> QGestureEvent::gestures () const

Renvoie tous les gestes contenus dans l'événement.

void QGestureEvent::ignore ()

Ignore l'événement, équivaut à l'appel de setAccepted(false).

Voir aussi QEvent::ignore().

void QGestureEvent::ignore ( QGesture * gesture )

Désactive le drapeau d'acceptation pour l'objet gesture donné, ce qui équivaut à l'appel de setAccepted(gesture, false).

Cet appel indique que le récepteur de l'événement refuse le geste. Les gestes refusés peuvent être propagés au widget parent.

Voir aussi QGestureEvent::accept().

void QGestureEvent::ignore ( Qt::GestureType gestureType )

Désactive le drapeau d'acceptation pour le type gestureType donné, ce qui équivaut à l'appel de setAccepted(gesture, false).

Cet appel indique que le récepteur de l'événement refuse le geste. Les gestes refusés peuvent être propagés au widget parent.

Voir aussi QGestureEvent::accept().

bool QGestureEvent::isAccepted () const

Renvoie true si l'événement est accepté ; sinon renvoie false.

Voir aussi QEvent::accepted.

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 de scène si gesturePoint fait partie d'une vue graphique.

Cette fonction peut être utile lorsque l'événement est transmis à un QGraphicsObject pour convertir en coordonnées de scène un point défini en coordonnées écran.

Voir aussi QPointF::isNull() et ..

void QGestureEvent::setAccepted ( bool accepted )

Active ou désactive le drapeau interne de l'événement déterminant s'il doit être transmis à d'autres objets.

L'appel de cette fonction avec la valeur true pour accepted indique que l'appelant a accepté l'événement et qu'il ne doit plus être propagé. L'appel de cette fonction avec la valeur false indique que l'appelant a refusé l'événement et donc qu'il doit être propagé à d'autres objets.

Il peut être plus commode d'activer le drapeau d'acceptation avec accept() et de le désactiver avec ignore().

Voir aussi isAccepted() et QEvent::accepted.

void QGestureEvent::setAccepted ( QGesture * gesture, bool value )

Fixe value comme valeur du drapeau d'acceptation pour l'objet gesture donné.

Cet appel indique que le récepteur de l'événement accepte ou refuse gesture. Les gestes refusés peuvent être propagés au widget parent.

Par défaut, les gestes des événements de type QEvent::Gesture sont acceptés et ceux des événements de type QEvent::GestureOverride sont ignorés.

Il peut être plus commode d'activer le drapeau d'acceptation avec accept(gesture) et de le désactiver avec ignore(gesture).

void QGestureEvent::setAccepted ( Qt::GestureType gestureType, bool value )

Fixe value comme valeur du drapeau d'acceptation pour le type gestureType donné.

Cet appel indique que le récepteur de l'événement accepte ou refuse les gestes du type spécifié, gestureType. Les gestes refusés peuvent être propagés au widget parent.

Par défaut, les gestes des événements de type QEvent::Gesture sont acceptés et ceux des événements de type QEvent::GestureOverride sont ignorés.

Il peut être plus commode d'activer le drapeau d'acceptation avec accept(gestureType) et de le désactiver avec ignore(gestureType).

QWidget * QGestureEvent::widget () const

Renvoie le widget sur lequel l'événement s'est produit.

Remerciements

Merci à Ilya Diallo pour la traduction et à Jonathan Courtois, Claude Leloup et Jacques Thery pour leur relecture !