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 |
- Lista de todos los miembros, incluidos los heredados
- QPropertyAnimation forma parte de Animation Framework.
Propiedades
- propertyName : QByteArray
- targetObject : QObject*
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.