En esta página

NumberAnimation QML Type

Muestra de forma animada los cambios en los valores de tipo qreal. Más información...

Import Statement: import QtQuick
Inherits:

PropertyAnimation

Inherited By:

SmoothedAnimation and SpringAnimation

Propiedades

Descripción detallada

NumberAnimation es un PropertyAnimation especializado que define una animación que se aplicará cuando cambie un valor numérico.

A continuación se muestra una NumberAnimation aplicada a la propiedad « x » de un objeto « Rectangle » como fuente de valor de propiedad. Anima el valor de « x » desde su valor actual hasta el valor 50, en un lapso de 1000 milisegundos:

import QtQuick

Rectangle {
    width: 100; height: 100
    color: "red"

    NumberAnimation on x { to: 50; duration: 1000 }
}

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

Ten en cuenta que es posible que NumberAnimation no se anime con fluidez si se producen cambios irregulares en el valor numérico que está siguiendo. Si este es el caso, utiliza en su lugar SmoothedAnimation.

Véase también «Animación y transiciones en Qt Quick » y «Ejemplos deQt Quick: Animación».

Documentación de la propiedad

from : real

Esta propiedad contiene el valor inicial de la animación.

Por ejemplo, la siguiente animación no se aplica hasta que el valor de « x » haya alcanzado 100:

Item {
    states: [
        // ...
    ]

    transitions: Transition {
        NumberAnimation { properties: "x"; from: 100; duration: 200 }
    }
}

Si la propiedad « NumberAnimation » se define dentro de una « Transition » o una « Behavior », este valor toma por defecto el valor definido en el estado inicial de la « Transition », o el valor actual de la propiedad en el momento en que se activa la « Behavior ».

Véase también «Animación y transiciones» en Qt Quick.

to : real

Esta propiedad contiene el valor final de la animación.

Si la propiedad « NumberAnimation » 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.