PathAnimation QML Type
Bewegt ein Element entlang eines Pfades. Mehr...
| Import Statement: | import QtQuick |
| Inherits: |
Eigenschaften
- anchorPoint : point
- duration : int
- easing
- easing.amplitude : real
- easing.bezierCurve : list<real>
- easing.overshoot : real
- easing.period : real
- easing.type : enumeration
- endRotation : real
- orientation : enumeration
- orientationEntryDuration : real
- orientationExitDuration : real
- path : Path
- target : Item
Ausführliche Beschreibung
Bei der Verwendung in einem Übergang kann der Pfad ohne Start- oder Endpunkt angegeben werden, zum Beispiel:
PathAnimation {
path: Path {
//no startX, startY
PathCurve { x: 100; y: 100}
PathCurve {} //last element is empty with no end point specified
}
}Im obigen Fall ist der Startpunkt des Pfades die aktuelle Position des Elements und das Ende des Pfades die Zielposition des Elements im Zielzustand.
Siehe auch „Animation und Übergänge“ unter Qt Quick und PathInterpolator.
Eigenschaftsdokumentation
anchorPoint : point
Diese Eigenschaft enthält den Ankerpunkt für das zu animierende Element.
Standardmäßig wird die obere linke Ecke des Zielobjekts (sein 0,0-Punkt) am Pfad verankert (bzw. folgt diesem). Mit der Eigenschaft „anchorPoint“ kann ein anderer Ankerpunkt festgelegt werden. Wenn Sie beispielsweise für ein 10x10-Element einen „anchorPoint“ von 5,5 festlegen, bedeutet dies, dass die Mitte des Elements dem Pfad folgt.
duration : int
Diese Eigenschaft gibt die Dauer der Animation in Millisekunden an.
Der Standardwert beträgt 250.
easing group
easing.amplitude : real
easing.bezierCurve : list<real>
easing.overshoot : real
easing.period : real
easing.type : enumeration
die für die Animation verwendete Easing-Kurve.
Um eine Beschleunigungskurve festzulegen, müssen Sie mindestens den Typ angeben. Bei einigen Kurven können Sie außerdem Amplitude, Periode, Überschwingen oder benutzerdefinierte „bezierCurve“-Daten angeben. Die Standard-Beschleunigungskurve ist „ Easing.Linear “.
Informationen zu den verschiedenen Arten von Easing-Kurven finden Sie in der Dokumentation zu „ PropertyAnimation::easing.type “.
endRotation : real
Diese Eigenschaft enthält die Endrotation für das Ziel.
Wenn für die „ PathAnimation “ eine Ausrichtung festgelegt wurde und der Pfad nicht damit endet, dass sich das Element in der gewünschten Drehung befindet, kann die Eigenschaft „endRotation“ verwendet werden, um eine Enddrehung manuell festzulegen.
Diese Eigenschaft wird in der Regel zusammen mit „ orientationExitDuration “ verwendet, da die Angabe einer „endRotation“ ohne „ orientationExitDuration “ zu einem Sprung zur Endrotation statt zu einem fließenden Übergang führen kann.
orientation : enumeration
Diese Eigenschaft steuert die Drehung des Elements, während es entlang des Pfades animiert wird.
Wenn ein anderer Wert als „ Fixed “ angegeben wird, dreht die „ PathAnimation “ das Element, um die angegebene Ausrichtung zu erreichen, während es sich entlang des Pfades bewegt.
- PathAnimation.Fixed (Standard) – „ PathAnimation “ steuert die Drehung des Elements nicht.
- PathAnimation.RightFirst – Die rechte Seite des Objekts führt entlang des Pfades.
- PathAnimation.LeftFirst – Die linke Seite des Objekts führt entlang des Pfads.
- PathAnimation.BottomFirst – Die Unterseite des Objekts führt entlang des Pfads.
- PathAnimation.TopFirst – Die Oberseite des Objekts führt entlang des Pfades.
orientationEntryDuration : real
Diese Eigenschaft gibt die Dauer (in Millisekunden) des Übergangs in die jeweilige Ausrichtung an.
Wenn für den „ PathAnimation “ eine Ausrichtung festgelegt wurde und die Ausgangsrotation des Elements nicht mit der durch die Ausrichtung vorgegebenen Rotation übereinstimmt, kann „orientationEntryDuration“ verwendet werden, um einen fließenden Übergang von der Ausgangsrotation des Elements zu der durch die Pfadausrichtung vorgegebenen Rotation zu erzielen.
orientationExitDuration : real
Diese Eigenschaft gibt die Dauer (in Millisekunden) des Übergangs aus der Ausrichtung heraus an.
Wenn für den „ PathAnimation “ eine Ausrichtung und ein „ endRotation “ angegeben wurden, kann „orientationExitDuration“ verwendet werden, um einen sanften Übergang von der durch die Pfadausrichtung vorgegebenen Drehung zur angegebenen „ endRotation “ zu erzielen.
path : Path
Diese Eigenschaft enthält den Pfad, entlang dessen die Animation ausgeführt werden soll.
Weitere Informationen zum Definieren eines Pfades finden Sie in der Dokumentation unter „ Path “.
target : Item
Diese Eigenschaft enthält das Element, das animiert werden soll.
© 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.