QHoverEvent Class
La clase QHoverEvent contiene parámetros que describen un evento del ratón. Más información...
| Cabecera: | #include <QHoverEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QSinglePointEvent |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QHoverEvent forma parte de las clases de eventos.
Funciones públicas
| QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QPoint | oldPos() const |
| QPointF | oldPosF() const |
Funciones protegidas
| QHoverEvent(QHoverEvent &&) | |
| QHoverEvent & | operator=(QHoverEvent &&) |
| QHoverEvent & | operator=(const QHoverEvent &other) |
Descripción detallada
Los eventos de ratón se producen cuando el cursor del ratón entra, sale o se desplaza dentro de un control, siempre que este tenga el atributo « Qt::WA_Hover ».
La función ` position()` devuelve la posición actual del cursor, mientras que ` oldPos()` devuelve la posición anterior del ratón.
Existen algunas similitudes entre los eventos ` QEvent::HoverEnter ` y ` QEvent::HoverLeave`, y los eventos ` QEvent::Enter ` y ` QEvent::Leave`. Sin embargo, son ligeramente diferentes porque en el controlador de eventos de `HoverEnter` y `HoverLeave` se ejecuta una llamada a `update()`.
QEvent::HoverMove también es ligeramente diferente de QEvent::MouseMove. Consideremos una ventana de nivel superior A que contiene una ventana secundaria B, la cual, a su vez, contiene una ventana secundaria C (todas con el seguimiento del ratón activado):

Ahora bien, si mueves el cursor de arriba abajo por el centro de A, obtendrás los siguientes eventos de QEvent::MouseMove:
- A::MouseMove
- B::MouseMove
- C::MouseMove
Obtendrás los mismos eventos para « QEvent::HoverMove », salvo que el evento siempre se propaga al nivel superior, independientemente de si se acepta o no. Solo dejará de propagarse con el atributo « Qt::WA_NoMousePropagation ».
En este caso, los eventos se producirán de la siguiente manera:
- A::HoverMove
- A::HoverMove, B::HoverMove
- A::HoverMove, B::HoverMove, C::HoverMove
Documentación de funciones de miembro
QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
Crea un objeto de evento «hover» procedente de device.
El parámetro ` type ` debe ser ` QEvent::HoverEnter`, ` QEvent::HoverLeave` o ` QEvent::HoverMove`.
scenePos es la posición actual del cursor del ratón con respecto a la ventana o escena receptora, oldPos es su posición anterior con respecto a dicha ventana o escena, y globalPos es la posición del ratón en coordenadas absolutas. modifiers contiene el estado de todos los modificadores del teclado en el momento del evento.
[protected delete] QHoverEvent::QHoverEvent(QHoverEvent &&)
Crea mediante «move» una instancia de ` QHoverEvent`. Esta función se ha eliminado.
QPoint QHoverEvent::oldPos() const
Devuelve la posición anterior del cursor del ratón, en relación con el widget que recibió el evento. Si no hay una posición anterior, oldPos() devolverá la misma posición que position().
En los eventos « QEvent::HoverEnter », esta posición será siempre « QPoint » (-1, -1).
Véase también position().
QPointF QHoverEvent::oldPosF() const
Devuelve la posición anterior del cursor del ratón, relativa al widget que recibió el evento. Si no hay ninguna posición anterior, oldPosF() devolverá la misma posición que position().
En los eventos « QEvent::HoverEnter », esta posición será siempre « QPointF » (-1, -1).
Véase también position().
[protected delete] QHoverEvent &QHoverEvent::operator=(QHoverEvent &&)
Asigna mediante «move» ` other ` a esta instancia de ` QHoverEvent `. Esta función se elimina.
[noexcept protected default] QHoverEvent &QHoverEvent::operator=(const QHoverEvent &other)
Asigna por copia other a esta instancia de QHoverEvent.
© 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.