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.