Sur cette page

QSequentialAnimationGroup Class

La classe `QSequentialAnimationGroup` permet de créer un groupe d'animations séquentielles. En savoir plus...

En-tête : #include <QSequentialAnimationGroup>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core
Hérite de : QAnimationGroup

Propriétés

Fonctions publiques

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

Fonctions publiques réimplémentées

virtual int duration() const override

Signaux

void currentAnimationChanged(QAbstractAnimation *current)

Fonctions protégées réimplémentées

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

Description détaillée

QSequentialAnimationGroup est un groupe d'animations ( QAnimationGroup ) qui exécute ses animations de manière séquentielle, c'est-à-dire qu'il lance une animation dès que la précédente a fini de s'afficher. Les animations sont lues dans l'ordre où elles ont été ajoutées au groupe (à l'aide de addAnimation() ou insertAnimation()). Le groupe d'animations s'arrête lorsque sa dernière animation est terminée.

À tout moment, il n’y a au maximum qu’une seule animation active dans le groupe ; celle-ci est renvoyée par la fonction currentAnimation(). Un groupe vide ne comporte aucune animation en cours.

Un groupe d’animations séquentielles peut être traité comme n’importe quelle autre animation, c’est-à-dire qu’il peut être lancé, arrêté et ajouté à d’autres groupes. Vous pouvez également appeler addPause() ou insertPause() pour ajouter une pause à un groupe d’animations séquentielles.

    QSequentialAnimationGroup *group = new QSequentialAnimationGroup;

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

    group->start();

Dans cet exemple, anim1 et anim2 sont deux groupes d'animation séquentiels ( QPropertyAnimation) déjà configurés.

Voir également QAnimationGroup, QAbstractAnimation et Le framework d’animation.

Documentation sur les propriétés

[bindable read-only] currentAnimation : QAbstractAnimation*

Remarque : cette propriété prend en charge les liaisons de type « QProperty ».

Cette propriété maintient l'animation à l'instant présent.

Fonctions d'accès :

QAbstractAnimation *currentAnimation() const

Signal de notification :

void currentAnimationChanged(QAbstractAnimation *current)

Documentation des fonctions membres

QSequentialAnimationGroup::QSequentialAnimationGroup(QObject *parent = nullptr)

Crée un objet `QSequentialAnimationGroup`. L'objet ` parent ` est transmis au constructeur de ` QObject`.

[virtual noexcept] QSequentialAnimationGroup::~QSequentialAnimationGroup()

Supprime le groupe d'animations. Cela supprimera également toutes ses animations.

QPauseAnimation *QSequentialAnimationGroup::addPause(int msecs)

Ajoute une pause de msecs à ce groupe d'animations. La pause est considérée comme un type particulier d'animation ; par conséquent, la valeur de animationCount sera augmentée d'un.

Voir également insertPause() et QAnimationGroup::addAnimation().

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

QSequentialAnimationGroup émet ce signal lorsque la propriété « currentAnimation » a été modifiée. « current » correspond à l'animation en cours.

Remarque : signalde notification pour la propriété currentAnimation.

Voir également currentAnimation().

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

Réimplémente : QAbstractAnimation::duration() const.

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

Réimplémente : QAnimationGroup::event(QEvent *event).

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

Insère une pause de msecs millisecondes à l'adresse index dans ce groupe d'animation.

Voir également addPause() et QAnimationGroup::insertAnimation().

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

Réimplémente : QAbstractAnimation::updateCurrentTime(int currentTime).

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

Réimplémente : QAbstractAnimation::updateDirection(QAbstractAnimation::Direction direction).

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

Réimplémente : 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.