PropertyAnimation QML Type
Muestra de forma animada los cambios en los valores de las propiedades. Más...
| Import Statement: | import QtQuick |
| Inherits: | |
| Inherited By: | ColorAnimation, NumberAnimation, QuaternionAnimation, RotationAnimation, SmoothedAnimation, SpringAnimation, and Vector3dAnimation |
Propiedades
- duration : int
- easing
- easing.amplitude : real
- easing.bezierCurve : list<real>
- easing.overshoot : real
- easing.period : real
- easing.type : enumeration
- exclude : list<QtObject>
- from : variant
- properties : string
- property : string
- target : QtObject
- targets : list<QtObject>
- to : variant
Descripción detallada
PropertyAnimation ofrece una forma de animar los cambios en el valor de una propiedad.
Se puede utilizar para definir animaciones de diversas formas:
- En un Transition
Por ejemplo, para animar cualquier objeto que haya cambiado sus propiedades «
x» o «y» como resultado de un cambio de estado, utilizando una curva de aceleración «InOutQuad»:Rectangle { id: rect width: 100; height: 100 color: "red" states: State { name: "moved" PropertyChanges { target: rect; x: 50 } } transitions: Transition { PropertyAnimation { properties: "x,y"; easing.type: Easing.InOutQuad } } } - En un Behavior
Por ejemplo, para animar todos los cambios en la propiedad «
x» de un rectángulo:Rectangle { width: 100; height: 100 color: "red" Behavior on x { PropertyAnimation {} } MouseArea { anchors.fill: parent; onClicked: parent.x = 50 } } - Como fuente de valor de propiedad
Por ejemplo, para animar repetidamente la propiedad «
x» del rectángulo:Rectangle { width: 100; height: 100 color: "red" SequentialAnimation on x { loops: Animation.Infinite PropertyAnimation { to: 50 } PropertyAnimation { to: 0 } } } - En un controlador de señal
Por ejemplo, para hacer que «
theObject» se desvanezca al hacer clic:MouseArea { anchors.fill: theObject onClicked: PropertyAnimation { target: theObject; property: "opacity"; to: 0 } } - De forma independiente
Por ejemplo, para animar la propiedad `
width` de `rect` durante 500 ms, desde su ancho actual hasta 30:Rectangle { id: theRect width: 100; height: 100 color: "red" // this is a standalone animation, it's not running by default PropertyAnimation { id: animation; target: theRect; property: "width"; to: 30; duration: 500 } MouseArea { anchors.fill: parent; onClicked: animation.running = true } }
Dependiendo de cómo se utilice la animación, el conjunto de propiedades que se emplean habitualmente variará. Para obtener más información, consulta la documentación de cada propiedad, así como la introducción a «Animación y transiciones en Qt Quick ».
Tenga en cuenta que PropertyAnimation hereda del tipo abstracto Animation. Esto incluye propiedades y métodos adicionales para controlar la animación.
Modificación de animaciones en ejecución
Desde Qt 6.4, es posible establecer las propiedades ` from`, ` to`, ` duration` y ` easing ` en una animación de nivel superior mientras se está ejecutando. La animación tendrá en cuenta los cambios en el siguiente bucle.
Véase también «Animación y transiciones en Qt Quick » y «Ejemplos deQt Quick - Animación».
Documentación de las propiedades
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
Especifica 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 y/o el sobreimpulso (se ofrecen más detalles tras la tabla). La curva de aceleración predeterminada es Easing.Linear.
PropertyAnimation { properties: "y";
easing.type: Easing.InOutElastic;
easing.amplitude: 2.0;
easing.period: 1.5 }Los tipos disponibles son:
Easing.Linear | Curva de aceleración para una función lineal (t): la velocidad es constante. | ![]() |
Easing.InQuad | Curva de aceleración para una función cuadrática (t²): acelera partiendo de una velocidad nula. | ![]() |
Easing.OutQuad | Curva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta una velocidad nula. | ![]() |
Easing.InOutQuad | Curva de aceleración/deceleración para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInQuad | Curva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InCubic | Curva de aceleración/deceleración para una función cúbica (t³): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutCubic | Curva de suavizado para una función cúbica (t³): desaceleración hasta una velocidad nula. | ![]() |
Easing.InOutCubic | Curva de suavizado para una función cúbica (t^3): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInCubic | Curva de suavizado para una función cúbica (t³): desaceleración hasta la mitad del recorrido, y luego aceleración. | ![]() |
Easing.InQuart | Curva de suavizado para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutQuart | Curva de suavizado para una función de cuarto grado (t^4): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutQuart | Curva de suavizado para una función de cuarto grado (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInQuart | Curva de suavizado para una función de cuarto grado (t^4): desaceleración hasta la mitad del recorrido, y luego aceleración. | ![]() |
Easing.InQuint | Curva de suavizado para una función quíntica (t^5): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutQuint | Curva de suavizado para una función de quinto grado (t^5): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutQuint | Curva de suavizado para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInQuint | Curva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InSine | Curva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutSine | Curva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutSine | Curva de suavizado para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInSine | Curva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InExpo | Curva de suavizado para una función exponencial (2^t): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutExpo | Curva de aceleración/deceleración para una función exponencial (2^t): desaceleración hasta la velocidad cero. | ![]() |
Easing.InOutExpo | Curva de aceleración/deceleración para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInExpo | Curva de aceleración/deceleración para una función exponencial (2^t): deceleración hasta la mitad del recorrido y, a continuación, aceleración. | ![]() |
Easing.InCirc | Curva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutCirc | Curva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutCirc | Curva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInCirc | Curva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InElastic | Curva de suavizado para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración partiendo de una velocidad nula. La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ». | ![]() |
Easing.OutElastic | Curva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): deceleración hasta velocidad cero. La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ». | ![]() |
Easing.InOutElastic | Curva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInElastic | Curva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InBack | Curva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración inicial: acelerando desde una velocidad nula. | ![]() |
Easing.OutBack | Curva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) en la entrada: desaceleración hasta velocidad cero. | ![]() |
Easing.InOutBack | Curva de suavizado para una función cúbica con sobreimpulso (s+1)*t^3 - s*t²): entrada y salida: aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInBack | Curva de aceleración/desaceleración para un retroceso (aceleración/desaceleración cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración y desaceleración: desaceleración hasta la mitad y, a continuación, aceleración. | ![]() |
Easing.InBounce | Curva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutBounce | Curva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutBounce | Curva de suavizado para una función de rebote (rebote parabólico con decaimiento exponencial) con entrada y salida suaves: aceleración hasta la mitad y, a continuación, desaceleración. | ![]() |
Easing.OutInBounce | Curva de aceleración/deceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta la mitad y, a continuación, aceleración. | ![]() |
Easing.BezierSpline | Curva de suavizado personalizada definida por la propiedad easing.bezierCurve. |
easing.amplitude Solo es aplicable a las curvas de rebote y elásticas (curvas de tipo Easing.InBounce, Easing.OutBounce, Easing.InOutBounce, Easing.OutInBounce, Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic).
easing.overshoot Solo es aplicable si easing.type es: Easing.InBack, Easing.OutBack, Easing.InOutBack o Easing.OutInBack.
easing.period Solo es aplicable si easing.type es: Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic.
easing.bezierCurve Solo es aplicable si easing.type es: Easing.BezierSpline. Esta propiedad es una lista<real> que contiene grupos de tres puntos que definen una curva desde 0,0 hasta 1,1 —punto de control 1, punto de control 2, punto final—: [cx1, cy1, cx2, cy2, endx, endy, ...]. El último punto debe ser 1,1.
Consulta las «Curvas de aceleración» para ver una demostración de los diferentes ajustes de aceleración.
exclude : list<QtObject> [read-only]
Esta propiedad indica los elementos que no se verán afectados por esta animación.
Véase también PropertyAnimation::targets.
from : variant
Esta propiedad contiene el valor inicial de la animación.
Si la propiedad « PropertyAnimation » se define dentro de un « Transition » o « Behavior », este valor toma por defecto el valor definido en el estado inicial del « Transition », o el valor actual de la propiedad en el momento en que se activa el « Behavior ».
Véase también «Animación y transiciones» en Qt Quick.
Estas propiedades se utilizan como conjunto para determinar qué propiedades deben animarse. Las formas en singular y en plural son funcionalmente idénticas; por ejemplo,
NumberAnimation { target: theItem; property: "x"; to: 500 }tiene el mismo significado que
NumberAnimation { targets: theItem; properties: "x"; to: 500 }Las formas en singular están ligeramente optimizadas, por lo que, si solo tienes un único objetivo o propiedad que animar, deberías intentar utilizarlas.
La propiedad « targets » permite establecer varios objetivos. Por ejemplo, esto anima la propiedad « x » tanto de itemA como de itemB:
NumberAnimation { targets: [itemA, itemB]; properties: "x"; to: 500 }En muchos casos, no es necesario especificar estas propiedades de forma explícita, ya que el marco de animación puede deducirlas:
| Fuente de valor / Comportamiento | Cuando se utiliza una animación como fuente de valor o en un comportamiento, tanto el destino predeterminado como el nombre de la propiedad que se va a animar pueden deducirse. |
| Transición | Cuando se utiliza en una transición, se supone que una animación de propiedad coincide con todos los destinos, pero con ninguna propiedad. En la práctica, eso significa que es necesario especificar al menos las propiedades para que la animación surta efecto. |
| De forma independiente | Cuando una animación se utiliza de forma independiente, es necesario especificar explícitamente tanto el objetivo como la propiedad. |
Como se ve en el ejemplo anterior, las propiedades se especifican como una cadena de nombres de propiedades, separados por comas, que se van a animar.
Véase también « exclude » y «Animación y transiciones» en Qt Quick.
to : variant
Esta propiedad contiene el valor final de la animación.
Si la propiedad « PropertyAnimation » se define dentro de un « Transition » o un « Behavior », este valor toma por defecto el valor definido en el estado final del « Transition », o el valor del cambio de propiedad que desencadenó la « Behavior ».
Véase también «Animaciones y transiciones» en Qt Quick.
© 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.








































