QMouseEvent Class
La clase QMouseEvent contiene parametros que describen un evento de raton. Más...
| Cabecera: | #include <QMouseEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Hereda: | QSinglePointEvent |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QMouseEvent es parte de Clases de Eventos.
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 |
Descripción Detallada
Los eventos de ratón se producen cuando se pulsa o suelta un botón del ratón dentro de un widget, o cuando se mueve el cursor del ratón.
Los eventos de movimiento del ratón se producirán sólo cuando se pulse un botón del ratón, a menos que se haya habilitado el seguimiento del ratón con QWidget::setMouseTracking().
Qt coge automáticamente el ratón cuando se pulsa un botón del ratón dentro de un widget; el widget continuará recibiendo eventos de ratón hasta que se suelte el último botón del ratón.
Un evento de ratón contiene una bandera especial de aceptación que indica si el receptor quiere el evento. Deberías llamar a ignore() si el evento de ratón no es manejado por tu widget. Un evento de ratón se propaga por la cadena de widgets padre 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, ese evento de ratón no se propagará más arriba en la cadena del widget padre.
El estado de las teclas modificadoras del teclado puede encontrarse 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 de ratón. Si mueves el widget como resultado del evento del ratón, utiliza la posición global devuelta por globalPosition() para evitar un movimiento brusco.
La función QWidget::setEnabled() puede utilizarse para activar o desactivar los eventos de ratón y teclado de un widget.
Reimplemente los manejadores de eventos QWidget, QWidget::mousePressEvent(), QWidget::mouseReleaseEvent(), QWidget::mouseDoubleClickEvent(), y QWidget::mouseMoveEvent() para recibir eventos de ratón en sus propios widgets.
Véase también QWidget::setMouseTracking(), QWidget::grabMouse(), y QCursor::pos().
Documentación de las funciones 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())
Construye un objeto de evento de ratón originado en 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 relativa al widget o elemento receptor. La posición del cursor en coordenadas de pantalla se especifica en globalPos. La posición de la ventana se establece en el mismo valor que localPos. El button que causó el evento se da como un valor del enum Qt::MouseButton. Si el evento type es MouseMove, el botón apropiado para este evento es Qt::NoButton. buttons es el estado de todos los botones en el momento del evento, modifiers el estado de todos los modificadores de 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())
Construye un objeto de evento de 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 relativa al widget o elemento receptor, ventana y pantalla o escritorio, respectivamente.
El button que causó el evento se da como un valor del enum Qt::MouseButton. Si el evento type es MouseMove, el botón apropiado para este evento es Qt::NoButton. buttons es el estado de todos los botones en el momento del evento, modifiers es el estado de todos los modificadores de teclado.
Qt::MouseEventFlags QMouseEvent::flags() const
Devuelve los indicadores de eventos de ratón.
Las banderas de eventos de ratón proporcionan información adicional sobre un evento de ratón.
Véase también Qt::MouseEventFlag y QGraphicsSceneMouseEvent::flags().
© 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.
