- Qt 5.15
- Qt Widgets
- C++ Classes
- QMouseEventTransition
- Qt 5.15.19 Reference Documentation

# QMouseEventTransition Class

The QMouseEventTransition class provides a transition for mouse events. More...

Header: | #include <QMouseEventTransition>
qmake: | QT += widgets
Since: | Qt 4.6
Inherits: | QEventTransition

This class was introduced in Qt 4.6.

- List of all members, including inherited members

## Properties

- button : Qt::MouseButton
- modifierMask : Qt::KeyboardModifiers

## Public Functions

| QMouseEventTransition(QObject *object, QEvent::Type type, Qt::MouseButton button, QState *sourceState = nullptr)
| QMouseEventTransition(QState *sourceState = nullptr)
virtual | ~QMouseEventTransition()
Qt::MouseButton | button() const
QPainterPath | hitTestPath() const
Qt::KeyboardModifiers | modifierMask() const
void | setButton(Qt::MouseButton button)
void | setHitTestPath(const QPainterPath &path)
void | setModifierMask(Qt::KeyboardModifiers modifierMask)

## Reimplemented Protected Functions

virtual bool | eventTest(QEvent *event) override
virtual void | onTransition(QEvent *event) override

## Detailed Description

QMouseEventTransition is part of The State Machine Framework.

See also QState::addTransition().

## Property Documentation

### button : Qt::MouseButton

This property holds the button that this mouse event transition is associated with

Access functions:

Qt::MouseButton | button() const
void | setButton(Qt::MouseButton button)

### modifierMask : Qt::KeyboardModifiers

This property holds the keyboard modifier mask that this mouse event transition checks for

Access functions:

Qt::KeyboardModifiers | modifierMask() const
void | setModifierMask(Qt::KeyboardModifiers modifierMask)

## Member Function Documentation

### QMouseEventTransition::QMouseEventTransition(QObject *object, QEvent::Type type, Qt::MouseButton button, QState *sourceState = nullptr)

Constructs a new mouse event transition for events of the given type for the given object, with the given button and sourceState.

### QMouseEventTransition::QMouseEventTransition(QState *sourceState = nullptr)

Constructs a new mouse event transition with the given sourceState.

### `[virtual]` QMouseEventTransition::~QMouseEventTransition()

Destroys this mouse event transition.

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

Returns the button that this mouse event transition checks for.

Note: Getter function for property button.

See also setButton().

### `[override virtual protected]` bool QMouseEventTransition::eventTest(QEvent *event)

Reimplements: QEventTransition::eventTest(QEvent *event).

### QPainterPath QMouseEventTransition::hitTestPath() const

Returns the hit test path for this mouse event transition.

See also setHitTestPath().

### Qt::KeyboardModifiers QMouseEventTransition::modifierMask() const

Returns the keyboard modifier mask that this mouse event transition checks for.

Note: Getter function for property modifierMask.

See also setModifierMask().

### `[override virtual protected]` void QMouseEventTransition::onTransition(QEvent *event)

Reimplements: QEventTransition::onTransition(QEvent *event).

### void QMouseEventTransition::setButton(Qt::MouseButton button)

Sets the button that this mouse event transition will check for.

Note: Setter function for property button.

See also button().

### void QMouseEventTransition::setHitTestPath(const QPainterPath &path)

Sets the hit test path for this mouse event transition to path. If a valid path has been set, the transition will only trigger if the mouse event position (QMouseEvent::pos()) is inside the path.

See also hitTestPath() and QPainterPath::contains().

### void QMouseEventTransition::setModifierMask(Qt::KeyboardModifiers modifierMask)

Sets the keyboard modifier mask that this mouse event transition will check for to modifierMask.

Note: Setter function for property modifierMask.

See also modifierMask().