PathAnimation QML Type
Animiert einen Gegenstand 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
Detaillierte Beschreibung
Bei der Verwendung in einem Übergang kann der Pfad beispielsweise ohne Start- und Endpunkte angegeben werden:
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 ist die Zielposition des Elements im Zielzustand.
Siehe auch Animation und Übergänge in Qt Quick und PathInterpolator.
Dokumentation der Eigenschaft
anchorPoint : point
Diese Eigenschaft enthält den Ankerpunkt für das zu animierende Objekt.
Standardmäßig wird die obere linke Ecke des Ziels (sein 0,0-Punkt) am Pfad verankert (oder folgt ihm). Die Eigenschaft anchorPoint kann verwendet werden, um einen anderen Punkt für die Verankerung anzugeben. Wenn Sie beispielsweise einen Ankerpunkt von 5,5 für ein 10x10-Objekt angeben, bedeutet dies, dass die Mitte des Objekts dem Pfad folgt.
duration : int
Diese Eigenschaft enthält die Dauer der Animation in Millisekunden.
Der Standardwert ist 250.
easing group
easing.amplitude : real
easing.bezierCurve : list<real>
easing.overshoot : real
easing.period : real
easing.type : enumeration
die Entspannungskurve, die für die Animation verwendet wird.
Um eine Entspannungskurve festzulegen, müssen Sie zumindest den Typ angeben. Für einige Kurven können Sie auch Amplitude, Periode, Überschwingen oder benutzerdefinierte BezierCurve-Daten angeben. Die Standard-Entspannungskurve ist Easing.Linear.
Informationen zu den verschiedenen Typen von Entspannungskurven finden Sie in der Dokumentation PropertyAnimation::easing.type.
endRotation : real
Diese Eigenschaft enthält die Enddrehung für das Ziel.
Wenn für PathAnimation eine Ausrichtung angegeben wurde und der Pfad nicht mit dem Element in der gewünschten Drehung endet, kann die Eigenschaft endRotation verwendet werden, um manuell eine Enddrehung anzugeben.
Diese Eigenschaft wird in der Regel mit orientationExitDuration verwendet, da die Angabe einer endRotation ohne orientationExitDuration zu einem Sprung zur endgültigen Drehung führen kann, anstatt einen sanften Übergang zu schaffen.
orientation : enumeration
Diese Eigenschaft steuert die Drehung des Elements, während es sich entlang des Pfades bewegt.
Wenn ein anderer Wert als Fixed angegeben wird, dreht 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 Objekts nicht.
- PathAnimation.RightFirst - Die rechte Seite des Objekts wird entlang des Pfades geführt.
- PathAnimation.LeftFirst - Die linke Seite des Objekts wird entlang des Pfades geführt.
- PathAnimation.BottomFirst - Der untere Teil des Objekts wird entlang des Pfads geführt.
- PathAnimation.TopFirst - Der obere Teil des Objekts führt entlang des Pfades.
orientationEntryDuration : real
Diese Eigenschaft enthält die Dauer (in Millisekunden) des Übergangs in die Ausrichtung.
Wenn für PathAnimation eine Ausrichtung angegeben wurde und die Anfangsdrehung des Elements nicht mit der durch die Ausrichtung gegebenen übereinstimmt, kann orientationEntryDuration verwendet werden, um einen sanften Übergang von der Anfangsdrehung des Elements zu der durch die Pfadausrichtung gegebenen Drehung zu erreichen.
orientationExitDuration : real
Diese Eigenschaft enthält die Dauer (in Millisekunden) des Übergangs aus der Orientierung heraus.
Wenn für PathAnimation eine Orientierung und endRotation angegeben wurden, kann orientationExitDuration verwendet werden, um einen fließenden Übergang von der durch die Pfadorientierung gegebenen Drehung zu der angegebenen endRotation zu erreichen.
path : Path
Diese Eigenschaft enthält den Pfad, an dem entlang animiert werden soll.
Weitere Informationen zur Definition eines Pfades finden Sie in der Dokumentation Path.
target : Item
Diese Eigenschaft enthält das zu belebende Element.
© 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.