QGestureEvent Class
La clase QGestureEvent proporciona la descripción de los gestos activados. Más información...
| Encabezado: | #include <QGestureEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QEvent |
- Lista de todos los miembros, incluidos los heredados
- QGestureEvent forma parte de las 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, a la que se puede acceder mediante la función gestures().
Los gestos pueden estar activos o cancelados. Se puede obtener una lista de los que se están ejecutando actualmente mediante la función activeGestures(). Se puede acceder a una lista de los que estaban activos anteriormente y se han cancelado mediante la función canceledGestures(). Un gesto puede cancelarse si, por ejemplo, la ventana actual pierde el foco, por un tiempo de espera agotado 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 hacia arriba por la cadena de widgets padres hasta que un widget los acepte individualmente, llamando a ` QGestureEvent::accept()` para cada uno de ellos, o hasta que un filtro de eventos consuma el evento.
Más información
Para obtener una visión general del manejo de gestos en Qt e información sobre cómo utilizar gestos en sus aplicaciones, consulte el documento «Gestos en Qt Widgets y la vista gráfica ».
Véase también « QGesture» , « QGestureRecognizer », « QWidget::grabGesture()» y « QGraphicsObject::grabGesture()».
Documentación de funciones de miembro
[explicit] QGestureEvent::QGestureEvent(const QList<QGesture *> &gestures)
Crea un nuevo objeto `QGestureEvent` que contiene una lista de objetos ` gestures`.
[virtual noexcept] QGestureEvent::~QGestureEvent()
Destruye QGestureEvent.
void QGestureEvent::accept(QGesture *gesture)
Establece el indicador de aceptación del objeto ` gesture ` indicado, lo que equivale a llamar a ` setAccepted(gesture, true)`.
Establecer el indicador de aceptación indica que el receptor de eventos desea el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::ignore().
void QGestureEvent::accept(Qt::GestureType gestureType)
Establece el indicador de aceptación del « gestureType » indicado, lo que equivale a llamar a « setAccepted(gestureType, true)».
Establecer el indicador de aceptación indica que el receptor de eventos desea 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 de gesto mediante ` type`.
QList<QGesture *> QGestureEvent::gestures() const
Devuelve todos los gestos que se han enviado en el evento.
void QGestureEvent::ignore(QGesture *gesture)
Borra el parámetro «accept flag» del objeto ` gesture ` indicado, lo que equivale a llamar a ` setAccepted(gesture, false)`.
Al borrar el indicador «accept», se indica que el receptor de eventos no desea el gesto. Los gestos no deseados pueden propagarse al widget padre.
Véase también QGestureEvent::accept().
void QGestureEvent::ignore(Qt::GestureType gestureType)
Borra el parámetro «accept flag» del « gestureType » indicado; equivale a llamar a « setAccepted(gesture, false)».
Al borrar el indicador de aceptación se indica que el receptor de eventos no desea 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 el « 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 el objeto « gesturePoint » se encuentra dentro de una vista gráfica.
Esta función puede resultar útil cuando se envía un evento de gesto a un ` QGraphicsObject ` para convertir un punto en coordenadas de pantalla a coordenadas locales de la escena.
Véase también QPointF::isNull().
void QGestureEvent::setAccepted(QGesture *gesture, bool value)
Establece el indicador «accept» del objeto « gesture » indicado en el valor especificado « value ».
Al establecer el indicador de aceptación se indica que el receptor de eventos desea el tipo de evento « gesture ». Los gestos no deseados pueden propagarse al widget padre.
Por defecto, se aceptan los gestos en eventos de tipo « QEvent::Gesture », y se ignoran los gestos en eventos de tipo « QEvent::GestureOverride ».
Para mayor comodidad, el indicador de aceptación también se puede establecer con ` accept(gesture)` y desactivar con ` ignore(gesture)`.
Véase también isAccepted().
void QGestureEvent::setAccepted(Qt::GestureType gestureType, bool value)
Establece el indicador «accept» del objeto « gestureType » dado en el valor especificado « value ».
Establecer el indicador «accept» indica que el receptor de eventos desea recibir gestos del tipo especificado, « gestureType ». Los gestos no deseados pueden propagarse al widget padre.
Por defecto, se aceptan los gestos en eventos de tipo QEvent::Gesture, y se ignoran los gestos en eventos de tipo QEvent::GestureOverride.
Para mayor comodidad, el indicador de aceptación también se puede establecer con ` accept(gestureType)` y desactivar con ` ignore(gestureType)`.
QWidget *QGestureEvent::widget() const
Devuelve el widget en el que se produjo 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.