WheelEvent QML Type

Liefert Informationen über ein Mausrad-Ereignis. Mehr...

Import Statement: import QtQuick

Eigenschaften

Detaillierte Beschreibung

Die Position der Maus kann über die Eigenschaften x und y ermittelt werden.

Siehe auch WheelHandler und MouseArea.

Eigenschaft Dokumentation

x : real [read-only]

y : real [read-only]

Diese Eigenschaften enthalten die Koordinaten der Position, die durch das Rad-Ereignis geliefert werden.

Siehe auch QWheelEvent::position().


accepted : bool

Die Einstellung von accepted auf true verhindert, dass das Rad-Ereignis an Elemente unterhalb des empfangenden Elements oder Handlers weitergegeben wird.

Wenn das Element auf das Rad-Ereignis reagiert, sollte es im Allgemeinen akzeptiert werden, damit Elemente, die in der Stapelreihenfolge weiter unten stehen, nicht auch auf das gleiche Ereignis reagieren.

Siehe auch QWheelEvent::accepted.


angleDelta : point [read-only]

Diese Eigenschaft enthält den relativen Betrag, um den das Rad gedreht wurde, in Achtelgraden. Die Koordinaten x und y dieser Eigenschaft geben das Delta in horizontaler bzw. vertikaler Ausrichtung an.

Ein positiver Wert bedeutet, dass das Rad nach oben/rechts gedreht wurde; ein negativer Wert bedeutet, dass das Rad nach unten/links gedreht wurde.

Die meisten Maustypen arbeiten in Schritten von 15 Grad, in diesem Fall ist der Delta-Wert ein Vielfaches von 120; d.h. 120 units * 1/8 = 15 degrees.

Siehe auch QWheelEvent::angleDelta().


buttons : int [read-only]

Diese Eigenschaft enthält die Maustasten, die gedrückt wurden, als das Rad-Ereignis erzeugt wurde.

Sie enthält eine bitweise Kombination von:

Siehe auch QWheelEvent::buttons().


inverted : bool [read-only]

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

Normalerweise erzeugt ein vertikales Rad eine WheelEvent mit positiven Delta-Werten, wenn sich der obere Teil des Rades 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 die gleichen, oben beschriebenen Operationen negative Delta-Werte erzeugen (aber mit der gleichen Größenordnung). In einer QML-Komponente (z. B. einer Drehscheibe oder einem Schieberegler), in der die Bewegung oder Drehung eines Elements unabhängig von den Systemeinstellungen mit der Richtung des Rads synchronisiert werden soll, kann der Event-Handler des Rads die Eigenschaft inverted verwenden, um zu entscheiden, ob die Werte angleDelta oder pixelDelta negiert werden sollen.

Hinweis: Viele Plattformen bieten keine solchen Informationen. Auf solchen Plattformen gibt inverted immer false zurück.

Siehe auch QWheelEvent::inverted().


modifiers : int [read-only]

Diese Eigenschaft enthält die Tastaturmodifizierungsflags, die unmittelbar vor dem Auftreten des Ereignisses vorhanden waren.

Sie enthält eine bitweise Kombination aus:

Zum Beispiel, um auf eine gedrückte Strg-Taste während des Rad-Ereignisses zu reagieren:

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

Siehe auch QWheelEvent::modifiers().


pixelDelta : point [read-only]

Diese Eigenschaft enthält das Delta in Bildschirmpixeln und ist auf Plattformen verfügbar, die über eine hohe Auflösung trackpads verfügen, wie z. B. macOS. Die Koordinaten x und y dieser Eigenschaft geben das Delta in horizontaler bzw. vertikaler Ausrichtung an. Die Werte können direkt zum Scrollen von Inhalten auf dem Bildschirm verwendet werden.

Für Plattformen ohne high-resolution trackpad -Unterstützung wird pixelDelta immer (0,0) sein, und angleDelta sollte stattdessen verwendet werden.

Siehe auch QWheelEvent::pixelDelta().


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.