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: |
- Lista de todos los miembros, incluidos los heredados
- QVariantAnimation forma parte de Animation Framework.
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 |
Elementos no miembros relacionados
| 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
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.