En esta página

PathAnimation QML Type

Anima un elemento a lo largo de un recorrido. Más...

Import Statement: import QtQuick
Inherits:

Animation

Propiedades

Descripción detallada

Cuando se utiliza en una transición, la trayectoria puede especificarse sin puntos de inicio o final, 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 ruta será la posición actual del elemento, y el final de la ruta 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 propiedades

anchorPoint : point

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

Por defecto, la esquina superior izquierda del objetivo (su punto 0,0) se anclará a (o seguirá) la ruta. La propiedad anchorPoint puede utilizarse para especificar un punto de anclaje diferente. Por ejemplo, especificar un anchorPoint de 5,5 para un elemento de 10x10 significa que el centro del elemento seguirá la trayectoria.

duration : int

Esta propiedad contiene 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 servidumbre utilizada para la animación.

Para especificar una curva de flexión es necesario especificar al menos el tipo. Para algunas curvas también se puede especificar la amplitud, el periodo, el rebasamiento o datos personalizados de la curva bezierCurve. La curva de flexión por defecto es Easing.Linear.

Consulte la documentación de PropertyAnimation::easing.type para obtener información sobre los distintos tipos de curvas de flexión.

endRotation : real

Esta propiedad contiene la rotación final del objetivo.

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

Esta propiedad se utiliza normalmente con orientationExitDuration, ya que especificar una endRotation sin 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, PathAnimation rotará el elemento para conseguir la orientación especificada mientras se desplaza por el recorrido.

  • PathAnimation.Fixed (predeterminado) - PathAnimation no controlará la rotación del elemento.
  • PathAnimation.RightFirst - El lado derecho del elemento guiará a lo largo de la ruta.
  • PathAnimation.LeftFirst - El lado izquierdo del ítem se moverá a lo largo del camino.
  • PathAnimation.BottomFirst - La parte inferior del ítem seguirá la trayectoria.
  • PathAnimation.ArribaPrimero - La parte superior del elemento será la que siga el camino.

orientationEntryDuration : real

Esta propiedad contiene la duración (en milisegundos) de la transición a la orientación.

Si se ha especificado una orientación para PathAnimation, y la rotación inicial del elemento no coincide con la dada por la orientación, orientationEntryDuration puede utilizarse para realizar una transición suave desde la rotación inicial del elemento a la rotación dada por la orientación de la ruta.

orientationExitDuration : real

Esta propiedad contiene la duración (en milisegundos) de la transición fuera de la orientación.

Si se han especificado una orientación y endRotation para PathAnimation, orientationExitDuration puede utilizarse para realizar una transición suave desde la rotación dada por la orientación de la trayectoria a la especificada endRotation.

path : Path

Esta propiedad contiene la trayectoria a lo largo de la cual se animará.

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

target : Item

Esta propiedad contiene el elemento 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.