En esta página

QMouseEvent Class

La clase QMouseEvent contiene parámetros que describen un evento del ratón. Más información...

Encabezado: #include <QMouseEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QSinglePointEvent

Funciones públicas

QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
Qt::MouseEventFlags flags() const

Funciones protegidas

QMouseEvent(QMouseEvent &&)
QMouseEvent &operator=(QMouseEvent &&)
QMouseEvent &operator=(const QMouseEvent &other)

Descripción detallada

Los eventos de ratón se producen cuando se pulsa o se suelta un botón del ratón dentro de un control, o cuando se mueve el cursor del ratón.

Los eventos de movimiento del ratón solo se producirán cuando se mantenga pulsado un botón del ratón, a menos que se haya habilitado el seguimiento del ratón con ` QWidget::setMouseTracking()`.

Qt captura automáticamente el ratón cuando se pulsa un botón del ratón dentro de un widget; el widget seguirá recibiendo eventos del ratón hasta que se suelte el último botón.

Un evento de ratón contiene un indicador de aceptación especial que indica si el receptor desea el evento. Debes llamar a ` ignore()` si el evento de ratón no es gestionado por tu widget. Un evento de ratón se propaga hacia arriba por la cadena de widgets padres hasta que un widget lo acepta con ` accept()` o un filtro de eventos lo consume.

Nota: Si un evento de ratón se propaga a un ` widget ` para el que se ha establecido ` Qt::WA_NoMousePropagation `, dicho evento de ratón no se propagará más arriba en la cadena de widgets padres.

El estado de las teclas modificadoras del teclado se puede obtener llamando a la función modifiers(), heredada de QInputEvent.

La función position() proporciona la posición del cursor relativa al widget o elemento que recibe el evento del ratón. Si se desplaza el widget como resultado del evento del ratón, utilice la posición global devuelta por globalPosition() para evitar un movimiento oscilante.

La función ` QWidget::setEnabled()` se puede utilizar para habilitar o deshabilitar los eventos del ratón y del teclado para un widget.

Reimplementa los controladores de eventos ` QWidget `, ` QWidget::mousePressEvent()`, ` QWidget::mouseReleaseEvent()`, ` QWidget::mouseDoubleClickEvent()` y ` QWidget::mouseMoveEvent()` para recibir eventos del ratón en tus propios widgets.

Véase también QWidget::setMouseTracking(), QWidget::grabMouse() y QCursor::pos().

Documentación de las funciones de miembro

QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

Crea un objeto de evento de ratón procedente de device.

El parámetro « type » debe ser « QEvent::MouseButtonPress », « QEvent::MouseButtonRelease », « QEvent::MouseButtonDblClick » o « QEvent::MouseMove ».

localPos es la posición del cursor del ratón con respecto al widget o elemento receptor. La posición del cursor en coordenadas de pantalla se especifica mediante ` globalPos`. La posición de la ventana se establece en el mismo valor que ` localPos`. El ` button ` que provocó el evento se indica como un valor de la enumeración ` Qt::MouseButton `. Si el evento ` type ` es ` MouseMove`, el botón correspondiente a este evento es ` Qt::NoButton`. ` buttons ` es el estado de todos los botones en el momento del evento, y ` modifiers ` es el estado de todos los modificadores del teclado.

QMouseEvent::QMouseEvent(QEvent::Type type, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

Crea un objeto de evento del ratón.

El parámetro « type » debe ser « QEvent::MouseButtonPress », « QEvent::MouseButtonRelease », « QEvent::MouseButtonDblClick » o « QEvent::MouseMove ».

Los puntos localPos, scenePos y globalPos especifican la posición del cursor del ratón respecto al widget o elemento receptor, a la ventana y a la pantalla o el escritorio, respectivamente.

El button que ha provocado el evento se indica como un valor de la enumeración Qt::MouseButton. Si el evento type es MouseMove, el botón correspondiente a este evento es Qt::NoButton. buttons es el estado de todos los botones en el momento del evento, mientras que modifiers es el estado de todos los modificadores del teclado.

[protected delete] QMouseEvent::QMouseEvent(QMouseEvent &&)

Crea una instancia de ` QMouseEvent`. Esta función se ha eliminado.

Qt::MouseEventFlags QMouseEvent::flags() const

Devuelve los indicadores del evento del ratón.

Los indicadores de eventos del ratón proporcionan información adicional sobre un evento del ratón.

Véase también Qt::MouseEventFlag y QGraphicsSceneMouseEvent::flags().

[protected delete] QMouseEvent &QMouseEvent::operator=(QMouseEvent &&)

Asigna mediante «move» other a esta instancia de QMouseEvent. Esta función se elimina.

[noexcept protected default] QMouseEvent &QMouseEvent::operator=(const QMouseEvent &other)

Asigna por copia other a esta instancia de QMouseEvent.

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