En esta página

QPropertyAnimation Class

La clase QPropertyAnimation anima las propiedades de Qt. Más información...

Encabezado: #include <QPropertyAnimation>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredan: QVariantAnimation

Propiedades

Funciones públicas

QPropertyAnimation(QObject *parent = nullptr)
QPropertyAnimation(QObject *target, const QByteArray &propertyName, QObject *parent = nullptr)
virtual ~QPropertyAnimation()
QBindable<QByteArray> bindablePropertyName()
QBindable<QObject *> bindableTargetObject()
QByteArray propertyName() const
void setPropertyName(const QByteArray &propertyName)
void setTargetObject(QObject *target)
QObject *targetObject() const

Funciones protegidas reimplementadas

virtual bool event(QEvent *event) override
virtual void updateCurrentValue(const QVariant &value) override
virtual void updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState) override

Descripción detallada

QPropertyAnimation realiza interpolaciones sobre las propiedades de Qt. Dado que los valores de las propiedades se almacenan en objetos de tipo ` QVariant`, la clase hereda de ` QVariantAnimation` y admite la animación de los mismos ` meta types ` que su superclase.

Una clase que declare propiedades debe ser de tipo ` QObject`. Para que sea posible animar una propiedad, debe proporcionar un setter (de modo que `QPropertyAnimation` pueda establecer el valor de la propiedad). Ten en cuenta que esto permite animar muchos de los Qt Widgets. Veamos un ejemplo:

#include <QApplication>
#include <QPushButton>
#include <QPropertyAnimation>

class MyButtonWidget : public QWidget
{
public:
    MyButtonWidget(QWidget *parent = nullptr);
};

MyButtonWidget::MyButtonWidget(QWidget *parent) : QWidget(parent)
{
    QPushButton *button = new QPushButton(tr("Animated Button"), this);
    QPropertyAnimation *anim = new QPropertyAnimation(button, "pos", this);
    anim->setDuration(10000);
    anim->setStartValue(QPoint(0, 0));
    anim->setEndValue(QPoint(100, 250));
    anim->start();
}

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MyButtonWidget buttonAnimWidget;
    buttonAnimWidget.resize(QSize(800, 600));
    buttonAnimWidget.show();
    return a.exec();
}

Nota: Tambiénpuedes controlar la duración de una animación eligiendo un ` delete policy ` al iniciar la animación.

El nombre de la propiedad y la instancia de ` QObject ` de la propiedad que se va a animar se pasan al constructor. A continuación, puedes especificar los valores inicial y final de la propiedad. El procedimiento es el mismo para las propiedades de las clases que hayas implementado tú mismo; solo tienes que comprobar en QVariantAnimation que tu tipo ` QVariant ` sea compatible.

La descripción de la clase QVariantAnimation explica detalladamente cómo configurar la animación. Ten en cuenta, sin embargo, que si no se establece un valor inicial, la propiedad comenzará con el valor que tenía cuando se creó la instancia de QPropertyAnimation.

QPropertyAnimation funciona a la perfección por sí sola. Para animaciones complejas que, por ejemplo, contengan varios objetos, se ofrece QAnimationGroup. Un grupo de animación es una animación que puede contener otras animaciones y que puede gestionar cuándo se reproducen dichas animaciones. Consulta QParallelAnimationGroup para ver un ejemplo.

Véase también QVariantAnimation, QAnimationGroup y El marco de trabajo de animación.

Documentación de propiedades

[bindable] propertyName : QByteArray

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

Esta propiedad contiene el nombre de la propiedad de destino para esta animación

Esta propiedad define el nombre de la propiedad de destino para esta animación. El nombre de la propiedad es obligatorio para que la animación funcione.

Funciones de acceso:

QByteArray propertyName() const
void setPropertyName(const QByteArray &propertyName)

[bindable] targetObject : QObject*

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

Esta propiedad contiene el QObject de destino para esta animación.

Esta propiedad define el QObject de destino para esta animación.

Funciones de acceso:

QObject *targetObject() const
void setTargetObject(QObject *target)

Documentación de funciones de miembro

QPropertyAnimation::QPropertyAnimation(QObject *parent = nullptr)

Crea un objeto `QPropertyAnimation`. Se pasa ` parent ` al constructor de ` QObject`.

QPropertyAnimation::QPropertyAnimation(QObject *target, const QByteArray &propertyName, QObject *parent = nullptr)

Crea un objeto `QPropertyAnimation`. Se pasa ` parent ` al constructor de ` QObject`. La animación modifica la propiedad ` propertyName ` de ` target`. La duración por defecto es de 250 ms.

Véase también targetObject y propertyName.

[virtual noexcept] QPropertyAnimation::~QPropertyAnimation()

Elimina la instancia de « QPropertyAnimation ».

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

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

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

Reimplementa: ` QVariantAnimation::updateCurrentValue(const QVariant &value)`.

QVariantAnimation llama a esta función virtual cada vez que cambia el valor actual. value es el nuevo valor actualizado. Actualiza el valor actual de la propiedad en el objeto de destino, a menos que se haya detenido la animación.

Véase también currentValue y currentTime.

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

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

Si no se ha definido startValue cuando el estado de la animación cambia de «Stopped» a «Running», se utiliza el valor actual de la propiedad como valor inicial para la animación.

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