En esta página

QSequentialAnimationGroup Class

La clase QSequentialAnimationGroup proporciona un grupo secuencial de animaciones. Más...

Cabecera: #include <QSequentialAnimationGroup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Hereda: 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 QAnimationGroup que ejecuta sus animaciones en secuencia, es decir, inicia una animación después de que otra haya terminado de reproducirse. Las animaciones se reproducen en el orden en que se añaden al grupo (utilizando addAnimation() o insertAnimation()). El grupo de animación termina cuando termina la última animación.

En cada momento hay como máximo una animación activa en el grupo; es devuelta por currentAnimation(). Un grupo vacío no tiene ninguna animación en curso.

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 puede 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 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 soporta enlaces QProperty.

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

Funciones de acceso:

QAbstractAnimation *currentAnimation() const

Señal del notificador:

void currentAnimationChanged(QAbstractAnimation *current)

Documentación de funciones miembro

QSequentialAnimationGroup::QSequentialAnimationGroup(QObject *parent = nullptr)

Construye un QSequentialAnimationGroup. parent se pasa al constructor de QObject.

[virtual noexcept] QSequentialAnimationGroup::~QSequentialAnimationGroup()

Destruye el grupo de animación. También destruirá todas sus animaciones.

QPauseAnimation *QSequentialAnimationGroup::addPause(int msecs)

Añade una pausa de msecs a este grupo de animación. La pausa se considera como un tipo especial de animación, por lo que 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 currentAnimation ha sido modificada. current es la animación actual.

Nota: Señal notificadora 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 en 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::Dirección 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.