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