En esta página

QVariantAnimation Class

La clase QVariantAnimation sirve de clase base para las animaciones. Más información...

Encabezado: #include <QVariantAnimation>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QAbstractAnimation
Heredado por:

QPropertyAnimation

Tipos públicos

Propiedades

Funciones públicas

QVariantAnimation(QObject *parent = nullptr)
virtual ~QVariantAnimation()
QBindable<int> bindableDuration()
QBindable<QEasingCurve> bindableEasingCurve()
QVariant currentValue() const
QEasingCurve easingCurve() const
QVariant endValue() const
QVariant keyValueAt(qreal step) const
QVariantAnimation::KeyValues keyValues() const
void setDuration(int msecs)
void setEasingCurve(const QEasingCurve &easing)
void setEndValue(const QVariant &value)
void setKeyValueAt(qreal step, const QVariant &value)
void setKeyValues(const QVariantAnimation::KeyValues &keyValues)
void setStartValue(const QVariant &value)
QVariant startValue() const

Funciones públicas reimplementadas

virtual int duration() const override

Señales

void valueChanged(const QVariant &value)

Funciones protegidas

virtual QVariant interpolated(const QVariant &from, const QVariant &to, qreal progress) const
virtual void updateCurrentValue(const QVariant &value)

Funciones protegidas reimplementadas

virtual bool event(QEvent *event) override
virtual void updateCurrentTime(int) override
virtual void updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState) override
void qRegisterAnimationInterpolator(QVariant (*func)(const T &, const T &, qreal))

Descripción detallada

Esta clase forma parte de The Animation Framework. Sirve como clase base para las animaciones de propiedades y elementos, y cuenta con funciones para la funcionalidad compartida.

La clase realiza la interpolación sobre los « QVariant», pero deja en manos de sus subclases el uso de los valores interpolados. Actualmente, Qt proporciona « QPropertyAnimation », que anima las propiedades de Qt. Consulta la descripción de la clase « QPropertyAnimation » si deseas animar dichas propiedades.

A continuación, puede establecer los valores inicial y final de la propiedad llamando a ` setStartValue()` y ` setEndValue()`, y finalmente llamar a ` start()` para iniciar la animación. `QVariantAnimation` interpolará la propiedad del objeto de destino y emitirá ` valueChanged()`. Para reaccionar ante un cambio en el valor actual, debe reimplementar la función virtual ` updateCurrentValue()` o conectarse a dicha señal.

También es posible establecer valores en pasos específicos situados entre el valor inicial y el final. La interpolación pasará entonces por estos puntos en los pasos especificados. Ten en cuenta que los valores inicial y final se definen como los valores clave en 0,0 y 1,0.

Hay dos formas de influir en cómo QVariantAnimation interpola los valores. Se puede establecer una curva de aceleración llamando a setEasingCurve(), y configurar la duración llamando a setDuration(). Se puede modificar la forma en que se interpolan los QVariants creando una subclase de QVariantAnimation y reimplementando la función virtual interpolated().

Crear una subclase de QVariantAnimation puede ser una alternativa si tienes « QVariant» que no deseas declarar como propiedades de Qt. Ten en cuenta, sin embargo, que en la mayoría de los casos te convendrá más declarar tu « QVariant » como una propiedad.

No todos los tipos de « QVariant » son compatibles. A continuación se muestra una lista de los tipos de « QVariant » compatibles actualmente:

Si necesitas interpolar otros tipos de variantes, incluidos los tipos personalizados, tendrás que implementar tú mismo la interpolación para ellos. Para ello, puedes registrar una función de interpolación para un tipo determinado. Esta función toma tres parámetros: el valor inicial, el valor final y el progreso actual.

Ejemplo:

QVariant myColorInterpolator(const QColor&start, const QColor&end, qreal progress)
{
    // ...
    return QColor(/*...*/);
}
// ...
void someFunc()
{
    // ...
    qRegisterAnimationInterpolator<QColor>(myColorInterpolator);
   // ...
}

Otra opción es reimplementar interpolated(), que devuelve valores de interpolación para el valor que se está interpolando.

Véase también QPropertyAnimation, QAbstractAnimation y El marco de trabajo de animación.

Documentación sobre tipos de miembros

[alias] QVariantAnimation::KeyValue

Se trata de un `typedef` para `std::pair<qreal, QVariant>`.

QVariantAnimation::KeyValues

Se trata de una definición de tipo para QList<KeyValue>

Documentación de propiedades

[read-only] currentValue : QVariant

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

Esta propiedad describe el valor actual; un valor interpolado entre start value y end value, utilizando el tiempo actual para calcular el progreso. El valor en sí se obtiene de interpolated(), que se invoca repetidamente mientras se ejecuta la animación.

QVariantAnimation Llama a la función virtual updateCurrentValue() cuando cambia el valor actual. Esto resulta especialmente útil para las subclases que necesitan realizar un seguimiento de las actualizaciones. Por ejemplo, QPropertyAnimation utiliza esta función para animar propiedades de Qt.

Funciones de acceso:

QVariant currentValue() const

Señal Notifier:

void valueChanged(const QVariant &value)

Véase también startValue y endValue.

[bindable] duration : int

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad indica la duración de la animación

Esta propiedad describe la duración, en milisegundos, de la animación. La duración por defecto es de 250 milisegundos.

Funciones de acceso:

virtual int duration() const override
void setDuration(int msecs)

Véase también QAbstractAnimation::duration().

[bindable] easingCurve : QEasingCurve

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene la curva de aceleración de la animación

Esta propiedad define la curva de aceleración de la animación. Por defecto, se utiliza una curva de aceleración lineal, lo que da lugar a una interpolación lineal. Se ofrecen otras curvas, por ejemplo, QEasingCurve::InCirc, que proporciona una curva de entrada circular. Otro ejemplo es QEasingCurve::InOutElastic, que proporciona un efecto elástico en los valores de la variante interpolada.

QVariantAnimation utilizará la función ` QEasingCurve::valueForProgress()` para transformar el «progreso normalizado» (`currentTime()` / ` totalDuration())` de la animación en el progreso efectivo que realmente utiliza la animación. Es este progreso efectivo el que se considerará como progreso cuando se llame a ` interpolated()`. Además, los pasos del ` keyValues ` hacen referencia a este progreso efectivo.

La curva de aceleración se utiliza junto con el interpolador, la función virtual interpolated() y la duración de la animación para controlar cómo cambia el valor actual a medida que avanza la animación.

Funciones de acceso:

QEasingCurve easingCurve() const
void setEasingCurve(const QEasingCurve &easing)

endValue : QVariant

Esta propiedad contiene el valor final de la animación

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

Funciones de acceso:

QVariant endValue() const
void setEndValue(const QVariant &value)

Véase también startValue.

startValue : QVariant

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

Esta propiedad describe el valor inicial opcional de la animación. Si se omite, o si se asigna un valor nulo QVariant como valor inicial, la animación utilizará la posición actual del final en el momento en que se inicie la animación.

Funciones de acceso:

QVariant startValue() const
void setStartValue(const QVariant &value)

Véase también endValue.

Documentación de funciones de miembro

QVariantAnimation::QVariantAnimation(QObject *parent = nullptr)

Crea un objeto `QVariantAnimation`. Se pasa ` parent ` al constructor de ` QAbstractAnimation`.

[virtual noexcept] QVariantAnimation::~QVariantAnimation()

Elimina la animación.

[override virtual protected] bool QVariantAnimation::event(QEvent *event)

Reimplementa: ` QAbstractAnimation::event(QEvent *event)`.

[virtual protected] QVariant QVariantAnimation::interpolated(const QVariant &from, const QVariant &to, qreal progress) const

Esta función virtual devuelve la interpolación lineal entre las variantes from y to, en progress, normalmente un valor comprendido entre 0 y 1. Puedes reimplementar esta función en una subclase de QVariantAnimation para proporcionar tu propio algoritmo de interpolación.

Ten en cuenta que, para que la interpolación funcione con un ` QEasingCurve ` que devuelva un valor menor que 0 o mayor que 1 (como ` QEasingCurve::InBack`), debes asegurarte de que permita la extrapolación. Si la semántica del tipo de datos no permite la extrapolación, esta función debe gestionarlo de forma adecuada.

Debes llamar a la implementación de QVariantAnimation de esta función si deseas que tu clase gestione los tipos ya compatibles con Qt (consulta la descripción de la clase QVariantAnimation para obtener una lista de los tipos compatibles).

Véase también QEasingCurve.

QVariant QVariantAnimation::keyValueAt(qreal step) const

Devuelve el valor del fotograma clave para el step dado. El step dado debe estar comprendido entre 0 y 1. Si no existe ningún KeyValue para step, devuelve un QVariant no válido.

Véase también keyValues() y setKeyValueAt().

QVariantAnimation::KeyValues QVariantAnimation::keyValues() const

Devuelve los fotogramas clave de esta animación.

Véase también keyValueAt() y setKeyValues().

void QVariantAnimation::setKeyValueAt(qreal step, const QVariant &value)

Crea un fotograma clave en la posición step indicada con el valor value especificado. El valor step debe estar comprendido entre 0 y 1.

Véanse también setKeyValues() y keyValueAt().

void QVariantAnimation::setKeyValues(const QVariantAnimation::KeyValues &keyValues)

Sustituye el conjunto actual de fotogramas clave por el especificado en keyValues. El paso de los fotogramas clave debe estar comprendido entre 0 y 1.

Véanse también keyValues() y keyValueAt().

[override virtual protected] void QVariantAnimation::updateCurrentTime(int)

Reimplementa: ` QAbstractAnimation::updateCurrentTime(int currentTime)`.

[virtual protected] void QVariantAnimation::updateCurrentValue(const QVariant &value)

Esta función virtual se invoca cada vez que cambia el valor actual de la animación. El argumento ` value ` es el nuevo valor actual.

La implementación de la clase base no hace nada.

Véase también currentValue.

[override virtual protected] void QVariantAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState)

Reimplementa: QAbstractAnimation::updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState).

[signal] void QVariantAnimation::valueChanged(const QVariant &value)

QVariantAnimation Emite esta señal cada vez que cambia la propiedad « value ».

Nota: Señalde notificador para la propiedad currentValue.

Véase también currentValue, startValue y endValue.

Elementos no miembros relacionados

template <typename T> void qRegisterAnimationInterpolator(QVariant (*func)(const T &, const T &, qreal))

Registra un interpolador personalizado func para el tipo de plantilla T. El interpolador debe registrarse antes de que se construya la animación. Para dar de baja el registro (y utilizar el interpolador predeterminado), establece func en nullptr.

Advertencia: El registro de un interpolador personalizado para uno de los tipos integrados de Qt (por ejemplo, int) afectará a todas las animaciones de este tipo que se creen posteriormente. Esto podría ser un comportamiento no deseado. Por lo tanto, se recomienda restablecer el interpolador al valor por defecto una vez creadas las animaciones deseadas.

Nota: Esta función es segura para subprocesos.

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