QWheelEvent ¶

概要 ¶

详细描述 ¶

Wheel events are sent to the widget under the mouse cursor, but if that widget does not handle the event they are sent to the focus widget. Wheel events are generated for both mouse wheels and trackpad scroll gestures. There are two ways to read the wheel event delta: angleDelta() returns the deltas in wheel degrees. These values are always provided. pixelDelta() returns the deltas in screen pixels, and is available on platforms that have high-resolution trackpads, such as macOS. If that is the case, source() will return MouseEventSynthesizedBySystem .

函数 pos() and globalPos() return the mouse cursor’s location at the time of the event.

A wheel event contains a special accept flag that indicates whether the receiver wants the event. You should call ignore() if you do not handle the wheel event; this ensures that it will be sent to the parent widget.

setEnabled() function can be used to enable or disable mouse and keyboard events for a widget.

事件处理程序 wheelEvent() receives wheel events.

另请参阅

QMouseEvent grabMouse()

class QWheelEvent ( pos , globalPos , pixelDelta , angleDelta , buttons , modifiers , phase , inverted [ , source=Qt.MouseEventNotSynthesized ] ) ¶

QWheelEvent(pos, globalPos, pixelDelta, angleDelta, qt4Delta, qt4Orientation, buttons, modifiers)

注意

This constructor is deprecated.

QWheelEvent(pos, globalPos, pixelDelta, angleDelta, qt4Delta, qt4Orientation, buttons, modifiers, phase)

注意

This constructor is deprecated.

QWheelEvent(pos, globalPos, pixelDelta, angleDelta, qt4Delta, qt4Orientation, buttons, modifiers, phase, source)

注意

This constructor is deprecated.

QWheelEvent(pos, globalPos, pixelDelta, angleDelta, qt4Delta, qt4Orientation, buttons, modifiers, phase, source, inverted)

注意

This constructor is deprecated.

QWheelEvent(pos, globalPos, delta, buttons, modifiers[, orient=Qt.Vertical])

注意

This constructor is deprecated.

QWheelEvent(pos, delta, buttons, modifiers[, orient=Qt.Vertical])

注意

This constructor is deprecated.

param source

MouseEventSource

param globalPos

QPointF

param inverted

bool

param modifiers

KeyboardModifiers

param angleDelta

QPoint

param buttons

MouseButtons

param pos

QPointF

param pixelDelta

QPoint

param phase

ScrollPhase

param delta

int

param orient

取向

param qt4Delta

int

param qt4Orientation

取向

Constructs a wheel event object.

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, while angleDelta contains the wheel rotation angle. pixelDelta is optional and can be null.

The mouse and keyboard states at the time of the event are specified by buttons and modifiers .

The scrolling phase of the event is specified by phase .

If the wheel event comes from a physical mouse wheel, source is set to MouseEventNotSynthesized . If it comes from a gesture detected by the operating system, or from a non-mouse hardware device, such that pixelDelta is directly related to finger movement, source is set to MouseEventSynthesizedBySystem . If it comes from Qt, source would be set to MouseEventSynthesizedByQt .

If the system is configured to invert the delta values delivered with the event (such as natural scrolling of the touchpad on macOS), inverted 应该为 true 。否则， inverted is false

另请参阅

position() globalPosition() angleDelta() pixelDelta() phase() inverted() source()

This constructor has been deprecated.

This constructor has been deprecated.

This constructor has been deprecated.

This constructor has been deprecated.

This constructor has been deprecated.

PySide2.QtGui.QWheelEvent. pixelD ¶

PySide2.QtGui.QWheelEvent. angleD ¶

PySide2.QtGui.QWheelEvent. qt4D ¶

PySide2.QtGui.QWheelEvent. qt4O ¶

PySide2.QtGui.QWheelEvent. _unused_ ¶

PySide2.QtGui.QWheelEvent. src ¶

PySide2.QtGui.QWheelEvent. invertedScrolling ¶

PySide2.QtGui.QWheelEvent. ph ¶

PySide2.QtGui.QWheelEvent. reserved ¶

PySide2.QtGui.QWheelEvent. angleDelta ( ) ¶

返回类型

QPoint

Returns the relative amount that the wheel was 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. angleDelta().y() provides the angle through which the common vertical mouse wheel was rotated since the previous event. angleDelta().x() provides the angle through which the horizontal mouse wheel was rotated, if the mouse has a horizontal wheel; otherwise it stays at zero. Some mice allow the user to tilt the wheel to perform horizontal scrolling, and some touchpads support a horizontal scrolling gesture; that will also appear in angleDelta().x() .

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. But to provide a more native feel, you should prefer pixelDelta() on platforms where it’s available.

范例：

def wheelEvent(self, event):
    numDegrees = event.delta() / 8
    numSteps = numDegrees / 15
    if event->orientation() == Qt.Horizontal:
        scrollHorizontally(numSteps)
    else:
        scrollVertically(numSteps)
    event.accept()
											

注意

On platforms that support scrolling phases , the delta may be null when:

• scrolling is about to begin, but the distance did not yet change ( ScrollBegin ),

• or scrolling has ended and the distance did not change anymore ( ScrollEnd ).

另请参阅

pixelDelta()

PySide2.QtGui.QWheelEvent. buttons ( ) ¶

返回类型

MouseButtons

Returns the mouse state when the event occurred.

PySide2.QtGui.QWheelEvent. delta ( ) ¶

返回类型

int

注意

此函数被弃用。

This function has been deprecated, use pixelDelta() or angleDelta() 代替。

PySide2.QtGui.QWheelEvent. globalPos ( ) ¶

返回类型

QPoint

注意

此函数被弃用。

This function has been deprecated, use globalPosition() 代替。

PySide2.QtGui.QWheelEvent. globalPosF ( ) ¶

返回类型

QPointF

注意

此函数被弃用。

This function has been deprecated, use globalPosition() 代替。

PySide2.QtGui.QWheelEvent. globalPosition ( ) ¶

返回类型

QPointF

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, can differ a lot from the current cursor position returned by pos() .

另请参阅

position()

PySide2.QtGui.QWheelEvent. globalX ( ) ¶

返回类型

int

注意

此函数被弃用。

This function has been deprecated, use globalPosition() 代替。

PySide2.QtGui.QWheelEvent. globalY ( ) ¶

返回类型

int

注意

此函数被弃用。

This function has been deprecated, use globalPosition() 代替。

PySide2.QtGui.QWheelEvent. inverted ( ) ¶

返回类型

bool

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

Normally, a vertical wheel will produce a QWheelEvent 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). With the inverted property a wheel event consumer can choose to always follow the direction of the wheel, regardless of the system settings, but only for specific widgets. (One such use case could be that the user is rotating the wheel in the same direction as a visual Tumbler rotates. Another usecase is to make a slider handle follow the direction of movement of fingers on a touchpad regardless of system configuration.)

注意

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

PySide2.QtGui.QWheelEvent. orientation ( ) ¶

返回类型

取向

注意

此函数被弃用。

使用 angleDelta() 代替。

PySide2.QtGui.QWheelEvent. phase ( ) ¶

返回类型

ScrollPhase

Returns the scrolling phase of this wheel event.

注意

ScrollBegin and ScrollEnd phases are currently supported only on macOS.

PySide2.QtGui.QWheelEvent. pixelDelta ( ) ¶

返回类型

QPoint

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

范例：

def wheelEvent(self, event):
    numDegrees = event.delta() / 8
    numSteps = numDegrees / 15
    if event->orientation() == Qt.Horizontal:
        scrollHorizontally(numSteps)
    else:
        scrollVertically(numSteps)
    event.accept()
											

注意

On platforms that support scrolling phases , the delta may be null when:

• scrolling is about to begin, but the distance did not yet change ( ScrollBegin ),

• or scrolling has ended and the distance did not change anymore ( ScrollEnd ).

注意

On X11 this value is driver specific and unreliable, use angleDelta() instead

PySide2.QtGui.QWheelEvent. pos ( ) ¶

返回类型

QPoint

注意

此函数被弃用。

This function has been deprecated, use position() 代替。

PySide2.QtGui.QWheelEvent. posF ( ) ¶

返回类型

QPointF

注意

此函数被弃用。

This function has been deprecated, use position() 代替。

PySide2.QtGui.QWheelEvent. position ( ) ¶

返回类型

QPointF

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 globalPosition() instead of this function.

另请参阅

globalPosition()

PySide2.QtGui.QWheelEvent. source ( ) ¶

返回类型

MouseEventSource

Returns information about the wheel event source.

The source can be used to distinguish between events that come from a mouse with a physical wheel and events that are generated by some other means, such as a flick gesture on a touchpad.

注意

Many platforms provide no such information. On such platforms MouseEventNotSynthesized is returned always.

另请参阅

MouseEventSource

PySide2.QtGui.QWheelEvent. x ( ) ¶

返回类型

int

注意

此函数被弃用。

This function has been deprecated, use position() 代替。

PySide2.QtGui.QWheelEvent. y ( ) ¶

返回类型

int

注意

此函数被弃用。

This function has been deprecated, use position() 代替。