QAnimationGroup Class
La classe QAnimationGroup est une classe de base abstraite pour les groupes d'animations. Plus d'informations...
| En-tête : | #include <QAnimationGroup> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Hérite : | QAbstractAnimation |
| Héritée par : |
- Liste de tous les membres, y compris les membres hérités
- QAnimationGroup fait partie de Animation Framework.
Fonctions publiques
| QAnimationGroup(QObject *parent = nullptr) | |
| virtual | ~QAnimationGroup() |
| void | addAnimation(QAbstractAnimation *animation) |
| QAbstractAnimation * | animationAt(int index) const |
| int | animationCount() const |
| void | clear() |
| int | indexOfAnimation(QAbstractAnimation *animation) const |
| void | insertAnimation(int index, QAbstractAnimation *animation) |
| void | removeAnimation(QAbstractAnimation *animation) |
| QAbstractAnimation * | takeAnimation(int index) |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *event) override |
Description détaillée
Un groupe d'animation est un conteneur d'animations (sous-classes de QAbstractAnimation). Un groupe est généralement responsable de la gestion de state de ses animations, c'est-à-dire qu'il décide quand les démarrer, les arrêter, les reprendre et les mettre en pause. Actuellement, Qt XML fournit deux groupes de ce type : QParallelAnimationGroup et QSequentialAnimationGroup. Consultez les descriptions de leurs classes pour plus de détails.
Puisque QAnimationGroup hérite de QAbstractAnimation, vous pouvez combiner des groupes et construire facilement des graphiques d'animation complexes. Vous pouvez demander à QAbstractAnimation le groupe auquel il appartient (à l'aide de la fonction group()).
Pour lancer un groupe d'animation de premier niveau, il suffit d'utiliser la fonction start() de QAbstractAnimation. Par groupe d'animation de premier niveau, nous entendons un groupe qui n'est pas contenu dans un autre groupe. Le démarrage direct de sous-groupes n'est pas pris en charge et peut entraîner un comportement inattendu.
QAnimationGroup fournit des méthodes pour ajouter et récupérer des animations. En outre, vous pouvez supprimer des animations en appelant removeAnimation(), et effacer le groupe d'animation en appelant clear(). Vous pouvez suivre les modifications apportées aux animations du groupe en écoutant les événements QEvent::ChildAdded et QEvent::ChildRemoved.
QAnimationGroup est propriétaire des animations qu'il gère et s'assure qu'elles sont supprimées lorsque le groupe d'animation est supprimé.
Voir également QAbstractAnimation, QVariantAnimation, et The Animation Framework.
Documentation des fonctions membres
QAnimationGroup::QAnimationGroup(QObject *parent = nullptr)
Construit un QAnimationGroup. parent est transmis au constructeur de QObject.
[virtual noexcept] QAnimationGroup::~QAnimationGroup()
Détruit le groupe d'animation. Il détruit également toutes ses animations.
void QAnimationGroup::addAnimation(QAbstractAnimation *animation)
Ajoute animation à ce groupe. Ceci appellera insertAnimation avec un index égal à animationCount().
Remarque : le groupe est propriétaire de l'animation.
Voir aussi removeAnimation().
QAbstractAnimation *QAnimationGroup::animationAt(int index) const
Renvoie un pointeur sur l'animation située à index dans ce groupe. Cette fonction est utile lorsque vous devez accéder à une animation particulière. index est compris entre 0 et animationCount() - 1.
Voir aussi animationCount() et indexOfAnimation().
int QAnimationGroup::animationCount() const
Renvoie le nombre d'animations gérées par ce groupe.
Voir aussi indexOfAnimation(), addAnimation() et animationAt().
void QAnimationGroup::clear()
Supprime toutes les animations de ce groupe d'animation et remet le temps actuel à 0.
Voir aussi addAnimation() et removeAnimation().
[override virtual protected] bool QAnimationGroup::event(QEvent *event)
Réimplémente : QAbstractAnimation::event(QEvent *event).
int QAnimationGroup::indexOfAnimation(QAbstractAnimation *animation) const
Renvoie l'index de animation. L'index renvoyé peut être transmis aux autres fonctions qui prennent un index comme argument.
Voir aussi insertAnimation(), animationAt() et takeAnimation().
void QAnimationGroup::insertAnimation(int index, QAbstractAnimation *animation)
Insère animation dans ce groupe d'animation à 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 est propriétaire de l'animation.
Voir aussi takeAnimation(), addAnimation(), indexOfAnimation() et removeAnimation().
void QAnimationGroup::removeAnimation(QAbstractAnimation *animation)
Supprime animation de ce groupe. La propriété de animation est transférée à l'appelant.
Voir également takeAnimation(), insertAnimation() et addAnimation().
QAbstractAnimation *QAnimationGroup::takeAnimation(int index)
Renvoie l'animation à index et la retire du groupe d'animation.
Remarque : la propriété de l'animation est transférée à l'appelant.
Voir aussi removeAnimation(), addAnimation(), insertAnimation() et indexOfAnimation().
© 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.
