QGestureEvent Class
La clase QGestureEvent proporciona la descripción de los gestos activados. Más...
| Cabecera: | #include <QGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | QEvent |
- Lista de todos los miembros, incluyendo los heredados
- QGestureEvent es parte de Clases de Eventos.
Funciones Públicas
| QGestureEvent(const QList<QGesture *> &gestures) | |
| virtual | ~QGestureEvent() |
| void | accept(QGesture *gesture) |
| void | accept(Qt::GestureType gestureType) |
| QList<QGesture *> | activeGestures() const |
| QList<QGesture *> | canceledGestures() const |
| QGesture * | gesture(Qt::GestureType type) const |
| QList<QGesture *> | gestures() const |
| void | ignore(QGesture *gesture) |
| void | ignore(Qt::GestureType gestureType) |
| bool | isAccepted(QGesture *gesture) const |
| bool | isAccepted(Qt::GestureType gestureType) const |
| QPointF | mapToGraphicsScene(const QPointF &gesturePoint) const |
| void | setAccepted(QGesture *gesture, bool value) |
| void | setAccepted(Qt::GestureType gestureType, bool value) |
| QWidget * | widget() const |
Descripción Detallada
La clase QGestureEvent contiene una lista de gestos, que pueden ser obtenidos utilizando la función gestures().
Los gestos están activos o cancelados. Una lista de los que se están ejecutando actualmente se puede obtener utilizando la función activeGestures(). Se puede acceder a una lista de los que estaban activos anteriormente y se han cancelado utilizando la función canceledGestures(). Un gesto puede cancelarse si la ventana actual pierde el foco, por ejemplo, o debido a un tiempo de espera, o por otras razones.
Si el controlador de eventos no acepta el evento llamando a la función genérica QEvent::accept(), todos los objetos QGesture individuales que no hayan sido aceptados y se encuentren en el estado Qt::GestureStarted se propagarán por la cadena de widgets padre hasta que un widget los acepte individualmente, llamando a QGestureEvent::accept() para cada uno de ellos, o un filtro de eventos consuma el evento.
Más información
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.
Véase también QGesture, QGestureRecognizer, QWidget::grabGesture(), y QGraphicsObject::grabGesture().
Documentación de funciones miembro
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
Crea un nuevo QGestureEvent que contiene una lista de gestures.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Destruye QGestureEvent.
void QGestureEvent::accept(QGesture *gesture)
Establece la bandera de aceptación del objeto gesture dado, el equivalente a llamar a setAccepted(gesture, true).
Establecer la bandera de aceptación indica que el receptor del evento quiere el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Establece la bandera de aceptación del gestureType dado, el equivalente a llamar a setAccepted(gestureType, true).
Establecer la bandera de aceptación indica que el receptor del evento quiere el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::ignore().
QList<QGesture *> QGestureEvent::activeGestures() const
Devuelve una lista de gestos activos (no cancelados).
QList<QGesture *> QGestureEvent::canceledGestures() const
Devuelve una lista de gestos cancelados.
QGesture *QGestureEvent::gesture(Qt::GestureType type) const
Devuelve un objeto gestual mediante type.
QList<QGesture *> QGestureEvent::gestures() const
Devuelve todos los gestos entregados en el evento.
void QGestureEvent::ignore(QGesture *gesture)
Borra el parámetro accept flag del objeto gesture dado, lo que equivale a llamar a setAccepted(gesture, false).
Borrar la bandera de aceptación indica que el receptor del evento no quiere el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Borra la bandera de aceptación del parámetro gestureType, lo que equivale a llamar a setAccepted(gesture, false).
Borrar la bandera de aceptación indica que el receptor del evento no quiere el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::accept().
bool QGestureEvent::isAccepted(QGesture *gesture) const
Devuelve true si se acepta gesture; en caso contrario devuelve false.
bool QGestureEvent::isAccepted(Qt::GestureType gestureType) const
Devuelve true si se acepta el gesto de tipo gestureType; en caso contrario devuelve false.
QPointF QGestureEvent::mapToGraphicsScene(const QPointF &gesturePoint) const
Devuelve las coordenadas locales de la escena si gesturePoint está dentro de una vista gráfica.
Esta función puede ser útil cuando el evento de gesto se envía a QGraphicsObject para traducir un punto en coordenadas de pantalla a coordenadas locales de escena.
Véase también QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Establece la bandera de aceptación del objeto gesture dado al value especificado.
Establecer la bandera de aceptación indica que el receptor del evento quiere el gesture. Los gestos no deseados pueden propagarse al widget padre.
Por defecto, los gestos en eventos de tipo QEvent::Gesture son aceptados, y los gestos en eventos QEvent::GestureOverride son ignorados.
Para mayor comodidad, el indicador de aceptación también puede activarse con accept(gesto), y desactivarse con ignore(gesto).
Véase también isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Establece el indicador de aceptación del objeto gestureType en el valor especificado value.
Establecer la bandera de aceptación indica que el receptor de eventos quiere recibir gestos del tipo especificado, gestureType. Los gestos no deseados pueden propagarse al widget padre.
Por defecto, los gestos en eventos del tipo QEvent::Gesture son aceptados, y los gestos en eventos QEvent::GestureOverride son ignorados.
Para mayor comodidad, el indicador de aceptación también puede activarse con accept(gestureType) y desactivarse con ignore(gestureType).
QWidget *QGestureEvent::widget() const
Devuelve el widget en el que se ha producido el evento.
© 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.
