En esta página

Animation QML Type (Uncreatable)

Es la base de todas las animaciones de QML. Más información...

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Señales

Métodos

Descripción detallada

El tipo «Animation» no se puede utilizar directamente en un archivo QML. Su finalidad es proporcionar un conjunto de propiedades y métodos comunes, disponibles en todos los demás tipos de animación que heredan de él. Si se intenta utilizar el tipo «Animation» directamente, se producirá un error.

Documentación de propiedades

alwaysRunToEnd : bool

Esta propiedad determina si la animación debe completarse cuando se detiene.

Si este valor es «true», la animación completará su iteración actual cuando se detenga, ya sea estableciendo la propiedad « running » en «false» o llamando al método « stop() ». El método « complete() » no se ve afectado por este valor.

Este comportamiento resulta especialmente útil cuando se establece la propiedad ` loops `, ya que la animación terminará de reproducirse con normalidad, pero no se reiniciará.

Por defecto, la propiedad `alwaysRunToEnd` no está activada.

Nota: «alwaysRunToEnd» no tiene ningún efecto sobre las animaciones de una transición.

loops : int

Esta propiedad indica el número de veces que debe reproducirse la animación.

Por defecto, « loops » es 1: la animación se reproducirá una vez y luego se detendrá.

Si se establece en «Animation.Infinite», la animación se repetirá continuamente hasta que se detenga explícitamente, ya sea estableciendo la propiedad « running » en «false» o llamando al método « stop() ».

En el siguiente ejemplo, el rectángulo girará indefinidamente.

Rectangle {
    width: 100; height: 100; color: "green"
    RotationAnimation on rotation {
        loops: Animation.Infinite
        from: 0
        to: 360
    }
}

paused : bool

Esta propiedad indica si la animación está actualmente en pausa.

La propiedad ` paused ` se puede establecer para controlar de forma declarativa si una animación está en pausa o no.

Las animaciones también se pueden pausar y reanudar de forma imperativa desde JavaScript utilizando los métodos ` pause() ` y ` resume() `.

Por defecto, las animaciones no están en pausa.

running : bool

Esta propiedad indica si la animación se está ejecutando en ese momento.

La propiedad « running » se puede configurar para controlar de forma declarativa si una animación se está ejecutando o no. El siguiente ejemplo animará un rectángulo cada vez que se pulse la tecla « MouseArea ».

Rectangle {
    width: 100; height: 100
    NumberAnimation on x {
        running: myMouse.pressed
        from: 0; to: 100
    }
    MouseArea { id: myMouse }
}

Del mismo modo, se puede leer la propiedad ` running ` para determinar si la animación se está ejecutando. En el siguiente ejemplo, el elemento `Text` indicará si la animación se está ejecutando o no.

NumberAnimation { id: myAnimation }
Text { text: myAnimation.running ? "Animation is running" : "Animation is not running" }

Las animaciones también se pueden iniciar y detener de forma imperativa desde JavaScript utilizando los métodos start() y stop().

Por defecto, las animaciones no se ejecutan. Sin embargo, cuando las animaciones se asignan a propiedades como fuentes de valor de propiedad utilizando la sintaxis «on», se establecen en ejecución de forma predeterminada.

Documentación de Signal

finished()

Esta señal se emite cuando la animación ha finalizado de forma natural.

No se emite cuando la propiedad ` running ` está establecida en ` false`, ni en el caso de animaciones cuya propiedad ` loops ` esté establecida en ` Animation.Infinite`.

Además, solo se emite para animaciones independientes de nivel superior. No se emitirá para animaciones dentro de un comportamiento o una transición, ni para animaciones que formen parte de un grupo de animación.

Si alwaysRunToEnd es «true», esta señal no se emitirá hasta que la animación haya completado su iteración actual.

Nota: El controlador correspondiente es ` onFinished`.

Véase también stopped(), started() y running.

started()

Esta señal se emite cuando comienza la animación.

Solo se activa en animaciones independientes de nivel superior. No se activará en animaciones incluidas en un comportamiento o una transición, ni en animaciones que formen parte de un grupo de animaciones.

Nota: El controlador correspondiente es onStarted.

stopped()

Esta señal se emite cuando finaliza la animación.

La animación puede haberse detenido manualmente o puede haber llegado a su fin.

Solo se activa para animaciones independientes de nivel superior. No se activará para animaciones incluidas en un «Comportamiento» o una «Transición», ni para animaciones que formen parte de un grupo de animación.

Si alwaysRunToEnd es «true», esta señal no se emitirá hasta que la animación haya completado su iteración actual.

Nota: El controlador correspondiente es onStopped.

Documentación del método

void complete()

Detiene la animación y pasa directamente a los valores finales de las propiedades.

Si la animación no se está ejecutando, llamar a este método no tiene ningún efecto. La propiedad ` running ` será `false` tras llamar a ` complete()`.

A diferencia de ` stop()`, ` complete() ` avanza inmediatamente la animación hasta su final. En el siguiente ejemplo,

Rectangle {
    NumberAnimation on x { from: 0; to: 100; duration: 500 }
}

la llamada a ` stop() ` en el momento 250 ms hará que la propiedad ` x ` tenga un valor de 50, mientras que la llamada a ` complete() ` establecerá la propiedad ` x ` en 100, exactamente como si la animación se hubiera reproducido hasta el final.

void pause()

Detiene la animación.

Si la animación ya está en pausa o no es « running », llamar a este método no tiene ningún efecto. La propiedad « paused » pasará a ser «true» tras llamar a « pause() ».

void restart()

Reinicia la animación.

Se trata de un método de conveniencia, equivalente a llamar a « stop() » y, a continuación, a « start() ».

void resume()

Reanuda una animación pausada.

Si la animación no está en pausa o no se encuentra en el estado « running », llamar a este método no tendrá ningún efecto. La propiedad « paused » pasará a ser «false» tras llamar a « resume() ».

void start()

Inicia la animación.

Si la animación ya se está ejecutando, llamar a este método no tiene ningún efecto. La propiedad ` running ` pasará a ser `true` tras llamar a ` start()`.

void stop()

Detiene la animación.

Si la animación no se está ejecutando, llamar a este método no tiene ningún efecto. Tanto la propiedad « running » como la propiedad « paused » serán «false» tras llamar a « stop() ».

Normalmente, ` stop() ` detiene la animación de forma inmediata, y la animación ya no influye en los valores de las propiedades. En este ejemplo, la animación

Rectangle {
    NumberAnimation on x { from: 0; to: 100; duration: 500 }
}

se detuvo en el momento 250 ms, la propiedad x tendrá un valor de 50.

Sin embargo, si la propiedad « alwaysRunToEnd » está activada, la animación seguirá ejecutándose hasta que finalice y, solo entonces, se detendrá. La propiedad « running » seguirá pasando a «false» de forma inmediata.

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