QGestureRecognizer Class

Descripción detallada

Los reconocedores de gestos son responsables de crear y gestionar los objetos QGesture y de monitorizar los eventos de entrada enviados a las subclases QWidget y QGraphicsObject. QGestureRecognizer es la clase base para implementar gestos personalizados.

Los desarrolladores que sólo necesitan proporcionar reconocimiento de gestos para gestos estándar no necesitan utilizar esta clase directamente. El framework creará las instancias entre bastidores.

Para una visión general del manejo de gestos en Qt e información sobre el uso de gestos en tus aplicaciones, consulta el documento Gestures in Widgets and Graphics View.

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 framework llama a create() para manejar la entrada del usuario para una instancia particular de una subclase QWidget o QGraphicsObject. Se crea un objeto QGesture para cada widget o elemento configurado para utilizar gestos.

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

Cuando se cancela un gesto, se llama a la función reset(), dando al reconocedor la oportunidad de actualizar las propiedades apropiadas en el objeto QGesture correspondiente.

Soporte de nuevos gestos

Para añadir soporte para nuevos gestos, es necesario derivar de QGestureRecognizer para crear una clase de reconocedor personalizada, construir una instancia de esta clase y registrarla con la aplicación llamando a QGestureRecognizer::registerRecognizer(). También puedes subclasificar QGesture para crear una clase de gesto personalizada, o basarte en propiedades dinámicas para expresar detalles específicos del gesto que quieres manejar.

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

Si decides representar un gesto mediante una subclase personalizada de QGesture, deberás reimplementar la función create() para construir instancias de tu clase de gesto. Del mismo modo, es posible que tenga que reimplementar la función reset() si sus objetos gestuales personalizados necesitan un tratamiento especial cuando se cancela un gesto.