CAnimationGroup – třída

Implementuje skupinu animací, která kombinuje scénáře animací, objekty animací a přechody k definování animace.

Syntaxe

class CAnimationGroup;

Členové

Veřejné konstruktory

Jméno	popis
CAnimationGroup::CAnimationGroup	Vytvoří skupinu animací.
CAnimationGroup::~CAnimationGroup	Destruktor. Volá se při zničení skupiny animací.

Veřejné metody

Jméno	popis
CAnimationGroup::Animate	Animuje skupinu.
CAnimationGroup::ApplyTransitions	Použije přechody na objekty animace.
CAnimationGroup::FindAnimationObject	Vyhledá animační objekt, který obsahuje zadanou animační proměnnou.
CAnimationGroup::GetGroupID	Vrátí ID skupiny.
CAnimationGroup::RemoveKeyframes	Odebere a volitelně zničí všechny klíčové rámce, které patří do skupiny animací.
CAnimationGroup::RemoveTransitions	Odebere přechody z animačních objektů, které patří do skupiny animací.
CAnimationGroup::Schedule	Naplánuje animaci v zadaném čase.
CAnimationGroup::SetAutodestroyTransitions	Směruje všechny objekty animace, které patří do skupiny, automaticky zničí přechody.

Chráněné metody

Jméno	popis
CAnimationGroup::AddKeyframes	Pomocná rutina, která do scénáře přidá klíčové rámce.
CAnimationGroup::AddTransitions	Pomocná rutina, která přidá přechody do scénáře
CAnimationGroup::CreateTransitions	Pomocná rutina, která vytvoří přechodové objekty modelu COM.

Veřejné datové členy

Jméno	popis
CAnimationGroup::m_bAutoclearTransitions	Určuje, jak vymazat přechody z animačních objektů, které patří do skupiny. Pokud má tento člen hodnotu TRUE, přechody se automaticky odeberou, když je naplánovaná animace. Jinak je potřeba přechody odebrat ručně.
CAnimationGroup::m_bAutodestroyAnimationObjects	Určuje, jak zničit animační objekty. Pokud je tento parametr TRUE, objekty animace budou při zničení skupiny automaticky zničeny. Jinak musí být objekty animace zničeny ručně. Výchozí hodnota je FALSE. Tuto hodnotu nastavte na hodnotu TRUE pouze v případě, že všechny objekty animace, které patří do skupiny, jsou dynamicky přiděleny operátorem novým operátorem.
CAnimationGroup::m_bAutodestroyKeyframes	Určuje, jak zničit klíčové rámce. Pokud je tato hodnota PRAVDA, všechny klíčové rámce jsou odebrány a zničeny; jinak se odeberou jenom ze seznamu. Výchozí hodnota je PRAVDA.
CAnimationGroup::m_lstAnimationObjects	Obsahuje seznam animačních objektů.
CAnimationGroup::m_lstKeyFrames	Obsahuje seznam klíčových rámců.
CAnimationGroup::m_pStoryboard	Odkazuje na animační scénář. Tento ukazatel je platný až po volání aplikace Animate.

Chráněné datové členy

Jméno	popis
CAnimationGroup::m_nGroupID	Jedinečný identifikátor skupiny animací.
CAnimationGroup::m_pParentController	Ukazatel na kontroler animace, do které tato skupina patří.

Poznámky

Skupiny animací se vytvářejí automaticky kontrolerem animace (CAnimationController) při přidávání animačních objektů pomocí CAnimationController::AddAnimationObject. Skupinu animací identifikuje GroupID, která se obvykle používá jako parametr pro manipulaci se skupinami animací. ID skupiny se přebírá z prvního objektu animace, který se přidá do nové skupiny animací. Zapouzdřená animační storyboard se vytvoří po volání CAnimationController::AnimateGroup a lze k němu přistupovat prostřednictvím veřejného člena m_pStoryboard.

Hierarchie dědičnosti

CAnimationGroup

Požadavky

Hlavička: afxanimationcontroller.h

CAnimationGroup::~CAnimationGroup

Destruktor. Volá se při zničení skupiny animací.

~CAnimationGroup();

CAnimationGroup::AddKeyframes

Pomocná rutina, která do scénáře přidá klíčové rámce.

void AddKeyframes(IUIAnimationStoryboard* pStoryboard, BOOL bAddDeep);

Parametry

pStoryboard
Ukazatel na objekt MODELU COM scénáře.

bAddDeep
Určuje, zda má tato metoda přidat do klíčových rámců scénáře, které závisí na jiných klíčových rámcích.

CAnimationGroup::AddTransitions

Pomocná rutina, která přidá přechody do scénáře

void AddTransitions(
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDependOnKeyframes);

Parametry

pStoryboard
Ukazatel na objekt MODELU COM scénáře.

bDependOnKeyframes

CAnimationGroup::Animate

Animuje skupinu.

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

Parametry

pManager
pTimerbScheduleNow

Vrácená hodnota

TRUE, pokud metoda uspěje; jinak NEPRAVDA.

Poznámky

Tato metoda vytvoří interní scénář, vytvoří a použije přechody a naplánuje animaci, pokud bScheduleNow je TRUE. Pokud bScheduleNow je NEPRAVDA, musíte zavolat Plán, který spustí animaci v zadaném čase.

CAnimationGroup::ApplyTransitions

Použije přechody na objekty animace.

void ApplyTransitions();

Poznámky

Tato metoda ASSERTS v režimu ladění, pokud scénář nebyl vytvořen. Nejprve vytvoří všechny přechody, pak přidá "statické" klíčové rámce (klíčové rámce, které závisí na posunech), přidá přechody, které nezávisí na klíčových rámcích, přidá klíčové rámce v závislosti na přechodech a dalších klíčových rámcích a nakonec přidá přechody, které závisí na klíčových rámcích.

CAnimationGroup::CAnimationGroup

Vytvoří skupinu animací.

CAnimationGroup(CAnimationController* pParentController, UINT32 nGroupID);

Parametry

pParentController
Ukazatel na animační kontroler, který vytvoří skupinu.

nGroupID
Určuje ID skupiny.

CAnimationGroup::CreateTransitions

Pomocná rutina, která vytvoří přechodové objekty modelu COM.

BOOL CreateTransitions();

Vrácená hodnota

PRAVDA je metoda úspěšná, jinak NEPRAVDA.

CAnimationGroup::FindAnimationObject

Vyhledá animační objekt, který obsahuje zadanou animační proměnnou.

CAnimationBaseObject* FindAnimationObject(IUIAnimationVariable* pVariable);

Parametry

pVariable
Ukazatel na animační proměnnou.

Vrácená hodnota

Ukazatel na animační objekt nebo NULL, pokud nebyl nalezen animační objekt.

CAnimationGroup::GetGroupID

Vrátí ID skupiny.

UINT32 GetGroupID() const;

Vrácená hodnota

Identifikátor skupiny.

CAnimationGroup::m_bAutoclearTransitions

Určuje, jak vymazat přechody z animačních objektů, které patří do skupiny. Pokud má tento člen hodnotu TRUE, přechody se automaticky odeberou, když je naplánovaná animace. Jinak je potřeba přechody odebrat ručně.

BOOL m_bAutoclearTransitions;

CAnimationGroup::m_bAutodestroyAnimationObjects

Určuje, jak zničit animační objekty. Pokud je tento parametr TRUE, objekty animace budou při zničení skupiny automaticky zničeny. Jinak musí být objekty animace zničeny ručně. Výchozí hodnota je FALSE. Tuto hodnotu nastavte na hodnotu TRUE pouze v případě, že všechny objekty animace, které patří do skupiny, jsou dynamicky přiděleny operátorem novým operátorem.

BOOL m_bAutodestroyAnimationObjects;

CAnimationGroup::m_bAutodestroyKeyframes

Určuje, jak zničit klíčové rámce. Pokud je tato hodnota PRAVDA, všechny klíčové rámce jsou odebrány a zničeny; jinak se odeberou jenom ze seznamu. Výchozí hodnota je PRAVDA.

BOOL m_bAutodestroyKeyframes;

CAnimationGroup::m_lstAnimationObjects

Obsahuje seznam animačních objektů.

CObList m_lstAnimationObjects;

CAnimationGroup::m_lstKeyFrames

Obsahuje seznam klíčových rámců.

CObList m_lstKeyFrames;

CAnimationGroup::m_nGroupID

Jedinečný identifikátor skupiny animací.

UINT32 m_nGroupID;

CAnimationGroup::m_pParentController

Ukazatel na kontroler animace, do které tato skupina patří.

CAnimationController* m_pParentController;

CAnimationGroup::m_pStoryboard

Odkazuje na animační scénář. Tento ukazatel je platný až po volání aplikace Animate.

ATL::CComPtr<IUIAnimationStoryboard> m_pStoryboard;

CAnimationGroup::RemoveKeyframes

Odebere a volitelně zničí všechny klíčové rámce, které patří do skupiny animací.

void RemoveKeyframes();

Poznámky

Pokud je m_bAutodestroyKeyframes člen TRUE, klíčové rámce se odeberou a zničí, jinak se klíčové rámce odeberou jenom z interního seznamu klíčových rámců.

CAnimationGroup::RemoveTransitions

Odebere přechody z animačních objektů, které patří do skupiny animací.

void RemoveTransitions();

Poznámky

Pokud je příznak m_bAutoclearTransitions nastaven na HODNOTU TRUE, tato metoda smyčka nad všemi animačními objekty, které patří do skupiny, a volá CAnimationObject::ClearTransitions(FALSE).

CAnimationGroup::Schedule

Naplánuje animaci v zadaném čase.

BOOL Schedule(IUIAnimationTimer* pTimer, UI_ANIMATION_SECONDS time);

Parametry

pTimer
Ukazatel na časovač animace.

Čas
Určuje čas naplánování animace.

Vrácená hodnota

TRUE, pokud metoda uspěje; NEPRAVDA, pokud metoda selže nebo pokud aplikace Animate nebyla volána pomocí bScheduleNow nastavena na FALSE.

Poznámky

Voláním této funkce naplánujete animaci v určený čas. Nejdřív musíte volat Animate s bScheduleNow nastaveným na FALSE.

CAnimationGroup::SetAutodestroyTransitions

Směruje všechny objekty animace, které patří do skupiny, automaticky zničí přechody.

void SetAutodestroyTransitions(BOOL bAutoDestroy = TRUE);

Parametry

bAutoDestroy
Určuje, jak zničit přechody.

Poznámky

Tuto hodnotu nastavte na FALSE pouze v případě, že přidělíte přechody v zásobníku. Výchozí hodnota je TRUE, proto důrazně doporučujeme přidělit přechodové objekty pomocí operátoru new.

Viz také

Třídy