Auf dieser Seite

PathAnimation QML Type

Bewegt ein Element entlang eines Pfades. Mehr...

Import Statement: import QtQuick
Inherits:

Animation

Eigenschaften

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.