- Qt 6.7
- Qt Quick
- QML Types
- WheelEvent
- Qt 6.7.1 Reference Documentation

# WheelEvent QML Type

Provides information about a mouse wheel event. More...

Import Statement: | import QtQuick

- List of all members, including inherited members

## Properties

- accepted : bool
- angleDelta : point
- buttons : int
- inverted : bool
- modifiers : int
- pixelDelta : point
- x : real
- y : real

## Detailed Description

The position of the mouse can be found via the x and y properties.

See also WheelHandler and MouseArea.

## Property Documentation

x : real `[read-only]`
y : real `[read-only]`

These properties hold the coordinates of the position supplied by the wheel event.

See also QWheelEvent::position().

accepted : bool

Setting accepted to `true` prevents the wheel event from being propagated to items below the receiving item or handler.

Generally, if the item acts on the wheel event, it should be accepted so that items lower in the stacking order do not also respond to the same event.

See also QWheelEvent::accepted.

angleDelta : point `[read-only]`

This property holds the relative amount that the wheel was rotated, in eighths of a degree. The `x` and `y` coordinates of this property hold the delta in horizontal and vertical orientations, respectively.

A positive value indicates that the wheel was rotated up/right; a negative value indicates that the wheel was rotated down/left.

Most mouse types work in steps of `15` degrees, in which case the delta value is a multiple of `120`; i.e., `120 units * 1/8 = 15 degrees`.

See also QWheelEvent::angleDelta().

buttons : int `[read-only]`

This property holds the mouse buttons pressed when the wheel event was generated.

It contains a bitwise combination of:

- Qt.LeftButton
- Qt.RightButton
- Qt.MiddleButton

See also QWheelEvent::buttons().

inverted : bool `[read-only]`

Returns whether the delta values delivered with the event are inverted.

Normally, a vertical wheel will produce a WheelEvent with positive delta values if the top of the wheel is rotating away from the hand operating it. Similarly, a horizontal wheel movement will produce a QWheelEvent with positive delta values if the top of the wheel is moved to the left.

However, on some platforms this is configurable, so that the same operations described above will produce negative delta values (but with the same magnitude). For instance, in a QML component (such as a tumbler or a slider) where it is appropriate to synchronize the movement or rotation of an item with the direction of the wheel, regardless of the system settings, the wheel event handler can use the inverted property to decide whether to negate the angleDelta or pixelDelta values.

Note: Many platforms provide no such information. On such platforms `inverted` always returns `false`.

See also QWheelEvent::inverted().

modifiers : int `[read-only]`

This property holds the keyboard modifier flags that existed immediately before the event occurred.

It contains a bitwise combination of:

- Qt.NoModifier - No modifier key is pressed.
- Qt.ShiftModifier - A Shift key on the keyboard is pressed.
- Qt.ControlModifier - A Ctrl key on the keyboard is pressed.
- Qt.AltModifier - An Alt key on the keyboard is pressed.
- Qt.MetaModifier - A Meta key on the keyboard is pressed.
- Qt.KeypadModifier - A keypad button is pressed.

For example, to react to a Control key pressed during the wheel event:

     WheelHandler {
         onWheel: (wheel)=> {
             if (wheel.modifiers & Qt.ControlModifier) {
                 adjustZoom(wheel.angleDelta.y / 120);
             }
         }
     }

See also QWheelEvent::modifiers().

pixelDelta : point `[read-only]`

This property holds the delta in screen pixels and is available in platforms that have high-resolution trackpads, such as macOS. The `x` and `y` coordinates of this property hold the delta in horizontal and vertical orientations, respectively. The values can be used directly to scroll content on screen.

For platforms without high-resolution trackpad support, pixelDelta will always be `(0,0)`, and angleDelta should be used instead.

See also QWheelEvent::pixelDelta().