En esta página

QSinglePointEvent Class

Una clase base para eventos de puntero que contienen un único punto, como los eventos de ratón. Más...

Cabecera: #include <QSinglePointEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.0
Hereda de: QPointerEvent
Heredado de:

QEnterEvent, QHoverEvent, QMouseEvent, QNativeGestureEvent, QTabletEvent, y QWheelEvent

Propiedades

Funciones públicas

Qt::MouseButton button() const
Qt::MouseButtons buttons() const
QObject *exclusivePointGrabber() const
QPointF globalPosition() const
QPointF position() const
QPointF scenePosition() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Funciones públicas reimplementadas

virtual bool isBeginEvent() const override
virtual bool isEndEvent() const override
virtual bool isUpdateEvent() const override

Descripción detallada

Documentación de propiedades

exclusivePointGrabber : QObject*

Esta propiedad contiene el objeto que recibirá las futuras actualizaciones

El captador exclusivo es un objeto que ha elegido recibir todos los futuros eventos de actualización y el evento de liberación que contenga el mismo punto que este evento lleva.

Establecer la propiedad exclusivePointGrabber es un equivalente de conveniencia:

setExclusiveGrabber(points().first(), exclusiveGrabber);

Funciones de acceso:

QObject *exclusivePointGrabber() const
void setExclusivePointGrabber(QObject *exclusiveGrabber)

Documentación de funciones miembro

Qt::MouseButton QSinglePointEvent::button() const

Devuelve el botón que causó el evento.

El valor devuelto es siempre Qt::NoButton para eventos de movimiento del ratón, así como TabletMove, TabletEnterProximity, y TabletLeaveProximity eventos.

Véase también buttons().

Qt::MouseButtons QSinglePointEvent::buttons() const

Devuelve el estado del botón cuando se generó el evento.

El estado del botón es una combinación de Qt::LeftButton, Qt::RightButton, y Qt::MiddleButton utilizando el operador OR.

Para los eventos de movimiento del ratón o TabletMove, se trata de todos los botones que están pulsados.

Para los eventos de pulsación del ratón, doble clic o TabletPress, esto incluye el botón que causó el evento.

Para los eventos de liberación del ratón o TabletRelease, se excluye el botón que causó el evento.

Véase también button().

QPointF QSinglePointEvent::globalPosition() const

Devuelve la posición del punto de este evento en la pantalla o escritorio virtual.

Nota: La posición global de un puntero de ratón se registra en el momento del evento. Esto es importante en sistemas de ventanas asíncronos como X11; cuando mueves tus widgets en respuesta a eventos de ratón, globalPosition() puede diferir mucho de la posición actual del cursor devuelta por QCursor::pos().

Véase también position().

[override virtual] bool QSinglePointEvent::isBeginEvent() const

Devuelve true si este evento representa la pulsación de button.

[override virtual] bool QSinglePointEvent::isEndEvent() const

Devuelve true si este evento representa la liberación de un button.

[override virtual] bool QSinglePointEvent::isUpdateEvent() const

Devuelve true si este evento no incluye un cambio en button state.

QPointF QSinglePointEvent::position() const

Devuelve la posición del punto en este evento, relativa al widget o elemento que recibió el evento.

Si mueves tus widgets en respuesta a eventos de ratón, utiliza globalPosition() en su lugar.

Véase también globalPosition().

QPointF QSinglePointEvent::scenePosition() const

Devuelve la posición del punto en este evento, relativa a la ventana o escena.

Véase también QEventPoint::scenePosition.

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