QAnimationGroup

La classe QAnimationGroup est une classe abstraite pour des groupes d'animations. Plus d'informations...

#include <QAnimationGroup>

Héritage

Hérite de QAbstractAnimation.

Hérité par QParallelAnimationGroup et par QSequentialAnimationGroup.

Classe introduite dans Qt 4.6.

Description détaillée

La classe QAnimationGroup est une classe abstraite pour des groupes d'animations.

Un groupe d'animations est un conteneur pour animations (sous-classe de QAbstractAnimation). Un groupe est habituellement responsable de la gestion de l'état de ses animations, c'est-à-dire qu'il décide de leur démarrage, de leur arrêt, de leur reprise et de leur pause. Actuellement, Qt fournit deux de ces groupes : QParallelAnimationGroup et QSequentialAnimationGroup. Voir leurs descriptions pour plus de détails.

Puisque QAnimationGroup hérite de QAbstractAnimation, vous pouvez combiner des groupes et construire facilement des graphes d'animations complexes. Vous pouvez interroger QAbstractAnimation pour connaître le groupe auquel elle appartient (à l'aide de la fonction group()).

Pour démarrer un groupe d'animations de haut niveau, vous utiliserez simplement la fonction start() de QAbstractAnimation. Un groupe d'animations de haut niveau est un groupe qui n'est pas contenu lui-même dans un autre groupe. Démarrer directement par un sous-groupe n'est pas pris en charge et peut conduire à un comportement inattendu.

QAnimationGroup fournit des méthodes pour l'ajout et la récupération d'animations. En outre, vous pouvez supprimer des animations en appelant remove() et effacer le groupe d'animations en appelant clear(). Vous pouvez suivre les changements dans les groupes d'animations en écoutant les événements QEvent::ChildAdded et QEvent::ChildRemoved.

QAnimationGroup prend possession des animations qu'il gère, et s'assure qu'elles sont supprimées lorsque le groupe d'animations est supprimé.

Voir aussi QAbstractAnimation, QVariantAnimation, et animation-overview.

Fonctions membres

QAnimationGroup::QAnimationGroup ( QObject * parent = 0 )

Construit un QAnimationGroup. parent est passé au constructeur de QObject.

QAnimationGroup::~QAnimationGroup ()

Détruit le groupe d'animation. Il détruira aussi toutes ses animations.

void QAnimationGroup::addAnimation ( QAbstractAnimation * animation )

Ajoute animation à ce groupe. insertAnimation() sera appelé avec un index égal à animationCount().

Remarque : le groupe prend possession de l'animation.

Voir aussi removeAnimation().

QAbstractAnimation * QAnimationGroup::animationAt ( int index ) const

Retourne un pointeur sur l'animation du groupe qui se trouve à index. Cette fonction est utile quand vous devez accéder à une animation spécifique. index est entre 0 et animationCount() - 1.

Voir aussi animationCount() et indexOfAnimation().

int QAnimationGroup::animationCount () const

Retourne le nombre d'animations gérées par le groupe.

Voir aussi indexOfAnimation(), addAnimation(), et animationAt().

void QAnimationGroup::clear ()

Retire et supprime toutes les animations de ce groupe d'animations et réinitialise le temps courant à 0.

Voir aussi addAnimation() et removeAnimation().

bool QAnimationGroup::event ( QEvent * event ) [virtual protected]

Réimplémentation de QObject::event().

int QAnimationGroup::indexOfAnimation ( QAbstractAnimation * animation ) const

Retourne l'indice de animation. L'indice retourné peut être transmis aux autres fonctions qui prennent un indice comme argument.

Voir aussi insertAnimation(), animationAt(), et takeAnimation().

void QAnimationGroup::insertAnimation ( int index, QAbstractAnimation * animation )

Ajoute animation dans le groupe d'animations à index. Si index est 0, l'animation est insérée au début. Si index est animationCount(), l'animation est insérée à la fin.

Remarque : le groupe prend possession de l'animation.

Voir aussi takeAnimation(), addAnimation(), indexOfAnimation(), et removeAnimation().

void QAnimationGroup::removeAnimation ( QAbstractAnimation * animation )

Retire animation de ce groupe. La possession de animation est transférée à l'appelant.

Voir aussi takeAnimation(), insertAnimation(), et addAnimation().

QAbstractAnimation * QAnimationGroup::takeAnimation ( int index )

Retourne l'animation qui se trouve à index et la retire du groupe d'animation.

Remarque : la possession de l'animation est transférée à l'appelant.

Voir aussi removeAnimation(), addAnimation(), insertAnimation(), et indexOfAnimation().

Remerciements

Merci à Jonathan Courtois pour la traduction et à Thibaut Cuvelier ainsi qu'à Jacques Thery pour leur relecture !