QWheelEvent Class

Member Function Documentation

QWheelEvent::QWheelEvent(const QPointF & pos, const QPointF & globalPos, QPoint pixelDelta, QPoint angleDelta, int qt4Delta, Qt::Orientation qt4Orientation, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers)

Constructs a wheel event object.

The pos provides the location of the mouse cursor within the window. The position in global coordinates is specified by globalPos. \pixelDelta contains the scrolling distance in pixels on screen, angleDelta contains the wheel rotation distance. \pixelDelta is optional and can be null.

modifiers holds the keyboard modifier flags at the time of the event.

pixelDelta contains the scrolling delta in pixels, angleDelta contains the rotation distance, and orient holds the wheel's orientation.

See also pos(), globalPos(), delta(), and state().

QPoint QWheelEvent::angleDelta() const

Returns the distance that the wheel is rotated, in eighths of a degree. A positive value indicates that the wheel was rotated forwards away from the user; a negative value indicates that the wheel was rotated backwards toward the user.

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.

However, some mice have finer-resolution wheels and send delta values that are less than 120 units (less than 15 degrees). To support this possibility, you can either cumulatively add the delta values from events until the value of 120 is reached, then scroll the widget, or you can partially scroll the widget in response to each wheel event.

Example:

 void MyWidget::wheelEvent(QWheelEvent *event)
 {
     QPoint numPixels = envent->pixelDelta();
     QPoint numDegrees = envent->angleDelta() / 8;

     if (!numPixels.isNull()) {
         scrollWithPixels(numpixels);
     } else if (!numDegrees.isNull()) {
         QPoint numSteps = numDegrees / 15;
         scrollWithDegrees(numSteps);
     }

     event->accept();
 }

Qt::MouseButtons QWheelEvent::buttons() const

Returns the mouse state when the event occurred.

int QWheelEvent::delta() const

This function has been deprecated, use pixelDelta() or angleDelta() instead.

QPoint QWheelEvent::globalPos() const

Returns the global position of the mouse pointer at the time of the event. This is important on asynchronous window systems such as X11; whenever you move your widgets around in response to mouse events, globalPos() can differ a lot from the current cursor position returned by QCursor::pos().

See also globalX() and globalY().

const QPointF & QWheelEvent::globalPosF() const

int QWheelEvent::globalX() const

Returns the global x position of the mouse cursor at the time of the event.

See also globalY() and globalPos().

int QWheelEvent::globalY() const

Returns the global y position of the mouse cursor at the time of the event.

See also globalX() and globalPos().

Qt::Orientation QWheelEvent::orientation() const

Returns the wheel's orientation.

QPoint QWheelEvent::pixelDelta() const

Returns the scrolling distance in pixels on screen. This value is provided on platforms that support high-resolution pixel-based delta values, such as Mac OS X. The value should be used directly to scroll content on screen.

Example:

 void MyWidget::wheelEvent(QWheelEvent *event)
 {
     QPoint numPixels = envent->pixelDelta();
     QPoint numDegrees = envent->angleDelta() / 8;

     if (!numPixels.isNull()) {
         scrollWithPixels(numpixels);
     } else if (!numDegrees.isNull()) {
         QPoint numSteps = numDegrees / 15;
         scrollWithDegrees(numSteps);
     }

     event->accept();
 }

QPoint QWheelEvent::pos() const

Returns the position of the mouse cursor relative to the widget that received the event.

If you move your widgets around in response to mouse events, use globalPos() instead of this function.

See also x(), y(), and globalPos().

const QPointF & QWheelEvent::posF() const

int QWheelEvent::x() const

Returns the x position of the mouse cursor, relative to the widget that received the event.

See also y() and pos().

int QWheelEvent::y() const

Returns the y position of the mouse cursor, relative to the widget that received the event.

See also x() and pos().