Back to Qt.io
Contact Us Blog Download Qt

PathAnimation QML Type

Animiert einen Gegenstand entlang eines Pfades. Mehr...

Import Statement: import QtQuick
Inherits:

Animation

Eigenschaften

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.

Eigenschaft Dokumentation

anchorPoint : point

Diese Eigenschaft enthält den Ankerpunkt für das zu animierende Element.

Standardmäßig wird die obere linke Ecke des Ziels (sein 0,0-Punkt) mit dem 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 anzugeben, 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-Elastizitätskurve 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 Endrotation für das Ziel.

Wenn eine Ausrichtung für PathAnimation 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 in Verbindung mit orientationExitDuration verwendet, da die Angabe einer endRotation ohne orientationExitDuration zu einem Sprung zur endgültigen Drehung führen kann, statt zu einem sanften Übergang.


orientation : enumeration

Diese Eigenschaft steuert die Drehung des Objekts während der Animation entlang des Pfads.

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 Elements führt entlang des Pfads.

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 Ausrichtung und endRotation angegeben wurden, kann orientationExitDuration verwendet werden, um einen fließenden Übergang von der durch die Pfadausrichtung gegebenen Drehung zu der angegebenen endRotation zu erreichen.


path : Path

Diese Eigenschaft enthält den Pfad, entlang dessen animiert werden soll.

Weitere Informationen zur Definition eines Pfades finden Sie in der Dokumentation Path.


target : Item

Diese Eigenschaft enthält das Element, das animiert werden soll.


© 2025 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.