QAbstractAnimation Class

Fonction membre Documentation

QAbstractAnimation::QAbstractAnimation(QObject *parent = nullptr)

Construit la classe de base QAbstractAnimation et transmet parent au constructeur de QObject.

Voir aussi QVariantAnimation et QAnimationGroup.

[virtual noexcept] QAbstractAnimation::~QAbstractAnimation()

Arrête l'animation si elle est en cours, puis détruit le site QAbstractAnimation. Si l'animation fait partie d'un site QAnimationGroup, elle est automatiquement supprimée avant d'être détruite.

[signal] void QAbstractAnimation::currentLoopChanged(int currentLoop)

QAbstractAnimation émet ce signal chaque fois que la boucle en cours change. currentLoop est la boucle en cours.

Voir aussi currentLoop() et loopCount().

int QAbstractAnimation::currentLoopTime() const

Renvoie l'heure actuelle à l'intérieur de la boucle en cours. Il peut aller de 0 à duration().

Voir aussi duration() et currentTime.

[signal] void QAbstractAnimation::directionChanged(QAbstractAnimation::Direction newDirection)

QAbstractAnimation émet ce signal lorsque la direction a été modifiée. newDirection est la nouvelle direction.

Voir aussi direction.

[pure virtual] int QAbstractAnimation::duration() const

Cette fonction purement virtuelle renvoie la durée de l'animation et définit pendant combien de temps QAbstractAnimation doit mettre à jour l'heure actuelle. Cette durée est locale et n'inclut pas le nombre de boucles.

Une valeur de retour de -1 indique que l'animation n'a pas de durée définie ; l'animation doit fonctionner indéfiniment jusqu'à ce qu'elle soit arrêtée. C'est utile pour les animations qui ne sont pas pilotées par le temps, ou pour lesquelles vous ne pouvez pas facilement prévoir la durée (par exemple, la lecture audio pilotée par des événements dans un jeu).

Si l'animation est une QAnimationGroup parallèle, la durée sera la durée la plus longue de toutes ses animations. Si l'animation est séquentielle ( QAnimationGroup), la durée sera la somme des durées de toutes les animations.

Voir également loopCount.

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

Réimplémente : QObject::event(QEvent *e).

[signal] void QAbstractAnimation::finished()

QAbstractAnimation émet ce signal lorsque l'animation s'est arrêtée et a atteint la fin.

Ce signal est émis après stateChanged().

Voir aussi stateChanged().

QAnimationGroup *QAbstractAnimation::group() const

Si cette animation fait partie d'un groupe QAnimationGroup, cette fonction renvoie un pointeur sur le groupe ; sinon, elle renvoie nullptr.

Voir aussi QAnimationGroup::addAnimation().

[slot] void QAbstractAnimation::pause()

Met l'animation en pause. Lorsque l'animation est mise en pause, state() renvoie Paused. La valeur de currentTime restera inchangée jusqu'à ce que resume() ou start() soit appelé. Si vous voulez continuer à partir de l'heure actuelle, appelez resume().

Voir également start(), state() et resume().

[slot] void QAbstractAnimation::resume()

Reprend l'animation après l'avoir interrompue. Lorsque l'animation est reprise, elle émet le signal stateChanged(). La propriété currentTime n'est pas modifiée.

Voir aussi start(), pause() et state().

[slot] void QAbstractAnimation::setPaused(bool paused)

Si paused est vrai, l'animation est mise en pause. Si paused est faux, l'animation reprend.

Voir aussi state(), pause() et resume().

[slot] void QAbstractAnimation::start(QAbstractAnimation::DeletionPolicy policy = KeepWhenStopped)

Démarre l'animation. L'argument policy indique si l'animation doit être supprimée ou non lorsqu'elle est terminée. Lorsque l'animation démarre, le signal stateChanged() est émis et state() renvoie Running. Lorsque le contrôle atteint la boucle d'événements, l'animation s'exécute d'elle-même, en appelant périodiquement updateCurrentTime() au fur et à mesure que l'animation progresse.

Si l'animation est actuellement arrêtée ou a déjà atteint la fin, l'appel à start() rembobine l'animation et la reprend depuis le début. Lorsque l'animation atteint la fin, elle s'arrête ou, si le niveau de la boucle est supérieur à 1, elle revient en arrière et reprend depuis le début.

Si l'animation est déjà en cours, cette fonction ne fait rien.

Voir aussi stop() et state().

[signal] void QAbstractAnimation::stateChanged(QAbstractAnimation::State newState, QAbstractAnimation::State oldState)

QAbstractAnimation émet ce signal lorsque l'état de l'animation est passé de oldState à newState. Ce signal est émis après l'appel de la fonction virtuelle updateState().

Voir également updateState().

[slot] void QAbstractAnimation::stop()

Arrête l'animation. Lorsque l'animation est arrêtée, elle émet le signal stateChanged() et state() renvoie Stopped. L'heure actuelle n'est pas modifiée.

Si l'animation s'arrête d'elle-même après avoir atteint la fin (c'est-à-dire, currentLoopTime() == duration() et currentLoop() > loopCount() - 1), le signal finished() est émis.

Voir également start() et state().

int QAbstractAnimation::totalDuration() const

Renvoie la durée totale et effective de l'animation, y compris le nombre de boucles.

Voir aussi duration() et currentTime.

[pure virtual protected] void QAbstractAnimation::updateCurrentTime(int currentTime)

Cette fonction purement virtuelle est appelée à chaque fois que l'animation currentTime change.

Voir aussi updateState().

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

Cette fonction virtuelle est appelée par QAbstractAnimation lorsque la direction de l'animation est modifiée. L'argument direction est la nouvelle direction.

Voir aussi setDirection() et direction().

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

Cette fonction virtuelle est appelée par QAbstractAnimation lorsque l'état de l'animation passe de oldState à newState.

Voir aussi start(), stop(), pause() et resume().