QNativeGestureEvent

The QNativeGestureEvent class contains parameters that describe a gesture event. More

Inheritance diagram of PySide2.QtGui.QNativeGestureEvent

Synopsis

Functions

Detailed Description

Native gesture events are generated by the operating system, typically by interpreting touch events. Gesture events are high-level events such as zoom or rotate.

Event Type

Description

Touch sequence

ZoomNativeGesture

Magnification delta in percent.

macOS: Two-finger pinch.

SmartZoomNativeGesture

Boolean magnification state.

macOS: Two-finger douple tap (trackpad) / One-finger douple tap (magic mouse).

RotateNativeGesture

Rotation delta in degrees.

macOS: Two-finger rotate.

In addition, BeginNativeGesture and EndNativeGesture are sent before and after gesture event streams:

BeginNativeGesture ZoomNativeGesture ZoomNativeGesture ZoomNativeGesture EndNativeGesture

See also

NativeGestureType QGestureEvent

class PySide2.QtGui.QNativeGestureEvent(type, localPos, windowPos, screenPos, value, sequenceId, intArgument)

Note

This constructor is deprecated.

PySide2.QtGui.QNativeGestureEvent(type, dev, localPos, windowPos, screenPos, value, sequenceId, intArgument)

param type:

NativeGestureType

param localPos:

PySide2.QtCore.QPointF

param screenPos:

PySide2.QtCore.QPointF

param dev:

PySide2.QtGui.QTouchDevice

param sequenceId:

ulong

param windowPos:

PySide2.QtCore.QPointF

param value:

float

param intArgument:

int

The QTouchDevice parameter is now required

Constructs a native gesture event of type type originating from device .

The points localPos , windowPos and screenPos specify the gesture position relative to the receiving widget or item, window, and screen, respectively.

realValue is the macOS event parameter, sequenceId and intValue are the Windows event parameters.

PySide2.QtGui.QNativeGestureEvent.device()
Return type:

PySide2.QtGui.QTouchDevice

Returns the device.

PySide2.QtGui.QNativeGestureEvent.gestureType()
Return type:

NativeGestureType

Returns the gesture type.

PySide2.QtGui.QNativeGestureEvent.globalPos()
Return type:

PySide2.QtCore.QPoint

Returns the position of the gesture as a QPointF in screen coordinates

PySide2.QtGui.QNativeGestureEvent.localPos()
Return type:

PySide2.QtCore.QPointF

Returns the position of the gesture as a QPointF , relative to the widget or item that received the event.

PySide2.QtGui.QNativeGestureEvent.pos()
Return type:

PySide2.QtCore.QPoint

Returns the position of the mouse cursor, relative to the widget or item that received the event.

PySide2.QtGui.QNativeGestureEvent.screenPos()
Return type:

PySide2.QtCore.QPointF

Returns the position of the gesture as a QPointF in screen coordinates.

PySide2.QtGui.QNativeGestureEvent.value()
Return type:

float

Returns the gesture value. The value should be interpreted based on the gesture type. For example, a Zoom gesture provides a scale factor while a Rotate gesture provides a rotation delta.

PySide2.QtGui.QNativeGestureEvent.windowPos()
Return type:

PySide2.QtCore.QPointF

Returns the position of the gesture as a QPointF , relative to the window that received the event.