QGesture Class
La clase QGesture representa un gesto, conteniendo propiedades que describen la correspondiente entrada del usuario. Más...
| Cabecera: | #include <QGesture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QObject |
| Heredado de: | 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 gestuales no son construidos directamente por los desarrolladores. Son creados por el objeto QGestureRecognizer que está registrado en la aplicación; véase QGestureRecognizer::registerRecognizer().
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.
Propiedades de los gestos
La clase tiene una lista de propiedades que pueden ser consultadas por el usuario para obtener algunos argumentos específicos del gesto. Por ejemplo, el gesto de pellizcar 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 adicional sobre un gesto. Esto puede hacerse añadiendo nuevas propiedades dinámicas a un objeto QGesture, o subclasificando la clase QGesture (o una de sus subclases).
Ciclo de vida de un objeto Gesture
Una instancia de QGesture se crea implícitamente cuando se necesita y es propiedad de Qt. Los desarrolladores nunca deben destruirlas ni almacenarlas para su uso posterior, ya que Qt puede destruir instancias concretas y crear otras nuevas para sustituirlas.
El reconocedor de gestos registrado supervisa los eventos de entrada para el objeto de destino a través de su función recognize(), actualizando las propiedades del objeto gestual según sea necesario.
El objeto gestual puede entregarse al objeto de destino en QGestureEvent si el gesto correspondiente está activo o acaba de cancelarse. Cada evento que se entrega contiene una lista de objetos gestuales, ya que el soporte para más de un gesto puede estar habilitado para el objeto de destino. Debido a la forma en que se manejan los eventos en Qt, los eventos de gestos pueden ser filtrados por otros objetos.
Véase también QGestureEvent y QGestureRecognizer.
Documentación de tipos de miembros
enum QGesture::GestureCancelPolicy
Este enum describe cómo la aceptación de un gesto puede cancelar otros gestos automáticamente.
| Constante | Valor | Descripción |
|---|---|---|
QGesture::CancelNone | 0 | Al aceptar este gesto, ningún otro gesto se verá afectado. |
QGesture::CancelAllInContext | 1 | Al aceptar este gesto se cancelarán todos los gestos que estén activos en el contexto (respetando la dirección Qt::GestureFlag que se especificó al suscribirse al gesto). |
Documentación de la propiedad
gestureCancelPolicy : QGesture::GestureCancelPolicy
Esta propiedad contiene la política para decidir qué sucede al aceptar un gesto
Al aceptar un gesto, Qt puede cancelar automáticamente otros gestos que pertenezcan a otros objetivos. La política normalmente se establece para no cancelar ningún otro gesto y puede establecerse para cancelar 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 de gesto
Funciones de acceso:
| Qt::GestureType | gestureType() const |
[read-only] hasHotSpot : bool
Esta propiedad indica si el gesto tiene un punto caliente
Funciones de acceso:
| bool | hasHotSpot() const |
hotSpot : QPointF
Esta propiedad contiene el punto que se utiliza para encontrar el receptor del evento gestual.
El punto caliente es un punto en el sistema de coordenadas global, utilice QWidget::mapFromGlobal() o QGestureEvent::mapToGraphicsScene() para obtener un punto caliente local.
El punto caliente debe ser establecido por el reconocedor de gestos para permitir la entrega del evento gestual 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 funciones miembro
[explicit] QGesture::QGesture(QObject *parent = nullptr)
Construye un nuevo objeto gestual con la dirección parent.
Los objetos QGesture son creados por los reconocedores de gestos en la función QGestureRecognizer::create().
[virtual noexcept] QGesture::~QGesture()
Destruye el objeto 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.
