QGestureEvent¶
The
QGestureEvent
class provides the description of triggered gestures. More…
New in version 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
QGestureEvent
class contains a list of gestures, which can be obtained using thegestures()
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 thecanceledGestures()
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
accept()
function, all individualQGesture
object that were not accepted and in theGestureStarted
state will be propagated up the parent widget chain until a widget accepts them individually, by callingaccept()
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 in Widgets and Graphics View document.
- class PySide2.QtWidgets.QGestureEvent(gestures)¶
- param gestures:
Creates new
QGestureEvent
containing a list ofgestures
.
- PySide2.QtWidgets.QGestureEvent.accept(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtWidgets.QGesture
Sets the accept flag of the given
gesture
object, the equivalent of callingsetAccepted(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
- PySide2.QtWidgets.QGestureEvent.accept(arg__1)
- Parameters:
arg__1 –
GestureType
Sets the accept flag of the given
gestureType
, the equivalent of callingsetAccepted(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
- PySide2.QtWidgets.QGestureEvent.activeGestures()¶
- Return type:
Returns a list of active (not canceled) gestures.
- PySide2.QtWidgets.QGestureEvent.canceledGestures()¶
- Return type:
Returns a list of canceled gestures.
- PySide2.QtWidgets.QGestureEvent.gesture(type)¶
- Parameters:
type –
GestureType
- Return type:
Returns a gesture object by
type
.
- PySide2.QtWidgets.QGestureEvent.gestures()¶
- Return type:
Returns all gestures that are delivered in the event.
- PySide2.QtWidgets.QGestureEvent.ignore(arg__1)¶
- Parameters:
arg__1 –
PySide2.QtWidgets.QGesture
Clears the accept flag parameter of the given
gesture
object, the equivalent of callingsetAccepted(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
- PySide2.QtWidgets.QGestureEvent.ignore(arg__1)
- Parameters:
arg__1 –
GestureType
Clears the accept flag parameter of the given
gestureType
, the equivalent of callingsetAccepted(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
- PySide2.QtWidgets.QGestureEvent.isAccepted(arg__1)¶
- Parameters:
arg__1 –
GestureType
- Return type:
bool
Returns
true
if the gesture of typegestureType
is accepted; otherwise returnsfalse
.
- PySide2.QtWidgets.QGestureEvent.isAccepted(arg__1)
- Parameters:
arg__1 –
PySide2.QtWidgets.QGesture
- Return type:
bool
Returns
true
if thegesture
is accepted; otherwise returnsfalse
.
- PySide2.QtWidgets.QGestureEvent.mapToGraphicsScene(gesturePoint)¶
- Parameters:
gesturePoint –
PySide2.QtCore.QPointF
- Return type:
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
isNull()
- PySide2.QtWidgets.QGestureEvent.setAccepted(arg__1, arg__2)¶
- Parameters:
arg__1 –
PySide2.QtWidgets.QGesture
arg__2 – bool
Sets the accept flag of the given
gesture
object to the specifiedvalue
.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
Gesture
are accepted, and gestures inGestureOverride
events are ignored.For convenience, the accept flag can also be set with
accept(gesture)
, and cleared withignore(gesture)
.See also
- PySide2.QtWidgets.QGestureEvent.setAccepted(arg__1, arg__2)
- Parameters:
arg__1 –
GestureType
arg__2 – bool
Sets the accept flag of the given
gestureType
object to the specifiedvalue
.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
Gesture
are accepted, and gestures inGestureOverride
events are ignored.For convenience, the accept flag can also be set with
accept(gestureType)
, and cleared withignore(gestureType)
.
- PySide2.QtWidgets.QGestureEvent.setWidget(widget)¶
- Parameters:
widget –
PySide2.QtWidgets.QWidget
Sets the widget for this event to the
widget
specified.See also
- PySide2.QtWidgets.QGestureEvent.widget()¶
- Return type:
Returns the widget on which the event occurred.
© 2022 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.