En esta página

QSequentialAnimationGroup Class

La clase `QSequentialAnimationGroup` proporciona un grupo secuencial de animaciones. Más información...

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

Propiedades

Funciones públicas

QSequentialAnimationGroup(QObject *parent = nullptr)
virtual ~QSequentialAnimationGroup()
QPauseAnimation *addPause(int msecs)
QBindable<QAbstractAnimation *> bindableCurrentAnimation() const
QAbstractAnimation *currentAnimation() const
QPauseAnimation *insertPause(int index, int msecs)

Funciones públicas reimplementadas

virtual int duration() const override

Señales

void currentAnimationChanged(QAbstractAnimation *current)

Funciones protegidas reimplementadas

virtual bool event(QEvent *event) override
virtual void updateCurrentTime(int currentTime) override
virtual void updateDirection(QAbstractAnimation::Direction direction) override
virtual void updateState(QAbstractAnimation::State newState, QAbstractAnimation::State oldState) override

Descripción detallada

QSequentialAnimationGroup es un grupo de animación secuencial ( QAnimationGroup ) que ejecuta sus animaciones de forma secuencial, es decir, inicia una animación una vez que ha finalizado la reproducción de la anterior. Las animaciones se reproducen en el orden en que se añaden al grupo (mediante addAnimation() o insertAnimation()). El grupo de animación finaliza cuando ha terminado su última animación.

En cada momento hay como máximo una animación activa en el grupo; esta es la que devuelve la función currentAnimation(). Un grupo vacío no tiene ninguna animación activa.

Un grupo de animación secuencial puede tratarse como cualquier otra animación, es decir, puede iniciarse, detenerse y añadirse a otros grupos. También puedes llamar a addPause() o insertPause() para añadir una pausa a un grupo de animación secuencial.

    QSequentialAnimationGroup *group = new QSequentialAnimationGroup;

    group->addAnimation(anim1);
    group->addAnimation(anim2);

    group->start();

En este ejemplo, ` anim1 ` y ` anim2 ` son dos grupos de animación secuenciales ( QPropertyAnimations) ya configurados.

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

Documentación de propiedades

[bindable read-only] currentAnimation : QAbstractAnimation*

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

Esta propiedad mantiene la animación en el momento actual.

Funciones de acceso:

QAbstractAnimation *currentAnimation() const

Señal del notificador:

void currentAnimationChanged(QAbstractAnimation *current)

Documentación de las funciones de miembro

QSequentialAnimationGroup::QSequentialAnimationGroup(QObject *parent = nullptr)

Crea un objeto `QSequentialAnimationGroup`. El objeto ` parent ` se pasa al constructor de ` QObject`.

[virtual noexcept] QSequentialAnimationGroup::~QSequentialAnimationGroup()

Elimina el grupo de animaciones. También eliminará todas sus animaciones.

QPauseAnimation *QSequentialAnimationGroup::addPause(int msecs)

Añade una pausa de msecs a este grupo de animación. La pausa se considera un tipo especial de animación, por lo que el valor de animationCount se incrementará en uno.

Véase también insertPause() y QAnimationGroup::addAnimation().

[signal] void QSequentialAnimationGroup::currentAnimationChanged(QAbstractAnimation *current)

QSequentialAnimationGroup Emite esta señal cuando se ha modificado la propiedad « currentAnimation ». « current » es la animación actual.

Nota: Señalde notificación para la propiedad currentAnimation.

Véase también currentAnimation().

[override virtual] int QSequentialAnimationGroup::duration() const

Reimplementa: QAbstractAnimation::duration() const.

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

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

QPauseAnimation *QSequentialAnimationGroup::insertPause(int index, int msecs)

Inserta una pausa de msecs milisegundos en index dentro de este grupo de animación.

Véase también addPause() y QAnimationGroup::insertAnimation().

[override virtual protected] void QSequentialAnimationGroup::updateCurrentTime(int currentTime)

Reimplementa: QAbstractAnimation::updateCurrentTime(int currentTime).

[override virtual protected] void QSequentialAnimationGroup::updateDirection(QAbstractAnimation::Direction direction)

Reimplementa: QAbstractAnimation::updateDirection(QAbstractAnimation::Direction direction).

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

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

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