SpringAnimation QML Type
Ermöglicht es einer Eigenschaft, einen Wert in einer federartigen Bewegung nachzuverfolgen. Mehr...
| Import Statement: | import QtQuick |
| Inherits: |
Eigenschaften
Ausführliche Beschreibung
SpringAnimation ahmt das Schwingungsverhalten einer Feder nach, wobei die entsprechende Konstante „ spring “ die Beschleunigung und „ damping “ die Abklinggeschwindigkeit des Effekts steuert.
Sie können außerdem den maximalen „ velocity “-Wert der Animation begrenzen.
Die folgende „ Rectangle “ bewegt sich bei einem Mausklick mithilfe einer „SpringAnimation“ an die Position der Maus. Die Verwendung der „ Behavior “ für die Werte „ x “ und „ y “ bedeutet, dass bei jeder Änderung dieser Werte eine „SpringAnimation“ angewendet werden soll.
import QtQuick
Item {
width: 300; height: 300
Rectangle {
id: rect
width: 50; height: 50
color: "red"
Behavior on x { SpringAnimation { spring: 2; damping: 0.2 } }
Behavior on y { SpringAnimation { spring: 2; damping: 0.2 } }
}
MouseArea {
anchors.fill: parent
onClicked: (mouse)=> {
rect.x = mouse.x - rect.width/2
rect.y = mouse.y - rect.height/2
}
}
}Wie jeder andere Animationstyp kann auch eine „SpringAnimation“ auf verschiedene Weise angewendet werden, unter anderem in Übergängen, Verhaltensweisen und Eigenschaftswertquellen. Die Dokumentation „Animation and Transitions“ unter Qt Quick zeigt eine Vielzahl von Methoden zum Erstellen von Animationen.
Siehe auch „ SmoothedAnimation“ , „Animation and Transitions“ unter Qt Quick, „Qt Quick Examples – Animation“ sowie „Qt Quick Demo – Clocks“.
Dokumentation zu den Eigenschaften
damping : real
Diese Eigenschaft enthält den Wert für die Federdämpfung.
Dieser Wert beschreibt, wie schnell die federartige Bewegung zum Stillstand kommt. Der Standardwert ist 0.
Der sinnvolle Wertebereich liegt zwischen 0 und 1,0. Je niedriger der Wert, desto schneller kommt die Bewegung zum Stillstand.
epsilon : real
Diese Eigenschaft enthält den Federkoeffizienten Epsilon.
Epsilon bezeichnet die Änderungsrate und den Änderungsbetrag eines Werts, der so nahe an 0 liegt, dass er als gleich Null angesehen werden kann. Dies hängt von der Verwendung des Werts ab. Für Pixelpositionen würde 0,25 ausreichen. Für die Skalierung würde 0,005 ausreichen.
Der Standardwert beträgt 0,01. Durch die Anpassung dieses Werts lassen sich geringfügige Leistungssteigerungen erzielen.
mass : real
Diese Eigenschaft enthält die „Masse“ der zu verschiebenden Eigenschaft.
Der Standardwert beträgt 1,0.
Eine größere Masse führt zu einer langsameren Bewegung und einer stärkeren federartigen Bewegung, wenn ein Objekt zum Stillstand kommt.
modulus : real
Diese Eigenschaft enthält den Moduluswert. Der Standardwert ist 0.
Durch die Festlegung eines Modulus ( modulus ) wird der Zielwert gezwungen, am Modulus „umzulaufen“. Wenn der Modulus beispielsweise auf 360 gesetzt wird, führt ein Wert von 370 dazu, dass der Wert auf 10 zurückgesetzt wird.
spring : real
Diese Eigenschaft beschreibt, wie stark das Ziel zur Quelle hin gezogen wird. Der Standardwert ist 0 (das heißt, die federartige Bewegung ist deaktiviert).
Der nutzbare Wertebereich liegt zwischen 0 und 5,0.
Wenn diese Eigenschaft festgelegt ist und der Wert für „ velocity “ größer als 0 ist, begrenzt „ velocity “ die maximale Geschwindigkeit.
velocity : real
Diese Eigenschaft gibt die maximal zulässige Geschwindigkeit bei der Verfolgung der Quelle an.
Der Standardwert ist 0 (keine maximale Geschwindigkeit).
© 2026 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.