QWheelEvent Class

Dokumentation der Mitgliedsfunktionen

QWheelEvent::QWheelEvent(const QPointF &pos, const QPointF &globalPos, QPoint pixelDelta, QPoint angleDelta, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::ScrollPhase phase, bool inverted, Qt::MouseEventSource source = Qt::MouseEventNotSynthesized, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())

Konstruiert ein Rad-Ereignis-Objekt.

Die pos gibt die Position des Mauszeigers im Fenster an. Die Position in globalen Koordinaten wird durch globalPos angegeben.

pixelDelta angleDelta enthält den Drehwinkel des Rades. pixelDelta ist optional und kann Null sein.

Die Maus- und Tastaturzustände zum Zeitpunkt des Ereignisses werden durch buttons und modifiers angegeben.

Die Bildlaufphase des Ereignisses wird durch phase angegeben, und source gibt an, ob es sich um ein echtes oder ein künstliches (synthetisiertes) Ereignis handelt.

Wenn das System so konfiguriert ist, dass die mit dem Ereignis gelieferten Delta-Werte invertiert werden (z. B. natürliches Scrollen des Touchpads unter macOS), sollte inverted für true stehen. Andernfalls ist inverted false

Das Gerät, von dem das Rad-Ereignis ausgeht, wird durch device angegeben.

Siehe auch position(), globalPosition(), angleDelta(), pixelDelta(), phase(), inverted(), und device().

QPoint QWheelEvent::angleDelta() const

Gibt den relativen Betrag, um den das Rad gedreht wurde, in Achtelgraden zurück. Ein positiver Wert bedeutet, dass das Rad vom Benutzer weg nach vorne gedreht wurde; ein negativer Wert bedeutet, dass das Rad zum Benutzer hin gedreht wurde. angleDelta().y() gibt den Winkel an, um den das gemeinsame vertikale Mausrad seit dem vorherigen Ereignis gedreht wurde. angleDelta().x() gibt den Winkel an, um den das horizontale Mausrad gedreht wurde, wenn die Maus über ein horizontales Rad verfügt; andernfalls bleibt er bei Null. Einige Mäuse erlauben es dem Benutzer, das Rad zu neigen, um einen horizontalen Bildlauf durchzuführen, und einige Touchpads unterstützen eine horizontale Bildlaufgeste; dies wird ebenfalls in angleDelta().x() angezeigt.

Die meisten Mäuse arbeiten in 15-Grad-Schritten, wobei der Deltawert ein Vielfaches von 120 ist, d. h. 120 Einheiten * 1/8 = 15 Grad.

Einige Mäuse haben jedoch feiner auflösende Räder und senden Deltawerte, die kleiner als 120 Einheiten (weniger als 15 Grad) sind. Um diese Möglichkeit zu unterstützen, können Sie entweder die Delta-Werte von Ereignissen kumulativ addieren, bis der Wert 120 erreicht ist, und dann das Widget scrollen, oder Sie können das Widget als Reaktion auf jedes Rad-Ereignis teilweise scrollen. Um jedoch ein nativeres Gefühl zu vermitteln, sollten Sie pixelDelta() auf Plattformen bevorzugen, auf denen es verfügbar ist.

Beispiel:

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

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

    event->accept();
}

• der Bildlauf gerade beginnt, aber die Entfernung sich noch nicht geändert hat (Qt::ScrollBegin),
• oder der Bildlauf beendet ist und sich der Abstand nicht mehr geändert hat (Qt::ScrollEnd).

Siehe auch pixelDelta().

bool QWheelEvent::inverted() const

Gibt zurück, ob die mit dem Ereignis gelieferten Deltawerte invertiert sind.

Normalerweise erzeugt ein vertikales Rad ein QWheelEvent mit positiven Deltawerten, wenn sich der obere Teil des Rads von der Hand, die es bedient, wegdreht. Analog dazu erzeugt eine horizontale Radbewegung eine QWheelEvent mit positiven Delta-Werten, wenn der obere Teil des Rads nach links bewegt wird.

Auf einigen Plattformen ist dies jedoch konfigurierbar, so dass dieselben oben beschriebenen Operationen negative Delta-Werte erzeugen (aber mit derselben Größenordnung). Mit der Eigenschaft "invertiert" kann ein Rad-Ereignisverbraucher festlegen, dass er unabhängig von den Systemeinstellungen immer der Richtung des Rades folgt, allerdings nur für bestimmte Widgets. (Ein solcher Anwendungsfall könnte sein, dass der Benutzer das Rad in die gleiche Richtung dreht, wie ein visueller Tumbler sich dreht. Ein anderer Anwendungsfall ist, dass ein Schieberegler unabhängig von der Systemkonfiguration der Bewegungsrichtung der Finger auf einem Touchpad folgen soll).

[override virtual] bool QWheelEvent::isBeginEvent() const

Reimplements: QSinglePointEvent::isBeginEvent() const.

Gibt true zurück, wenn die phase() dieses Ereignisses Qt::ScrollBegin ist.

[override virtual] bool QWheelEvent::isEndEvent() const

Reimplements: QSinglePointEvent::isEndEvent() const.

Gibt true zurück, wenn die phase() dieses Ereignisses Qt::ScrollEnd ist.

[override virtual] bool QWheelEvent::isUpdateEvent() const

Reimplements: QSinglePointEvent::isUpdateEvent() const.

Gibt true zurück, wenn die phase() dieses Ereignisses Qt::ScrollUpdate oder Qt::ScrollMomentum ist.

Qt::ScrollPhase QWheelEvent::phase() const

Gibt die Bildlaufphase dieses Rad-Ereignisses zurück.

QPoint QWheelEvent::pixelDelta() const

Gibt den Bildlaufabstand in Pixeln auf dem Bildschirm zurück. Dieser Wert wird auf Plattformen bereitgestellt, die hochauflösende pixelbasierte Delta-Werte unterstützen, wie z. B. macOS. Der Wert sollte direkt zum Scrollen von Inhalten auf dem Bildschirm verwendet werden.

Beispiel:

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

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

    event->accept();
}

• der Bildlauf gerade beginnt, aber der Abstand sich noch nicht geändert hat (Qt::ScrollBegin),
• oder der Bildlauf beendet ist und sich der Abstand nicht mehr geändert hat (Qt::ScrollEnd).