En esta página

QGesture Class

La clase QGesture representa un gesto y contiene propiedades que describen la entrada del usuario correspondiente. Más información...

Cabecera: #include <QGesture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QObject
Heredado por:

QPanGesture, QPinchGesture, QSwipeGesture, QTapAndHoldGesture y QTapGesture

Tipos públicos

enum GestureCancelPolicy { CancelNone, CancelAllInContext }

Propiedades

Funciones públicas

QGesture(QObject *parent = nullptr)
virtual ~QGesture()
QGesture::GestureCancelPolicy gestureCancelPolicy() const
Qt::GestureType gestureType() const
bool hasHotSpot() const
QPointF hotSpot() const
void setGestureCancelPolicy(QGesture::GestureCancelPolicy policy)
void setHotSpot(const QPointF &value)
Qt::GestureState state() const
void unsetHotSpot()

Descripción detallada

Los objetos de gestos no los crean directamente los desarrolladores. Los crea el objeto ` QGestureRecognizer ` registrado en la aplicación; véase ` QGestureRecognizer::registerRecognizer()`.

Para obtener una visión general del manejo de gestos en Qt e información sobre cómo utilizarlos en tus aplicaciones, consulta el documento «Gestos en Qt Widgets y la vista gráfica ».

Propiedades de los gestos

La clase dispone de una lista de propiedades que el usuario puede consultar para obtener algunos argumentos específicos de los gestos. Por ejemplo, el gesto de pellizco tiene un factor de escala que se expone como una propiedad.

Los desarrolladores de reconocedores de gestos personalizados pueden añadir propiedades adicionales para proporcionar información complementaria sobre un gesto. Esto puede hacerse añadiendo nuevas propiedades dinámicas a un objeto `QGesture`, o creando una subclase de la clase `QGesture` (o de una de sus subclases).

Ciclo de vida de un objeto Gesture

Una instancia de QGesture se crea implícitamente cuando es necesario y es propiedad de Qt. Los desarrolladores nunca deben destruirlas ni almacenarlas para su uso posterior, ya que Qt puede destruir instancias concretas de las mismas y crear otras nuevas para sustituirlas.

El reconocedor de gestos registrado supervisa los eventos de entrada del objeto de destino a través de su función ` recognize()`, actualizando las propiedades del objeto de gesto según sea necesario.

El objeto de gesto puede entregarse al objeto de destino en un ` QGestureEvent ` si el gesto correspondiente está activo o acaba de cancelarse. Cada evento que se entrega contiene una lista de objetos de gesto, ya que puede estar habilitado el soporte para más de un gesto en el objeto de destino. Debido a la forma en que se gestionan los eventos en Qt, los eventos de gesto pueden ser filtrados por otros objetos.

Véase también QGestureEvent y QGestureRecognizer.

Documentación sobre los tipos de miembros

enum QGesture::GestureCancelPolicy

Esta enumeración describe cómo la aceptación de un gesto puede cancelar automáticamente otros gestos.

ConstanteValorDescripción
QGesture::CancelNone0Al aceptar este gesto, ningún otro gesto se verá afectado.
QGesture::CancelAllInContext1Al aceptar este gesto, se cancelarán todos los gestos que estén activos en el contexto (respetando las propiedades « Qt::GestureFlag » especificadas al suscribirse al gesto).

Documentación de la propiedad

gestureCancelPolicy : QGesture::GestureCancelPolicy

Esta propiedad define la política para determinar qué ocurre al aceptar un gesto

Al aceptar un gesto, Qt puede cancelar automáticamente otros gestos que pertenezcan a otros objetivos. La política suele estar configurada para no cancelar ningún otro gesto, aunque se puede configurar para que cancele todos los gestos activos en el contexto. Por ejemplo, para todos los widgets hijos.

Funciones de acceso:

QGesture::GestureCancelPolicy gestureCancelPolicy() const
void setGestureCancelPolicy(QGesture::GestureCancelPolicy policy)

[read-only] gestureType : Qt::GestureType

Esta propiedad contiene el tipo del gesto

Funciones de acceso:

Qt::GestureType gestureType() const

[read-only] hasHotSpot : bool

Esta propiedad indica si el gesto tiene un punto activo

Funciones de acceso:

bool hasHotSpot() const

hotSpot : QPointF

Esta propiedad contiene el punto que se utiliza para localizar al receptor del evento de gesto.

El punto activo es un punto en el sistema de coordenadas global; utiliza QWidget::mapFromGlobal() o QGestureEvent::mapToGraphicsScene() para obtener un punto activo local.

El punto activo debe ser establecido por el reconocedor de gestos para permitir que el evento de gesto se envíe a un QGraphicsObject.

Funciones de acceso:

QPointF hotSpot() const
void setHotSpot(const QPointF &value)
void unsetHotSpot()

[read-only] state : Qt::GestureState

Esta propiedad contiene el estado actual del gesto

Funciones de acceso:

Qt::GestureState state() const

Documentación de las funciones de miembro

[explicit] QGesture::QGesture(QObject *parent = nullptr)

Crea un nuevo objeto de gesto con el ` parent` indicado.

Los objetos `QGesture` son creados por los reconocedores de gestos en la función ` QGestureRecognizer::create()`.

[virtual noexcept] QGesture::~QGesture()

Elimina el objeto de gesto.

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