CAnimationGroup, classe

Implémente un groupe d’animations, qui combine un storyboard d’animation, des objets d’animation et des transitions pour définir une animation.

Syntaxe

class CAnimationGroup;

Membres

Constructeurs publics

Nom	Description
CAnimationGroup ::CAnimationGroup	Construit un groupe d’animations.
CAnimationGroup ::~CAnimationGroup	Destructeur. Appelé lorsqu’un groupe d’animations est détruit.

Méthodes publiques

Nom	Description
CAnimationGroup ::Animate	Anime un groupe.
CAnimationGroup ::ApplyTransitions	Applique des transitions aux objets d’animation.
CAnimationGroup ::FindAnimationObject	Recherche un objet d’animation qui contient la variable d’animation spécifiée.
CAnimationGroup ::GetGroupID	Retourne GroupID.
CAnimationGroup ::RemoveKeyframes	Supprime et détruit éventuellement tous les images clés appartenant à un groupe d’animations.
CAnimationGroup ::RemoveTransitions	Supprime les transitions des objets d’animation appartenant à un groupe d’animations.
CAnimationGroup ::Schedule	Planifie une animation à l’heure spécifiée.
CAnimationGroup ::SetAutodestroyTransitions	Dirige tous les objets d’animation qui appartiennent au groupe détruisent automatiquement les transitions.

Méthodes protégées

Nom	Description
CAnimationGroup ::AddKeyframes	Assistance qui ajoute des images clés à un storyboard.
CAnimationGroup ::AddTransitions	Assistance qui ajoute des transitions vers un storyboard.
CAnimationGroup ::CreateTransitions	Assistance qui crée des objets de transition COM.

Membres de données publics

Nom	Description
CAnimationGroup ::m_bAutoclearTransitions	Spécifie comment effacer les transitions des objets d’animation qui appartiennent au groupe. Si ce membre a la valeur TRUE, les transitions sont supprimées automatiquement lorsqu’une animation a été planifiée. Sinon, vous devez supprimer manuellement les transitions.
CAnimationGroup ::m_bAutodestroyAnimationObjects	Spécifie comment détruire des objets d’animation. Si ce paramètre est TRUE, les objets d’animation sont détruits automatiquement lorsque le groupe est détruit. Sinon, les objets d’animation doivent être détruits manuellement. La valeur par défaut est FALSE. Définissez cette valeur sur TRUE uniquement si tous les objets d’animation appartenant au groupe sont alloués dynamiquement avec l’opérateur nouveau.
CAnimationGroup ::m_bAutodestroyKeyframes	Spécifie comment détruire des images clés. Si cette valeur est TRUE, toutes les images clés sont supprimées et détruites ; sinon, ils sont supprimés de la liste uniquement. La valeur par défaut est TRUE.
CAnimationGroup ::m_lstAnimationObjects	Contient une liste d’objets d’animation.
CAnimationGroup ::m_lstKeyFrames	Contient une liste d’images clés.
CAnimationGroup ::m_pStoryboard	Pointe vers le storyboard d’animation. Ce pointeur est valide uniquement après l’appel sur Animate.

Membres de données protégés

Nom	Description
CAnimationGroup ::m_nGroupID	Identificateur unique du groupe d’animations.
CAnimationGroup ::m_pParentController	Pointeur vers le contrôleur d’animation auquel appartient ce groupe.

Notes

Les groupes d’animations sont créés automatiquement par le contrôleur d’animation (CAnimationController) lorsque vous ajoutez des objets d’animation à l’aide de CAnimationController ::AddAnimationObject. Un groupe d’animations est identifié par GroupID, qui est généralement pris comme paramètre pour manipuler des groupes d’animations. GroupID est extrait du premier objet d’animation ajouté à un nouveau groupe d’animations. Un storyboard d’animation encapsulé est créé après avoir appelé CAnimationController ::AnimateGroup et est accessible via le membre public m_pStoryboard.

Hiérarchie d'héritage

CAnimationGroup

Spécifications

En-tête : afxanimationcontroller.h

CAnimationGroup ::~CAnimationGroup

Destructeur. Appelé lorsqu’un groupe d’animations est détruit.

~CAnimationGroup();

CAnimationGroup ::AddKeyframes

Assistance qui ajoute des images clés à un storyboard.

void AddKeyframes(IUIAnimationStoryboard* pStoryboard, BOOL bAddDeep);

Paramètres

pStoryboard
Pointeur vers un objet COM storyboard.

bAddDeep
Spécifie si cette méthode doit ajouter aux images clés storyboard qui dépendent d’autres images clés.

CAnimationGroup ::AddTransitions

Assistance qui ajoute des transitions vers un storyboard.

void AddTransitions(
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDependOnKeyframes);

Paramètres

pStoryboard
Pointeur vers un objet COM storyboard.

bDependOnKeyframes

CAnimationGroup ::Animate

Anime un groupe.

BOOL Animate(
    IUIAnimationManager* pManager,
    IUIAnimationTimer* pTimer,
    BOOL bScheduleNow);

Paramètres

pManager
pTimerbScheduleNow

Valeur de retour

TRUE si la méthode réussit ; sinon FALSE.

Notes

Cette méthode crée un storyboard interne, crée et applique des transitions et planifie une animation si bScheduleNow a la valeur TRUE. Si bScheduleNow a la valeur FALSE, vous devez appeler Schedule pour démarrer l’animation à l’heure spécifiée.

CAnimationGroup ::ApplyTransitions

Applique des transitions aux objets d’animation.

void ApplyTransitions();

Notes

Cette méthode ASSERTS en mode débogage si le storyboard n’a pas été créé. Il crée d’abord toutes les transitions, puis ajoute des images clés « statiques » (images clés qui dépendent des décalages), ajoute des transitions qui ne dépendent pas des images clés, ajoute des images clés en fonction des transitions et d’autres images clés, et ajoute enfin des transitions qui dépendent des images clés.

CAnimationGroup ::CAnimationGroup

Construit un groupe d’animations.

CAnimationGroup(CAnimationController* pParentController, UINT32 nGroupID);

Paramètres

pParentController
Pointeur vers le contrôleur d’animation qui crée un groupe.

nGroupID
Spécifie GroupID.

CAnimationGroup ::CreateTransitions

Assistance qui crée des objets de transition COM.

BOOL CreateTransitions();

Valeur de retour

TRUE est la méthode qui réussit, sinon FALSE.

CAnimationGroup ::FindAnimationObject

Recherche un objet d’animation qui contient la variable d’animation spécifiée.

CAnimationBaseObject* FindAnimationObject(IUIAnimationVariable* pVariable);

Paramètres

pVariable
Pointeur vers une variable d’animation.

Valeur de retour

Pointeur vers un objet d’animation ou NULL si l’objet d’animation est introuvable.

CAnimationGroup ::GetGroupID

Retourne GroupID.

UINT32 GetGroupID() const;

Valeur de retour

Identificateur de groupe.

CAnimationGroup ::m_bAutoclearTransitions

Spécifie comment effacer les transitions des objets d’animation qui appartiennent au groupe. Si ce membre a la valeur TRUE, les transitions sont supprimées automatiquement lorsqu’une animation a été planifiée. Sinon, vous devez supprimer manuellement les transitions.

BOOL m_bAutoclearTransitions;

CAnimationGroup ::m_bAutodestroyAnimationObjects

Spécifie comment détruire des objets d’animation. Si ce paramètre est TRUE, les objets d’animation sont détruits automatiquement lorsque le groupe est détruit. Sinon, les objets d’animation doivent être détruits manuellement. La valeur par défaut est FALSE. Définissez cette valeur sur TRUE uniquement si tous les objets d’animation appartenant au groupe sont alloués dynamiquement avec l’opérateur nouveau.

BOOL m_bAutodestroyAnimationObjects;

CAnimationGroup ::m_bAutodestroyKeyframes

Spécifie comment détruire des images clés. Si cette valeur est TRUE, toutes les images clés sont supprimées et détruites ; sinon, ils sont supprimés de la liste uniquement. La valeur par défaut est TRUE.

BOOL m_bAutodestroyKeyframes;

CAnimationGroup ::m_lstAnimationObjects

Contient une liste d’objets d’animation.

CObList m_lstAnimationObjects;

CAnimationGroup ::m_lstKeyFrames

Contient une liste d’images clés.

CObList m_lstKeyFrames;

CAnimationGroup ::m_nGroupID

Identificateur unique du groupe d’animations.

UINT32 m_nGroupID;

CAnimationGroup ::m_pParentController

Pointeur vers le contrôleur d’animation auquel appartient ce groupe.

CAnimationController* m_pParentController;

CAnimationGroup ::m_pStoryboard

Pointe vers le storyboard d’animation. Ce pointeur est valide uniquement après l’appel sur Animate.

ATL::CComPtr<IUIAnimationStoryboard> m_pStoryboard;

CAnimationGroup ::RemoveKeyframes

Supprime et détruit éventuellement tous les images clés appartenant à un groupe d’animations.

void RemoveKeyframes();

Notes

Si m_bAutodestroyKeyframes membre a la valeur TRUE, les images clés sont supprimées et détruites ; sinon, les images clés sont simplement supprimées de la liste interne des images clés.

CAnimationGroup ::RemoveTransitions

Supprime les transitions des objets d’animation appartenant à un groupe d’animations.

void RemoveTransitions();

Notes

Si m_bAutoclearTransitions indicateur a la valeur TRUE, cette méthode effectue une boucle sur tous les objets d’animation qui appartiennent au groupe et appelle CAnimationObject ::ClearTransitions(FALSE).

CAnimationGroup ::Schedule

Planifie une animation à l’heure spécifiée.

BOOL Schedule(IUIAnimationTimer* pTimer, UI_ANIMATION_SECONDS time);

Paramètres

pTimer
Pointeur vers le minuteur d’animation.

time
Spécifie le temps nécessaire pour planifier l’animation.

Valeur de retour

TRUE si la méthode réussit ; FALSE si la méthode échoue ou si Animate n’a pas été appelé avec bScheduleNow défini sur FALSE.

Notes

Appelez cette fonction pour planifier une animation à l’heure spécifiée. Vous devez d’abord appeler Animate avec bScheduleNow défini sur FALSE.

CAnimationGroup ::SetAutodestroyTransitions

Dirige tous les objets d’animation qui appartiennent au groupe détruisent automatiquement les transitions.

void SetAutodestroyTransitions(BOOL bAutoDestroy = TRUE);

Paramètres

bAutoDestroy
Spécifie comment détruire les transitions.

Notes

Définissez cette valeur sur FALSE uniquement si vous allouez des transitions sur la pile. La valeur par défaut est TRUE. Il est donc vivement recommandé d’allouer des objets de transition à l’aide de l’opérateur nouveau.

Voir aussi

Classes