SpringAnimation QML Type
Ermöglicht es einer Eigenschaft, einen Wert in einer federartigen Bewegung zu verfolgen. Mehr...
| Import Statement: | import QtQuick |
| Inherits: |
Eigenschaften
Detaillierte Beschreibung
SpringAnimation ahmt das Schwingungsverhalten einer Feder nach, mit der entsprechenden spring Konstante, um die Beschleunigung zu steuern, und der damping, um zu steuern, wie schnell der Effekt abklingt.
Sie können auch das Maximum velocity der Animation begrenzen.
Die folgende Rectangle bewegt sich mit einer SpringAnimation an die Position der Maus, wenn diese angeklickt wird. Die Verwendung von Behavior für die Werte x und y zeigt an, dass immer dann, wenn diese Werte geändert werden, 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 eine SpringAnimation auf verschiedene Weise angewendet werden, z. B. durch Übergänge, Verhaltensweisen und Eigenschaftswertquellen. Die Dokumentation Animation und Übergänge in Qt Quick zeigt eine Vielzahl von Methoden zur Erstellung von Animationen.
Siehe auch SmoothedAnimation, Animation und Übergänge in Qt Quick, Qt Quick Beispiele - Animation, und Qt Quick Demo - Uhren.
Dokumentation zu Eigenschaften
damping : real
Diese Eigenschaft enthält den Wert der Federdämpfung.
Dieser Wert beschreibt, wie schnell die federartige Bewegung zur Ruhe kommt. Der Standardwert ist 0.
Der sinnvolle Wertebereich ist 0 - 1,0. Je niedriger der Wert, desto schneller kommt sie zur Ruhe.
epsilon : real
Diese Eigenschaft beinhaltet das Epsilon der Feder.
Das Epsilon ist die Rate und der Betrag der Änderung des Wertes, der nahe genug an 0 liegt, um als gleich Null betrachtet zu werden. Dies hängt von der Verwendung des Wertes ab. Für Pixelpositionen würde 0,25 ausreichen. Für die Skalierung ist 0,005 ausreichend.
Der Standardwert ist 0,01. Die Einstellung dieses Wertes kann zu kleinen Leistungsverbesserungen führen.
mass : real
Diese Eigenschaft enthält die "Masse" der zu verschiebenden Eigenschaft.
Der Wert ist standardmäßig 1,0.
Eine größere Masse bewirkt eine langsamere Bewegung und eine stärkere federähnliche Bewegung, wenn ein Objekt zur Ruhe kommt.
modulus : real
Diese Eigenschaft enthält den Moduluswert. Der Standardwert ist 0.
Die Einstellung von modulus bewirkt, dass der Zielwert um den Modulus "herumgeht". Wenn Sie beispielsweise den Modulus auf 360 setzen, wird ein Wert von 370 auf 10 umgeschlagen.
spring : real
Diese Eigenschaft beschreibt, wie stark das Ziel in Richtung der Quelle gezogen wird. Der Standardwert ist 0 (d. h. die federartige Bewegung ist deaktiviert).
Der sinnvolle Wertebereich ist 0 - 5,0.
Wenn diese Eigenschaft eingestellt ist und der Wert velocity größer als 0 ist, begrenzt velocity die Höchstgeschwindigkeit.
velocity : real
Diese Eigenschaft enthält die maximale Geschwindigkeit, die beim Verfolgen der Quelle zulässig ist.
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.