En esta página

QGestureRecognizer Class

La clase QGestureRecognizer proporciona la infraestructura necesaria para el reconocimiento de gestos. Más información...

Encabezado: #include <QGestureRecognizer>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Tipos públicos

flags Result
enum ResultFlag { Ignore, MayBeGesture, TriggerGesture, FinishGesture, CancelGesture, ConsumeEventHint }

Funciones públicas

QGestureRecognizer()
virtual ~QGestureRecognizer()
virtual QGesture *create(QObject *target)
virtual QGestureRecognizer::Result recognize(QGesture *gesture, QObject *watched, QEvent *event) = 0
virtual void reset(QGesture *gesture)

Miembros públicos estáticos

Qt::GestureType registerRecognizer(QGestureRecognizer *recognizer)
void unregisterRecognizer(Qt::GestureType type)

Descripción detallada

Los reconocedores de gestos se encargan de crear y gestionar objetos ` QGesture `, así como de supervisar los eventos de entrada enviados a las subclases ` QWidget ` y ` QGraphicsObject `. `QGestureRecognizer` es la clase base para implementar gestos personalizados.

Los desarrolladores que solo necesiten proporcionar reconocimiento de gestos estándar no tienen que utilizar esta clase directamente. El marco de trabajo creará las instancias de forma interna.

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

Reconocimiento de gestos

El proceso de reconocimiento de gestos implica filtrar los eventos de entrada enviados a objetos específicos y modificar los objetos ` QGesture ` asociados para incluir información relevante sobre la entrada del usuario.

Los gestos se crean cuando el marco de trabajo llama a ` create()` para gestionar la entrada del usuario para una instancia concreta de una subclase de ` QWidget ` o ` QGraphicsObject `. Se crea un objeto ` QGesture ` para cada widget o elemento que esté configurado para utilizar gestos.

Una vez creado un ` QGesture ` para un objeto de destino, el reconocedor de gestos recibirá eventos relacionados con él en su función de gestión ` recognize()`.

Cuando se cancela un gesto, se llama a la función ` reset()`, lo que permite al reconocedor actualizar las propiedades adecuadas en el objeto ` QGesture ` correspondiente.

Compatibilidad con nuevos gestos

Para añadir compatibilidad con nuevos gestos, debes derivar de `QGestureRecognizer` para crear una clase de reconocedor personalizada, construir una instancia de esta clase y registrarla en la aplicación llamando a ` QGestureRecognizer::registerRecognizer()`. También puedes crear una subclase de ` QGesture ` para crear una clase de gesto personalizada, o recurrir a propiedades dinámicas para expresar detalles específicos del gesto que deseas gestionar.

Tu subclase personalizada de QGestureRecognizer debe reimplementar la función recognize() para gestionar y filtrar los eventos de entrada que reciben las subclases de QWidget y QGraphicsObject. Aunque la lógica de reconocimiento de gestos se implementa en esta función, puedes almacenar información persistente sobre el estado del proceso de reconocimiento en el objeto QGesture proporcionado. La función ` recognize()` debe devolver un valor de tipo ` QGestureRecognizer::Result ` que indique el estado del reconocimiento para un gesto y un objeto de destino determinados. Esto determina si un evento de gesto se enviará o no a un objeto de destino.

Si decide representar un gesto mediante una subclase personalizada de ` QGesture `, deberá reimplementar la función ` create()` para crear instancias de su clase de gestos. Del mismo modo, es posible que tenga que reimplementar la función ` reset()` si sus objetos de gestos personalizados deben tratarse de forma especial cuando se cancela un gesto.

Véase también QGesture.

Documentación sobre tipos de miembros

enum QGestureRecognizer::ResultFlag
flags QGestureRecognizer::Result

Esta enumeración describe el resultado de la etapa actual de filtrado de eventos en una máquina de estados de un reconocedor de gestos.

El resultado consta de un valor de estado (uno de los siguientes: «Ignore», «MayBeGesture», «TriggerGesture», «FinishGesture» o «CancelGesture») y una sugerencia opcional («ConsumeEventHint»).

ConstanteValorDescripción
QGestureRecognizer::Ignore0x0001El evento no cambia el estado del reconocedor.
QGestureRecognizer::MayBeGesture0x0002El evento ha cambiado el estado interno del reconocedor, pero aún no está claro si se trata de un gesto o no. El reconocedor necesita filtrar más eventos para decidirlo. Los reconocedores de gestos en el estado «MayBeGesture» pueden reiniciarse automáticamente si tardan demasiado en reconocer los gestos.
QGestureRecognizer::TriggerGesture0x0004Se ha activado el gesto y el objeto « QGesture » correspondiente se enviará al destino como parte de un « QGestureEvent ».
QGestureRecognizer::FinishGesture0x0008El gesto ha finalizado correctamente y el objeto ` QGesture ` correspondiente se enviará al destino como parte de un ` QGestureEvent`.
QGestureRecognizer::CancelGesture0x0010El evento ha dejado claro que no se trata de un gesto. Si el reconocedor de gestos se encontraba anteriormente en el estado «GestureTriggered», el gesto se cancela y el objeto QGesture correspondiente se enviará al destino como parte de un QGestureEvent.
QGestureRecognizer::ConsumeEventHint0x0100Esta indicación especifica que el marco de gestos debe consumir el evento filtrado y no entregarlo al receptor.

El tipo Result es un typedef para QFlags<ResultFlag>. Almacena una combinación OR de valores de ResultFlag.

Véase también QGestureRecognizer::recognize().

Documentación de funciones miembro

QGestureRecognizer::QGestureRecognizer()

Crea un nuevo objeto de reconocimiento de gestos.

[virtual noexcept] QGestureRecognizer::~QGestureRecognizer()

Elimina el reconocedor de gestos.

[virtual] QGesture *QGestureRecognizer::create(QObject *target)

Qt invoca esta función para crear un nuevo objeto ` QGesture ` para el ` target ` especificado (QWidget o QGraphicsObject).

Reimplementa esta función para crear un objeto de gesto personalizado derivado de ` QGesture` si es necesario.

QApplication Asume la propiedad del objeto de gesto creado.

[pure virtual] QGestureRecognizer::Result QGestureRecognizer::recognize(QGesture *gesture, QObject *watched, QEvent *event)

Gestiona el « event » proporcionado para el objeto « watched », actualizando el estado del objeto « gesture » según sea necesario, y devuelve un resultado adecuado para el paso de reconocimiento actual.

El marco de trabajo invoca esta función para permitir que el reconocedor filtre los eventos de entrada enviados a las instancias de ` QWidget ` o ` QGraphicsObject ` que está supervisando.

El resultado refleja la parte del gesto que se ha reconocido. El estado del objeto gesture se establece en función del resultado.

Véase también QGestureRecognizer::Result.

[static] Qt::GestureType QGestureRecognizer::registerRecognizer(QGestureRecognizer *recognizer)

Registra el « recognizer » proporcionado en el marco de gestos y devuelve un identificador de gesto correspondiente.

QApplication Asume la propiedad del objeto ` recognizer` y esta función devuelve el identificador de tipo de gesto asociado a él. En el caso de los reconocedores de gestos que gestionan objetos ` QGesture ` personalizados (aquellos que devuelven ` Qt::CustomGesture ` en la función ` QGesture::gestureType()`), el valor devuelto es un identificador de gesto generado con el indicador ` Qt::CustomGesture ` activado.

Véase también unregisterRecognizer(), QGestureRecognizer::create() y QGesture.

[virtual] void QGestureRecognizer::reset(QGesture *gesture)

Qt invoca esta función para restablecer un objeto ` gesture` determinado.

Reimplementa esta función para implementar requisitos adicionales para objetos « QGesture » personalizados. Esto puede ser necesario si implementas un « QGesture » personalizado cuyas propiedades requieran un tratamiento especial al restablecerse el gesto.

[static] void QGestureRecognizer::unregisterRecognizer(Qt::GestureType type)

Da de baja todos los reconocedores de gestos del type especificado.

Véase también registerRecognizer().

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