QGestureEvent

Note

This class was introduced in Qt 4.6

Synopsis

Functions

• def accept (arg__1)
• def accept (arg__1)
• def activeGestures ()
• def canceledGestures ()
• def gesture (type)
• def gestures ()
• def ignore (arg__1)
• def ignore (arg__1)
• def isAccepted (arg__1)
• def isAccepted (arg__1)
• def mapToGraphicsScene (gesturePoint)
• def setAccepted (arg__1, arg__2)
• def setAccepted (arg__1, arg__2)
• def setWidget (widget)
• def widget ()

Detailed Description

The PySide.QtGui.QGestureEvent class provides the description of triggered gestures.

The PySide.QtGui.QGestureEvent class contains a list of gestures, which can be obtained using the PySide.QtGui.QGestureEvent.gestures() function.

The gestures are either active or canceled. A list of those that are currently being executed can be obtained using the PySide.QtGui.QGestureEvent.activeGestures() function. A list of those which were previously active and have been canceled can be accessed using the PySide.QtGui.QGestureEvent.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 PySide.QtGui.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.

See also

PySide.QtGui.QGesture PySide.QtGui.QGestureRecognizer QWidget.grabGesture() QGraphicsObject.grabGesture()

class PySide.QtGui.QGestureEvent(gestures)

Parameters:gestures –

PySide.QtGui.QGestureEvent.accept(arg__1)

Parameters:arg__1 – PySide.QtGui.QGesture

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()

PySide.QtGui.QGestureEvent.accept(arg__1)

Parameters:arg__1 – PySide.QtCore.Qt.GestureType

PySide.QtGui.QGestureEvent.activeGestures()

Return type:

Returns a list of active (not canceled) gestures.

PySide.QtGui.QGestureEvent.canceledGestures()

Return type:

Returns a list of canceled gestures.

PySide.QtGui.QGestureEvent.gesture(type)

Parameters:type – PySide.QtCore.Qt.GestureType Return type:PySide.QtGui.QGesture

PySide.QtGui.QGestureEvent.gestures()

Return type:

Returns all gestures that are delivered in the event.

PySide.QtGui.QGestureEvent.ignore(arg__1)

Parameters:arg__1 – PySide.QtCore.Qt.GestureType

PySide.QtGui.QGestureEvent.ignore(arg__1)

Parameters:arg__1 – PySide.QtGui.QGesture

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 propgated to the parent widget.

See also

QGestureEvent.accept()

PySide.QtGui.QGestureEvent.isAccepted(arg__1)

Parameters:arg__1 – PySide.QtCore.Qt.GestureType Return type:PySide.QtCore.bool

PySide.QtGui.QGestureEvent.isAccepted(arg__1)

Parameters:arg__1 – PySide.QtGui.QGesture Return type:PySide.QtCore.bool

Returns true if the gesture is accepted; otherwise returns false.

PySide.QtGui.QGestureEvent.mapToGraphicsScene(gesturePoint)

Parameters:gesturePoint – PySide.QtCore.QPointF Return type:PySide.QtCore.QPointF

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 PySide.QtGui.QGraphicsObject to translate a point in screen coordinates to scene-local coordinates.

See also

QPointF.isNull() .

PySide.QtGui.QGestureEvent.setAccepted(arg__1, arg__2)

Parameters:

• arg__1 – PySide.QtCore.Qt.GestureType
• arg__2 – PySide.QtCore.bool

PySide.QtGui.QGestureEvent.setAccepted(arg__1, arg__2)

Parameters:

• arg__1 – PySide.QtGui.QGesture
• arg__2 – PySide.QtCore.bool

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) .

PySide.QtGui.QGestureEvent.setWidget(widget)

Parameters:widget – PySide.QtGui.QWidget

Sets the widget for this event to the widget specified.

See also

PySide.QtGui.QGestureEvent.widget()

PySide.QtGui.QGestureEvent.widget()

Return type:PySide.QtGui.QWidget

Returns the widget on which the event occurred.