PathAnimation QML Type
Anima un elemento a lo largo de un recorrido. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
- 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
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.