CAnimationVariable osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Animációs változót jelöl.

Szemantika

class CAnimationVariable;

Tagok

Nyilvános konstruktorok

Név	Description
CAnimationVariable::CAnimationVariable	Animációs változó objektumot hoz létre.
CAnimationVariable::~CAnimationVariable	A destruktor. Akkor hívják, amikor egy CAnimationVariable objektumot megsemmisítenek.

Nyilvános metódusok

Név	Description
CAnimationVariable::AddTransition	Áttűnést ad hozzá.
CAnimationVariable::ApplyTransitions	Áttűnéseket ad hozzá a belső listáról a storyboardra.
CAnimationVariable::ClearTransitions	Törli az áttűnéseket.
CAnimationVariable::Létrehozás	Létrehozza a mögöttes animációs változó COM-objektumát.
CAnimationVariable::CreateTransitions	Létrehozza az animációs változóra alkalmazni kívánt összes áttűnést.
CAnimationVariable::EnableIntegerValueChangedEvent	Engedélyezi vagy letiltja az IntegerValueChanged eseményt.
CAnimationVariable::EnableValueChangedEvent	Engedélyezi vagy letiltja a ValueChanged eseményt.
CAnimationVariable::GetDefaultValue	Az alapértelmezett értéket adja vissza.
CAnimationVariable::GetParentAnimationObject	A szülőanimációs objektumot adja vissza.
CAnimationVariable::GetValue	Túlterhelt. Az animációs változó aktuális értékét adja vissza.
CAnimationVariable::GetVariable	Az IUIAnimationVariable COM objektumra mutató mutatót ad vissza.
CAnimationVariable::SetDefaultValue	Beállítja az alapértelmezett értéket, és kiadja az IUIAnimationVariable COM-objektumot.

Védett metódusok

Név	Description
CAnimationVariable::SetParentAnimationObject	Egy animációs változó és egy animációs objektum közötti kapcsolatot állítja be.

Nyilvános adatok tagjai

Név	Description
CAnimationVariable::m_bAutodestroyTransitions	Megadja, hogy a kapcsolódó áttűnési objektumokat törölni kell-e.

Védett adattagok

Név	Description
CAnimationVariable::m_dblDefaultValue	Megadja az alapértelmezett értéket, amelyet a rendszer az IUIAnimationVariable fájlba propagál.
CAnimationVariable::m_lstTransitions	Az animációs változót animáló áttűnések listáját tartalmazza.
CAnimationVariable::m_pParentObject	Egy animációs objektumra mutató mutató, amely beágyazza ezt az animációs változót.
CAnimationVariable::m_variable	Az IUIAnimationVariable COM objektumra mutató mutatót tárol. NULL érték, ha a COM-objektum még nem lett létrehozva, vagy ha a létrehozás meghiúsult.

Megjegyzések

A CAnimationVariable osztály beágyazza az IUIAnimationVariable COM objektumot. Emellett a forgatókönyv animációs változójára alkalmazandó áttűnések listáját is tartalmazza. A CAnimationVariable objektumok animációs objektumokba vannak beágyazva, amelyek egy alkalmazásban animált értéket, pontot, méretet, színt és téglalapot jelölhetnek.

Öröklési hierarchia

CAnimationVariable

Requirements

Fejléc: afxanimationcontroller.h

CAnimationVariable::~CAnimationVariable

A destruktor. Akkor hívják, amikor egy CAnimationVariable objektumot megsemmisítenek.

virtual ~CAnimationVariable();

CAnimationVariable::AddTransition

Áttűnést ad hozzá.

void AddTransition(CBaseTransition* pTransition);

Paraméterek

pTransition
A hozzáadni kívánt áttűnés mutatója.

Megjegyzések

Ennek a metódusnak az a neve, hogy áttűnést ad hozzá az animációs változóra alkalmazandó áttűnések belső listájához. Ezt a listát törölni kell egy animáció ütemezésekor.

CAnimationVariable::ApplyTransitions

Áttűnéseket ad hozzá a belső listáról a storyboardra.

void ApplyTransitions(
    CAnimationController* pController,
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDependOnKeyframes);

Paraméterek

pController
Mutató a szülőanimációs vezérlőhöz.

pStoryboard
Mutató a storyboardhoz.

bDependOnKeyframes
IGAZ, ha ennek a metódusnak kulcskerettől függő áttűnéseket kell hozzáadnia.

Megjegyzések

Ez a metódus áttűnést ad a belső listáról a storyboardra. A legfelső szintű kódból többször is meghívják, hogy olyan áttűnéseket adjon hozzá, amelyek nem függnek a kulcskeretektől, és olyan áttűnéseket adnak hozzá, amelyek a kulcskeretektől függenek. Ha a mögöttes animációs változó COM-objektuma nem lett létrehozva, ez a metódus ebben a szakaszban hozza létre.

CAnimationVariable::CAnimationVariable

Animációs változó objektumot hoz létre.

CAnimationVariable(DOUBLE dblDefaultValue = 0.0);

Paraméterek

dblDefaultValue
Az alapértelmezett értéket adja meg.

Megjegyzések

Létrehoz egy animációs változó objektumot, és beállítja az alapértelmezett értékét. Az alapértelmezett érték akkor használatos, ha egy változó nincs animálva, vagy nem lehet animálni.

CAnimationVariable::ClearTransitions

Törli az áttűnéseket.

void ClearTransitions(BOOL bAutodestroy);

Paraméterek

bAutodestroy
Megadja, hogy a metódusnak törölnie kell-e az áttűnési objektumokat.

Megjegyzések

Ez a módszer eltávolítja az összes áttűnést az áttűnések belső listájából. Ha a bAutodestroy IGAZ, vagy m_bAutodestroyTransitions IGAZ, akkor az áttűnések törlődnek. Ellenkező esetben a hívónak fel kell szabadítania az áttűnési objektumokat.

CAnimationVariable::Létrehozás

Létrehozza a mögöttes animációs változó COM-objektumát.

virtual BOOL Create(IUIAnimationManager* pManager);

Paraméterek

pManager
Egy egérmutató az animációkezelőhöz.

Visszaadott érték

IGAZ, ha az animációs változó sikeresen létrejött; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus létrehozza a mögöttes animációs változó COM-objektumát, és beállítja annak alapértelmezett értékét.

CAnimationVariable::CreateTransitions

Létrehozza az animációs változóra alkalmazni kívánt összes áttűnést.

BOOL CreateTransitions(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* \*not used*\);

Paraméterek

pLibrary
Mutató egy IUIAnimationTransitionLibrary felületre, amely szabványos áttűnések kódtárát határozza meg.

Visszaadott érték

IGAZ, ha az áttűnések sikeresen létrejöttek; egyéb esetben HAMIS.

Megjegyzések

Ezt a metódust a keretrendszer hívja meg, amikor áttűnést kell létrehoznia, amelyeket hozzáadtak a változó belső áttűnések listájához.

CAnimationVariable::EnableIntegerValueChangedEvent

Engedélyezi vagy letiltja az IntegerValueChanged eseményt.

void EnableIntegerValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Paraméterek

pController
Mutató a szülővezérlőhöz.

bEnable
IGAZ – esemény engedélyezése, HAMIS – esemény letiltása.

Megjegyzések

Ha a ValueChanged esemény engedélyezve van, a keretrendszer meghívja a CAnimationController virtuális metódust::OnAnimationIntegerValueChanged. Az esemény feldolgozásához felül kell bírálnia a CAnimationControllerből származó osztályban. Ezt a metódust minden alkalommal meghívjuk, amikor az animációs változó egész értéke megváltozik.

CAnimationVariable::EnableValueChangedEvent

Engedélyezi vagy letiltja a ValueChanged eseményt.

void EnableValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Paraméterek

pController
Mutató a szülővezérlőhöz.

bEnable
IGAZ – esemény engedélyezése, HAMIS – esemény letiltása.

Megjegyzések

Ha a ValueChanged esemény engedélyezve van, a keretrendszer meghívja a CAnimationController virtuális metódust::OnAnimationValueChanged. Az esemény feldolgozásához felül kell bírálnia a CAnimationControllerből származó osztályban. Ezt a metódust minden alkalommal meghívjuk, amikor az animációs változó értéke megváltozik.

CAnimationVariable::GetDefaultValue

Az alapértelmezett értéket adja vissza.

DOUBLE GetDefaultValue() const;

Visszaadott érték

Az alapértelmezett érték.

Megjegyzések

Ezzel a függvénnyel szerezheti be az animációs változó alapértelmezett értékét. Az alapértelmezett érték konstruktorban vagy SetDefaultValue metódussal állítható be.

CAnimationVariable::GetParentAnimationObject

A szülőanimációs objektumot adja vissza.

CAnimationBaseObject* GetParentAnimationObject();

Visszaadott érték

A szülőanimációs objektumra mutató mutató, ha a kapcsolat létrejött, ellenkező esetben NULL.

Megjegyzések

Ez a metódus meghívható egy szülőanimációs objektumhoz (tárolóhoz) mutató lekéréséhez.

CAnimationVariable::GetValue

Az animációs változó aktuális értékét adja vissza.

HRESULT GetValue(DOUBLE& dblValue);
HRESULT GetValue(INT32& nValue);

Paraméterek

dblValue
Az animációs változó aktuális értéke.

nValue
Az animációs változó aktuális értéke.

Visszaadott érték

S_OK, hogy az érték sikeres volt-e, vagy a mögöttes animációs változó nem lett létrehozva. Ellenkező esetben HRESULT hibakód.

Megjegyzések

Ez a metódus meghívható az animációs változó aktuális értékének lekéréséhez. Ha a mögöttes COM-objektum nem lett létrehozva, a dblValue egy alapértelmezett értéket fog tartalmazni, amikor a függvény visszatér.

CAnimationVariable::GetVariable

Az IUIAnimationVariable COM objektumra mutató mutatót ad vissza.

IUIAnimationVariable* GetVariable();

Visszaadott érték

Érvényes mutató az IUIAnimationVariable COM-objektumra vagy NULL értékre, ha az animációs változó nem jött létre, vagy nem hozható létre.

Megjegyzések

Ezzel a függvénnyel elérheti a mögöttes IUIAnimationVariable COM objektumot, és szükség esetén közvetlenül meghívhatja a metódusait.

CAnimationVariable::m_bAutodestroyTransitions

Megadja, hogy a kapcsolódó áttűnési objektumokat törölni kell-e.

BOOL m_bAutodestroyTransitions;

Megjegyzések

Ha igaz értékre állítja ezt az értéket, kényszerítheti az áttűnési objektumok törlését az áttűnések belső listájából való eltávolításakor. Ha ez az érték HAMIS, az áttűnéseket az alkalmazás meghívásával kell törölni. Az áttűnések listája mindig törlődik az animáció ütemezése után. Az alapértelmezett érték HAMIS.

CAnimationVariable::m_dblDefaultValue

Megadja az alapértelmezett értéket, amelyet a rendszer az IUIAnimationVariable fájlba propagál.

DOUBLE m_dblDefaultValue;

CAnimationVariable::m_lstTransitions

Az animációs változót animáló áttűnések listáját tartalmazza.

CObList m_lstTransitions;

CAnimationVariable::m_pParentObject

Egy animációs objektumra mutató mutató, amely beágyazza ezt az animációs változót.

CAnimationBaseObject* m_pParentObject;

CAnimationVariable::m_variable

Az IUIAnimationVariable COM objektumra mutató mutatót tárol. NULL érték, ha a COM-objektum még nem lett létrehozva, vagy ha a létrehozás meghiúsult.

ATL::CComPtr<IUIAnimationVariable> m_variable;

CAnimationVariable::SetDefaultValue

Beállítja az alapértelmezett értéket, és kiadja az IUIAnimationVariable COM-objektumot.

void SetDefaultValue(DOUBLE dblDefaultValue);

Paraméterek

dblDefaultValue
Az új alapértelmezett értéket adja meg.

Megjegyzések

Ezzel a módszerrel alaphelyzetbe állíthatja az alapértelmezett értéket. Ez a metódus felszabadítja a belső IUIAnimationVariable COM objektumot, ezért az animációs változó újbóli létrehozásakor a mögöttes COM-objektum megkapja az új alapértelmezett értéket. Az alapértelmezett értéket a GetValue adja vissza, ha az animációs változót képviselő COM-objektum nem jön létre, vagy ha a változó nem lett animálva.

CAnimationVariable::SetParentAnimationObject

Egy animációs változó és egy animációs objektum közötti kapcsolatot állítja be.

void SetParentAnimationObject(CAnimationBaseObject* pParentObject);

Paraméterek

pParentObject
A változót tartalmazó animációs objektumra mutató mutató.

Megjegyzések

Ezt a metódust belsőleg nevezzük egy-az-egyhez kapcsolat létrehozásához egy animációs változó és egy animációs objektum között, amely magában foglalja azt.

Lásd még

osztályok