WheelEvent QML Type (Uncreatable)

Liefert Informationen zu einem Mausrad-Ereignis. Mehr...

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

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

Siehe auch „ WheelHandler “ und „ MouseArea “.

Dokumentation zu den Eigenschaften

accepted : bool

Wenn „ accepted “ auf „ true “ gesetzt wird, wird verhindert, dass das Mausrad-Ereignis an Elemente unterhalb des empfangenden Elements oder Handlers weitergeleitet wird.

Im Allgemeinen sollte das Element, das auf das Rad-Ereignis reagiert, dieses akzeptieren, damit Elemente, die in der Stapelreihenfolge darunter liegen, nicht ebenfalls auf dasselbe Ereignis reagieren.

Siehe auch „ QWheelEvent::accepted “.

angleDelta : point [read-only]

Diese Eigenschaft enthält den relativen Drehwinkel des Rads in Achtelgrad. Die Koordinaten „ x “ und „ y “ dieser Eigenschaft geben die Abweichung in horizontaler bzw. vertikaler Richtung 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 Mausmodelle arbeiten in Schritten von 15 Grad; in diesem Fall ist der Deltawert 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 zum Zeitpunkt der Auslösung des Rad-Ereignisses gedrückten Maustasten.

Sie enthält eine bitweise Kombination aus:

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

Siehe auch ` QWheelEvent::buttons()`.

inverted : bool [read-only]

Gibt zurück, ob die mit dem Ereignis übermittelten Delta-Werte invertiert sind.

Normalerweise erzeugt ein vertikales Rad eine „ WheelEvent “ mit positiven Delta-Werten, wenn sich die Oberseite des Rades von der bedienenden Hand wegdreht. Analog dazu erzeugt eine horizontale Radbewegung eine „ QWheelEvent “ mit positiven Delta-Werten, wenn die Oberseite des Rades nach links bewegt wird.

Auf einigen Plattformen ist dies jedoch konfigurierbar, sodass die oben beschriebenen Vorgänge negative Delta-Werte (jedoch mit derselben Größe) erzeugen. Beispielsweise kann in einer QML-Komponente (wie einem Drehregler oder einem Schieberegler), bei der es sinnvoll ist, die Bewegung oder Drehung eines Elements unabhängig von den Systemeinstellungen mit der Richtung des Rads zu synchronisieren, der Rad-Ereignis-Handler die Eigenschaft „inverted“ verwenden, um zu entscheiden, ob die Werte „ angleDelta “ oder „ pixelDelta “ umgekehrt werden sollen.

Siehe auch ` QWheelEvent::inverted()`.

modifiers : int [read-only]

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

Sie enthält eine bitweise Kombination aus:

• Qt.NoModifier - Es ist keine Modifikatortaste gedrückt.
• Qt.ShiftModifier - Eine Umschalttaste auf der Tastatur ist gedrückt.
• Qt.ControlModifier - Eine Strg-Taste auf der Tastatur ist gedrückt.
• Qt.AltModifier - Eine Alt-Taste auf der Tastatur ist gedrückt.
• Qt.MetaModifier - Eine Meta-Taste auf der Tastatur ist gedrückt.
• Qt.KeypadModifier - Eine Taste auf dem Ziffernblock wird gedrückt.

Beispiel: So reagieren Sie auf das Drücken der Strg-Taste während eines Mausrad-Ereignisses:

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 die Abweichung in Bildschirmpixeln und ist auf Plattformen verfügbar, die hochauflösende Bildschirme unterstützen ( trackpads), wie beispielsweise macOS. Die Koordinaten „ x “ und „ y “ dieser Eigenschaft geben die Abweichung in horizontaler bzw. vertikaler Richtung an. Die Werte können direkt zum Scrollen von Inhalten auf dem Bildschirm verwendet werden.

Auf Plattformen ohne Unterstützung für „ high-resolution trackpad “ ist „pixelDelta“ immer gleich „ (0,0) “, und stattdessen sollte „ angleDelta “ verwendet werden.

Siehe auch „ QWheelEvent::pixelDelta()“.

Diese Eigenschaften enthalten die Koordinaten der Position, die vom Rad-Ereignis übermittelt wurde.

Siehe auch QWheelEvent::position().