En esta página

PathAnimation QML Type

Anima un elemento a lo largo de una ruta. Más...

Import Statement: import QtQuick
Inherits:

Animation

Propiedades

Descripción detallada

Cuando se utiliza en una transición, la ruta se puede especificar sin puntos de inicio ni de fin, por ejemplo:

PathAnimation {
    path: Path {
        //no startX, startY
        PathCurve { x: 100; y: 100}
        PathCurve {}    //last element is empty with no end point specified
    }
}

En el caso anterior, el inicio de la trayectoria será la posición actual del elemento, y el final de la trayectoria será la posición de destino del elemento en el estado de destino.

Véase también «Animación y transiciones» en Qt Quick y PathInterpolator.

Documentación de la propiedad

anchorPoint : point

Esta propiedad contiene el punto de anclaje del elemento que se está animando.

Por defecto, la esquina superior izquierda del elemento de destino (su punto 0,0) quedará anclada a la trayectoria (o la seguirá). La propiedad `anchorPoint` se puede utilizar para especificar un punto diferente de anclaje. Por ejemplo, si se especifica un `anchorPoint` de 5,5 para un elemento de 10x10, el centro del elemento seguirá la ruta.

duration : int

Esta propiedad indica la duración de la animación, en milisegundos.

El valor por defecto es 250.

easing group

easing.amplitude : real

easing.bezierCurve : list<real>

easing.overshoot : real

easing.period : real

easing.type : enumeration

la curva de aceleración utilizada para la animación.

Para especificar una curva de aceleración, es necesario indicar al menos el tipo. En el caso de algunas curvas, también se puede especificar la amplitud, el período, el sobreimpulso o datos personalizados de «bezierCurve». La curva de aceleración predeterminada es « Easing.Linear ».

Consulta la documentación de PropertyAnimation::easing.type para obtener información sobre los diferentes tipos de curvas de aceleración.

endRotation : real

Esta propiedad contiene la rotación final del objetivo.

Si se ha especificado una orientación para la ruta de desplazamiento ( PathAnimation) y la ruta no termina con el elemento en la rotación deseada, la propiedad endRotation se puede utilizar para especificar manualmente una rotación final.

Esta propiedad se suele utilizar junto con ` orientationExitDuration`, ya que especificar una `endRotation` sin un ` orientationExitDuration ` puede provocar un salto a la rotación final, en lugar de una transición suave.

orientation : enumeration

Esta propiedad controla la rotación del elemento a medida que se anima a lo largo de la trayectoria.

Si se especifica un valor distinto de « Fixed », la propiedad « PathAnimation » girará el elemento para alcanzar la orientación especificada a medida que se desplaza a lo largo de la ruta.

  • PathAnimation.Fixed (predeterminado): el « PathAnimation » no controlará la rotación del elemento.
  • PathAnimation.RightFirst: el lado derecho del elemento irá en cabeza a lo largo de la ruta.
  • PathAnimation.LeftFirst: el lado izquierdo del elemento irá por delante a lo largo de la ruta.
  • PathAnimation.BottomFirst: la parte inferior del elemento irá por delante a lo largo de la ruta.
  • PathAnimation.TopFirst: la parte superior del elemento irá por delante a lo largo de la ruta.

orientationEntryDuration : real

Esta propiedad indica la duración (en milisegundos) de la transición hacia la orientación.

Si se ha especificado una orientación para la ruta de orientación ( PathAnimation) y la rotación inicial del elemento no coincide con la indicada por la orientación, se puede utilizar orientationEntryDuration para realizar una transición suave desde la rotación inicial del elemento hasta la rotación indicada por la orientación de la ruta.

orientationExitDuration : real

Esta propiedad indica la duración (en milisegundos) de la transición de salida de la orientación.

Si se han especificado una orientación y un « endRotation » para el « PathAnimation », se puede utilizar «orientationExitDuration» para realizar una transición suave desde la rotación dada por la orientación de la trayectoria hasta la « endRotation » especificada.

path : Path

Esta propiedad contiene la ruta a lo largo de la cual se realizará la animación.

Para obtener más información sobre cómo definir una ruta, consulta la documentación de Path.

target : Item

Esta propiedad contiene el elemento que se va a animar.

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