En esta página

QNativeGestureEvent Class

La clase `QNativeGestureEvent` contiene parámetros que describen un evento de gesto. Más información...

Cabecera: #include <QNativeGestureEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QSinglePointEvent

Funciones públicas

(since 6.2) QNativeGestureEvent(Qt::NativeGestureType type, const QPointingDevice *device, int fingerCount, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, qreal value, const QPointF &delta, quint64 sequenceId = UINT64_MAX)
(since 6.2) QPointF delta() const
(since 6.2) int fingerCount() const
Qt::NativeGestureType gestureType() const
qreal value() const

Funciones protegidas

QNativeGestureEvent(QNativeGestureEvent &&)
QNativeGestureEvent &operator=(QNativeGestureEvent &&)
QNativeGestureEvent &operator=(const QNativeGestureEvent &other)

Descripción detallada

Los eventos de gestos nativos son generados por el sistema operativo, normalmente mediante la interpretación de eventos táctiles del trackpad. Los eventos de gestos son eventos de alto nivel, como el zoom, la rotación o el desplazamiento. Varios tipos contienen valores incrementales: es decir, value() y delta() proporcionan la diferencia entre el evento anterior y el actual.

Tipo de eventoDescripciónSecuencia táctil
Qt::ZoomNativeGestureDelta de ampliación en porcentaje.macOS y Wayland: pellizco con dos dedos.
Qt::SmartZoomNativeGestureEstado booleano de la ampliación.macOS: doble toque con dos dedos (trackpad) / doble toque con un dedo (Magic Mouse).
Qt::RotateNativeGestureDelta de rotación en grados.macOS y Wayland: rotación con dos dedos.
Qt::SwipeNativeGestureÁngulo de deslizamiento en grados.macOS: Configurable en los ajustes del trackpad.
Qt::PanNativeGestureDesplazamiento en píxeles.Wayland: tres o más dedos moviéndose en grupo, en cualquier dirección.

Además, se envían los eventos «BeginNativeGesture» y «EndNativeGesture» antes y después de las secuencias de eventos de gestos:

BeginNativeGesture ZoomNativeGesture ZoomNativeGesture ZoomNativeGesture EndNativeGesture

El flujo de eventos puede incluir gestos entremezclados de diferentes tipos: por ejemplo, el gesto de pellizco con dos dedos genera un flujo de eventos de zoom y rotación, y PanNativeGesture puede intercalarse a veces con ellos, dependiendo de la plataforma.

Otros tipos son eventos independientes: SmartZoomNativeGesture y SwipeNativeGesture se producen solo una vez cada vez que se detecta el gesto.

Nota: En un panel táctil, mover dos dedos a la vez (el gesto de deslizamiento con dos dedos) suele reservarse para el desplazamiento; en ese caso, Qt genera QWheelEvents. Esta es la razón por la que se necesitan tres o más dedos para generar un PanNativeGesture.

Véase también Qt::NativeGestureType, QGestureEvent y QWheelEvent.

Documentación de funciones miembro

[since 6.2] QNativeGestureEvent::QNativeGestureEvent(Qt::NativeGestureType type, const QPointingDevice *device, int fingerCount, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, qreal value, const QPointF &delta, quint64 sequenceId = UINT64_MAX)

Crea un evento de gesto nativo de tipo type, procedente de device, que describe un gesto en scenePos en el que intervienen fingerCount dedos.

Los puntos localPos, scenePos y globalPos especifican la posición del gesto en relación con el widget o elemento receptor, la ventana y la pantalla o el escritorio, respectivamente.

value tiene una interpretación que depende del gesto: para RotateNativeGesture o SwipeNativeGesture, se trata de un ángulo en grados. En el caso de `ZoomNativeGesture`, ` value ` es un factor de escalado incremental, normalmente muy inferior a 1, que indica que la escala del elemento de destino debe ajustarse de la siguiente manera: `item.scale = item.scale * (1 + event.value)`

En el caso de `PanNativeGesture`, ` delta ` indica la distancia en píxeles a la que debe desplazarse o desplazarse panorámicamente la ventana de visualización, el widget o el elemento.

Nota: El valor de ` delta ` se almacena en precisión simple (QVector2D), por lo que ` delta()` puede devolver valores ligeramente diferentes en algunos casos. Esto está sujeto a cambios en futuras versiones de Qt.

Esta función se introdujo en Qt 6.2.

[protected delete] QNativeGestureEvent::QNativeGestureEvent(QNativeGestureEvent &&)

Crea una instancia de ` QNativeGestureEvent`. Esta función se ha eliminado.

[since 6.2] QPointF QNativeGestureEvent::delta() const

Devuelve la distancia recorrida desde el evento anterior, en píxeles. Un gesto de desplazamiento horizontal proporciona la distancia en píxeles en la que debe desplazarse el widget de destino, el elemento o el contenido de la ventana gráfica.

Esta función se introdujo en Qt 6.2.

Véase también QPanGesture::delta().

[since 6.2] int QNativeGestureEvent::fingerCount() const

Devuelve el número de dedos que participan en el gesto, si se conoce. Cuando gestureType() es Qt::BeginNativeGesture o Qt::EndNativeGesture, a menudo esta información se desconoce y fingerCount() devuelve 0.

Esta función se introdujo en Qt 6.2.

Qt::NativeGestureType QNativeGestureEvent::gestureType() const

Devuelve el tipo de gesto.

qreal QNativeGestureEvent::value() const

Devuelve el valor del gesto. El valor debe interpretarse en función del tipo de gesto. Por ejemplo, un gesto de zoom proporciona un delta del factor de escala, mientras que un gesto de rotación proporciona un delta de rotación.

Véase también QNativeGestureEvent y gestureType().

[protected delete] QNativeGestureEvent &QNativeGestureEvent::operator=(QNativeGestureEvent &&)

Asigna mediante «move» ` other ` a esta instancia de ` QNativeGestureEvent `. Esta función se elimina.

[noexcept protected default] QNativeGestureEvent &QNativeGestureEvent::operator=(const QNativeGestureEvent &other)

Asigna por copia other a esta instancia de QNativeGestureEvent.

© 2026 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.