En esta página

SmoothedAnimation QML Type

Permite que una propiedad siga de forma fluida la evolución de un valor. Más...

Import Statement: import QtQuick
Inherits:

NumberAnimation

Propiedades

Descripción detallada

Una SmoothedAnimation anima el valor de una propiedad hasta un valor objetivo establecido utilizando una curva de animación «ease in/out quad». Cuando cambia el valor objetivo, las curvas de animación utilizadas para animar entre el valor objetivo anterior y el nuevo se unen de forma fluida para crear un movimiento suave hacia el nuevo valor objetivo que mantiene la velocidad actual.

El siguiente ejemplo muestra un « Rectangle » que sigue la posición de otro utilizando «SmoothedAnimation». Los valores de « x » y « y » del rectángulo verde están vinculados a los del rectángulo rojo. Cada vez que estos valores cambian, el rectángulo verde se anima suavemente hasta su nueva posición:

import QtQuick

Rectangle {
    width: 800; height: 600
    color: "blue"

    Rectangle {
        width: 60; height: 60
        x: rect1.x - 5; y: rect1.y - 5
        color: "green"

        Behavior on x { SmoothedAnimation { velocity: 200 } }
        Behavior on y { SmoothedAnimation { velocity: 200 } }
    }

    Rectangle {
        id: rect1
        width: 50; height: 50
        color: "red"
    }

    focus: true
    Keys.onRightPressed: rect1.x = rect1.x + 100
    Keys.onLeftPressed: rect1.x = rect1.x - 100
    Keys.onUpPressed: rect1.y = rect1.y - 100
    Keys.onDownPressed: rect1.y = rect1.y + 100
}

Una SmoothedAnimation se puede configurar estableciendo el velocity en el que debe producirse la animación, o el duration que debe seguir la animación. Si se especifican tanto el velocity como el duration, se elige el que da lugar a la animación más rápida para cada cambio en el valor de destino.

Por ejemplo, una animación de 0 a 800 tardará 4 segundos si se establece una velocidad de 200, tardará 8 segundos si se establece una duración de 8000 y tardará 4 segundos si se establecen tanto una velocidad de 200 como una duración de 8000. La animación de 0 a 20 000 tardará 10 segundos si se establece una velocidad de 200, tardará 8 segundos si se establece una duración de 8 000 y tardará 8 segundos si se establecen tanto una velocidad de 200 como una duración de 8 000.

La velocidad predeterminada de SmoothedAnimation es de 200 unidades/segundo. Ten en cuenta que, si el rango del valor que se anima es pequeño, será necesario ajustar la velocidad adecuadamente. Por ejemplo, la opacidad de un elemento oscila entre 0 y 1,0. Para conseguir una animación fluida en este rango, será necesario establecer la velocidad en un valor como 0,5 unidades/segundo. Animar de 0 a 1,0 con una velocidad de 0,5 tardará 2000 ms en completarse.

Al igual que cualquier otro tipo de animación, una «SmoothedAnimation» puede aplicarse de diversas formas, incluyendo transiciones, comportamientos y fuentes de valores de propiedades. La documentación «Animación y transiciones» en Qt Quick muestra diversos métodos para crear animaciones.

Véase también SpringAnimation, NumberAnimation, «Animación y transiciones» en Qt Quick y Qt Quick Ejemplos - Animación.

Documentación de propiedades

duration : int

Esta propiedad almacena la duración de la animación, en milisegundos, que se utiliza al realizar el seguimiento de la fuente.

Si se establece en -1 (el valor por defecto), se desactiva el valor de duración.

Si tanto el valor de velocidad como el de duración están activados, la animación utilizará el que proporcione la duración más corta.

maximumEasingTime : int

Esta propiedad especifica el tiempo máximo, en milisegundos, que deben durar las «aceleraciones» durante el seguimiento. Al configurar esta propiedad, la velocidad se «estabiliza» tras un tiempo determinado. Si se establece un valor negativo, se vuelve al modo normal de aceleración durante toda la duración de la animación.

El valor por defecto es -1.

reversingMode : enumeration

Establece cómo se comporta el objeto « SmoothedAnimation » si se invierte la dirección de una animación.

Los valores posibles son:

ConstanteDescripción
SmoothedAnimation.Eased(por defecto) la animación desacelerará suavemente y, a continuación, invertirá la dirección
SmoothedAnimation.Immediatela animación comenzará a acelerar inmediatamente en la dirección opuesta, partiendo de una velocidad de 0
SmoothedAnimation.Syncla propiedad se establece inmediatamente en el valor de destino

velocity : real

Esta propiedad contiene la velocidad media permitida al realizar el seguimiento del valor «to».

La velocidad predeterminada de SmoothedAnimation es de 200 unidades por segundo.

Si se establece en -1, se desactiva el valor de velocidad.

Si tanto el valor de velocidad como el de duración están activados, la animación utilizará el que proporcione la duración más corta.

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