Detailed Description
The QGestureEvent class provides the description of triggered gestures.
The QGestureEvent class contains a list of gestures, which can be obtained using the gestures() function.
The gestures are either active or canceled. A list of those that are currently being executed can be obtained using the activeGestures() function. A list of those which were previously active and have been canceled can be accessed using the canceledGestures() function. A gesture might be canceled if the current window loses focus, for example, or because of a timeout, or for other reasons.
If the event handler does not accept the event by calling the generic QEvent::accept() function, all individual QGesture object that were not accepted and in the Qt::GestureStarted state will be propagated up the parent widget chain until a widget accepts them individually, by calling QGestureEvent::accept() for each of them, or an event filter consumes the event.
Further Reading
For an overview of gesture handling in Qt and information on using gestures in your applications, see the Gestures Programming document.
Member Function Documentation
QGestureEvent::QGestureEvent(const QList<QGesture *> & gestures)
Creates new QGestureEvent containing a list of gestures.
QGestureEvent::~QGestureEvent()
Destroys QGestureEvent.
void QGestureEvent::accept()
Accepts the event, the equivalent of calling setAccepted(true).
See also QEvent::accept().
void QGestureEvent::accept(QGesture * gesture)
Sets the accept flag of the given gesture object, the equivalent of calling setAccepted(gesture, true).
Setting the accept flag indicates that the event receiver wants the gesture. Unwanted gestures may be propagated to the parent widget.
See also QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Sets the accept flag of the given gestureType, the equivalent of calling setAccepted(gestureType, true).
Setting the accept flag indicates that the event receiver wants the gesture. Unwanted gestures may be propagated to the parent widget.
See also QGestureEvent::ignore().
QList<QGesture *> QGestureEvent::activeGestures() const
Returns a list of active (not canceled) gestures.
QList<QGesture *> QGestureEvent::canceledGestures() const
Returns a list of canceled gestures.
QGesture * QGestureEvent::gesture(Qt::GestureType type) const
Returns a gesture object by type.
QList<QGesture *> QGestureEvent::gestures() const
Returns all gestures that are delivered in the event.
void QGestureEvent::ignore()
Ignores the event, the equivalent of calling setAccepted(false).
See also QEvent::ignore().
void QGestureEvent::ignore(QGesture * gesture)
Clears the accept flag parameter of the given gesture object, the equivalent of calling setAccepted(gesture, false).
Clearing the accept flag indicates that the event receiver does not want the gesture. Unwanted gestures may be propagated to the parent widget.
See also QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Clears the accept flag parameter of the given gestureType, the equivalent of calling setAccepted(gesture, false).
Clearing the accept flag indicates that the event receiver does not want the gesture. Unwanted gestures may be propgated to the parent widget.
See also QGestureEvent::accept().
bool QGestureEvent::isAccepted() const
Returns true is the event has been accepted; otherwise returns false.
See also QEvent::accepted.
bool QGestureEvent::isAccepted(QGesture * gesture) const
Returns true if the gesture is accepted; otherwise returns false.
bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const
Returns true if the gesture of type gestureType is accepted; otherwise returns false.
QPointF QGestureEvent::mapToGraphicsScene(const QPointF & gesturePoint) const
Returns the scene-local coordinates if the gesturePoint is inside a graphics view.
This functional might be useful when the gesture event is delivered to a QGraphicsObject to translate a point in screen coordinates to scene-local coordinates.
See also QPointF::isNull() and ..
void QGestureEvent::setAccepted(bool accepted)
Sets or clears the event's internal flag that determines whether it should be delivered to other objects.
Calling this function with a value of true for accepted indicates that the caller has accepted the event and that it should not be propagated further. Calling this function with a value of false indicates that the caller has ignored the event and that it should be delivered to other objects.
For convenience, the accept flag can also be set with accept(), and cleared with ignore().
See also isAccepted() and QEvent::accepted.
void QGestureEvent::setAccepted(QGesture * gesture, bool value)
Sets the accept flag of the given gesture object to the specified value.
Setting the accept flag indicates that the event receiver wants the gesture. Unwanted gestures may be propagated to the parent widget.
By default, gestures in events of type QEvent::Gesture are accepted, and gestures in QEvent::GestureOverride events are ignored.
For convenience, the accept flag can also be set with accept(gesture), and cleared with ignore(gesture).
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Sets the accept flag of the given gestureType object to the specified value.
Setting the accept flag indicates that the event receiver wants to receive gestures of the specified type, gestureType. Unwanted gestures may be propagated to the parent widget.
By default, gestures in events of type QEvent::Gesture are accepted, and gestures in QEvent::GestureOverride events are ignored.
For convenience, the accept flag can also be set with accept(gestureType), and cleared with ignore(gestureType).
QWidget * QGestureEvent::widget() const
Returns the widget on which the event occurred.
