- Qt 6.8
- Qt Widgets
- C++ Classes
- QGraphicsSceneMouseEvent
- Qt 6.8.1 Reference Documentation

# QGraphicsSceneMouseEvent Class

The QGraphicsSceneMouseEvent class provides mouse events in the graphics view framework. More...

Header: | `#include <QGraphicsSceneMouseEvent>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS Widgets)` `target_link_libraries(mytarget PRIVATE Qt6::Widgets)`
qmake: | `QT += widgets`
Inherits: | QGraphicsSceneEvent

- List of all members, including inherited members

## Public Functions

virtual | ~QGraphicsSceneMouseEvent()
Qt::MouseButton | button() const
QPointF | buttonDownPos(Qt::MouseButton button) const
QPointF | buttonDownScenePos(Qt::MouseButton button) const
QPoint | buttonDownScreenPos(Qt::MouseButton button) const
Qt::MouseButtons | buttons() const
Qt::MouseEventFlags | flags() const
QPointF | lastPos() const
QPointF | lastScenePos() const
QPoint | lastScreenPos() const
Qt::KeyboardModifiers | modifiers() const
QPointF | pos() const
QPointF | scenePos() const
QPoint | screenPos() const
Qt::MouseEventSource | source() const

## Detailed Description

When a QGraphicsView receives a QMouseEvent, it translates it to a QGraphicsSceneMouseEvent. The event is then forwarded to the QGraphicsScene associated with the view. If the event is not handled by the scene, the view may use it, e.g., for the DragMode.

In addition to containing the item, scene, and screen coordinates of the event (as pos(), scenePos(), and screenPos()), mouse events also contain the coordinates of the previous mouse event received by the view. These can be retrieved with lastPos(), lastScreenPos(), and lastScenePos().

See also QGraphicsSceneContextMenuEvent, QGraphicsSceneHoverEvent, QGraphicsSceneWheelEvent, and QMouseEvent.

## Member Function Documentation

### `[virtual noexcept]` QGraphicsSceneMouseEvent::~QGraphicsSceneMouseEvent()

Destroys the event.

### Qt::MouseButton QGraphicsSceneMouseEvent::button() const

Returns the mouse button (if any) that caused the event.

See also buttons() and modifiers().

### QPointF QGraphicsSceneMouseEvent::buttonDownPos(Qt::MouseButton button) const

Returns the mouse cursor position in item coordinates where the specified button was clicked.

See also buttonDownScenePos(), buttonDownScreenPos(), and pos().

### QPointF QGraphicsSceneMouseEvent::buttonDownScenePos(Qt::MouseButton button) const

Returns the mouse cursor position in scene coordinates where the specified button was clicked.

See also buttonDownPos(), buttonDownScreenPos(), and scenePos().

### QPoint QGraphicsSceneMouseEvent::buttonDownScreenPos(Qt::MouseButton button) const

Returns the mouse cursor position in screen coordinates where the specified button was clicked.

See also screenPos(), buttonDownPos(), and buttonDownScenePos().

### Qt::MouseButtons QGraphicsSceneMouseEvent::buttons() const

Returns the combination of mouse buttons that were pressed at the time the event was sent.

See also button() and modifiers().

### Qt::MouseEventFlags QGraphicsSceneMouseEvent::flags() const

Returns the mouse event flags.

The mouse event flags provide additional information about a mouse event.

See also Qt::MouseEventFlag and QMouseEvent::flags().

### QPointF QGraphicsSceneMouseEvent::lastPos() const

Returns the last recorded mouse cursor position in item coordinates.

See also lastScenePos(), lastScreenPos(), and pos().

### QPointF QGraphicsSceneMouseEvent::lastScenePos() const

Returns the last recorded mouse cursor position in scene coordinates. The last recorded position is the position of the previous mouse event received by the view that created the event.

See also lastPos(), lastScreenPos(), and scenePos().

### QPoint QGraphicsSceneMouseEvent::lastScreenPos() const

Returns the last recorded mouse cursor position in screen coordinates. The last recorded position is the position of the previous mouse event received by the view that created the event.

See also lastPos(), lastScenePos(), and screenPos().

### Qt::KeyboardModifiers QGraphicsSceneMouseEvent::modifiers() const

Returns the keyboard modifiers in use at the time the event was sent.

See also buttons() and button().

### QPointF QGraphicsSceneMouseEvent::pos() const

Returns the mouse cursor position in item coordinates.

See also scenePos(), screenPos(), and lastPos().

### QPointF QGraphicsSceneMouseEvent::scenePos() const

Returns the mouse cursor position in scene coordinates.

See also pos(), screenPos(), and lastScenePos().

### QPoint QGraphicsSceneMouseEvent::screenPos() const

Returns the mouse cursor position in screen coordinates.

See also pos(), scenePos(), and lastScreenPos().

### Qt::MouseEventSource QGraphicsSceneMouseEvent::source() const

Returns information about the mouse event source.

The mouse event source can be used to distinguish between genuine and artificial mouse events. The latter are events that are synthesized from touch events by the operating system or Qt itself.

See also Qt::MouseEventSource and QMouseEvent::source().