QNativeGestureEvent Class

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

Header: #include <QNativeGestureEvent>
qmake: QT += gui
Since: Qt 5.2
Inherits: QInputEvent

This class was introduced in Qt 5.2.

Public Functions

QNativeGestureEvent(Qt::NativeGestureType type, const QTouchDevice *device, const QPointF &localPos, const QPointF &windowPos, const QPointF &screenPos, qreal realValue, ulong sequenceId, quint64 intValue)
const QTouchDevice *device() const
  • 2 public functions inherited from QEvent

Additional Inherited Members

  • 1 property inherited from QEvent
  • 1 static public member inherited from QEvent

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 TypeDescriptionTouch sequence
Qt::ZoomNativeGestureMagnification delta in percent.macOS: Two-finger pinch.
Qt::SmartZoomNativeGestureBoolean magnification state.macOS: Two-finger douple tap (trackpad) / One-finger douple tap (magic mouse).
Qt::RotateNativeGestureRotation 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 Qt::NativeGestureType and QGestureEvent.

Member Function Documentation

QNativeGestureEvent::QNativeGestureEvent(Qt::NativeGestureType type, const QTouchDevice *device, const QPointF &localPos, const QPointF &windowPos, const QPointF &screenPos, qreal realValue, ulong sequenceId, quint64 intValue)

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.

This function was introduced in Qt 5.10.

const QTouchDevice *QNativeGestureEvent::device() const

Returns the device.

This function was introduced in Qt 5.10.