CAnimationValue 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.

Egy értékkel rendelkező animációs objektum funkcióit valósítja meg.

Szemantika

class CAnimationValue : public CAnimationBaseObject;

Tagok

Nyilvános konstruktorok

Név	Description
CAnimationValue::CAnimationValue	Túlterhelt. CAnimationValue objektumot hoz létre.

Nyilvános metódusok

Név	Description
CAnimationValue::AddTransition	Egy értékre alkalmazandó áttűnést ad hozzá.
CAnimationValue::GetValue	Túlterhelt. Lekéri az aktuális értéket.
CAnimationValue::GetVariable	Hozzáférést biztosít a beágyazott animációs változóhoz.
CAnimationValue::SetDefaultValue	Alapértelmezett érték beállítása.

Védett metódusok

Név	Description
CAnimationValue::GetAnimationVariableList	A beágyazott animációs változót egy listába helyezi. (Felülbírálások CAnimationBaseObject::GetAnimationVariableList.)

Nyilvános operátorok

Név	Description
CAnimationValue::operátor DOUBLE	A CAnimationValue és a DOUBLE közötti konverziót biztosítja.
CAnimationValue::operátor INT32	A CAnimationValue és az INT32 közötti konverziót biztosítja.
CAnimationValue::operator=	Túlterhelt. INT32-értéket rendel a CAnimationValue-hoz.

Védett adattagok

Név	Description
CAnimationValue::m_value	A beágyazott animációs változó, amely az animáció értékét jelöli.

Megjegyzések

A CAnimationValue osztály egyetlen CAnimationVariable objektumot foglal magában, és egyetlen animált értéket képviselhet az alkalmazásokban. Ezt az osztályt használhatja például animált áttetszőséghez (elhalványulási effektushoz), szöghez (objektumok elforgatásához), vagy bármilyen más esetben, ha egyetlen animált értéktől függően animációt kell létrehoznia. Ha ezt az osztályt az alkalmazásban szeretné használni, csak példányosíthatja az osztály egy objektumát, adja hozzá az animációvezérlőhöz a CAnimationController::AddAnimationObject paranccsal, és hívja meg az AddTransition parancsot minden egyes áttűnéshez, amelyet az értékre kell alkalmazni.

Öröklési hierarchia

CObject

CAnimationBaseObject

CAnimationValue

Requirements

Fejléc: afxanimationcontroller.h

CAnimationValue::AddTransition

Egy értékre alkalmazandó áttűnést ad hozzá.

void AddTransition(CBaseTransition* pTransition);

Paraméterek

pTransition
Az áttűnési objektumra mutató mutató.

Megjegyzések

Hívja meg ezt a függvényt, ha áttűnést szeretne hozzáadni az animációs változóra alkalmazni kívánt áttűnések belső listájához. Áttűnések hozzáadásakor a rendszer nem alkalmazza őket azonnal, és egy belső listában tárolja őket. A CAnimationController::AnimateGroup hívásakor az áttűnéseket a rendszer alkalmazza (hozzáadja egy adott értékhez tartozó storyboardhoz).

CAnimationValue::CAnimationValue

CAnimationValue objektumot hoz létre.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Paraméterek

dblDefaultValue
Alapértelmezett értéket ad meg.

nGroupID
Megadja a csoportazonosítót.

nObjectID
Objektumazonosítót ad meg.

dwUserData
felhasználó által definiált adatokat határoz meg.

Megjegyzések

A CAnimationValue objektumot alapértelmezett tulajdonságokkal hozza létre: az alapértelmezett érték, a csoportazonosító és az objektumazonosító értéke 0.

CAnimationValue::GetAnimationVariableList

A beágyazott animációs változót egy listába helyezi.

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

Paraméterek

Lst
Amikor a függvény visszatér, az animált értéket képviselő CAnimationVariable mutatót tartalmaz.

CAnimationValue::GetValue

Lekéri az aktuális értéket.

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

Paraméterek

dblValue
Kimeneti. Amikor a függvény visszaadja, az animációs változó aktuális értékét tartalmazza.

nValue
Kimeneti. Amikor a függvény visszaadja, az animációs változó aktuális értékét tartalmazza.

Visszaadott érték

IGAZ, ha az aktuális érték lekérése sikeresen megtörtént; egyéb esetben HAMIS.

Megjegyzések

Hívja meg ezt a függvényt az aktuális érték lekéréséhez. Ez a implementáció meghívja a beágyazott COM-objektumot, és ha a hívás meghiúsul, ez a metódus a korábban konstruktorban vagy a SetDefaultValue-ban beállított alapértelmezett értéket adja vissza.

CAnimationValue::GetVariable

Hozzáférést biztosít a beágyazott animációs változóhoz.

CAnimationVariable& GetVariable();

Visszaadott érték

A beágyazott animációs változóra mutató hivatkozás.

Megjegyzések

Ezzel a módszerrel érheti el a beágyazott animációs változót. A CAnimationVariable-ben hozzáférést kap az alapul szolgáló IUIAnimationVariable objektumhoz, amelynek mutatója NULL értékű lehet, ha az animációs változó nem lett létrehozva.

CAnimationValue::m_value

A beágyazott animációs változó, amely az animáció értékét jelöli.

CAnimationVariable m_value;

CAnimationValue::operátor DOUBLE

A CAnimationValue és a DOUBLE közötti konverziót biztosítja.

operator DOUBLE();

Visszaadott érték

Az animációs érték aktuális értéke.

Megjegyzések

A CAnimationValue és a DOUBLE közötti konverziót biztosítja. Ez a metódus belsőleg meghívja a GetValue-t, és nem ellenőrzi a hibákat. Ha a GetValue sikertelen, a visszaadott érték egy korábban konstruktorban vagy SetDefaultValue-ban beállított alapértelmezett értéket tartalmaz.

CAnimationValue::operátor INT32

A CAnimationValue és az INT32 közötti konverziót biztosítja.

operator INT32();

Visszaadott érték

Az Animáció értékének aktuális értéke egész számként.

Megjegyzések

A CAnimationValue és az INT32 közötti konverziót biztosítja. Ez a metódus belsőleg meghívja a GetValue-t, és nem ellenőrzi a hibákat. Ha a GetValue sikertelen, a visszaadott érték egy korábban konstruktorban vagy SetDefaultValue-ban beállított alapértelmezett értéket tartalmaz.

CAnimationValue::operator=

DUPLA értéket rendel a CAnimationValue-hoz.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

Paraméterek

dblVal
Megadja az animációs értékhez rendelendő értéket.

nVal
Megadja az animációs értékhez rendelendő értéket.

Megjegyzések

DUPLA értéket rendel a CAnimationValue-hoz. Ez az érték a beágyazott animációs változó alapértelmezett értékeként van beállítva. Ha előfizetett erre az animációs objektumra eseményekre (ValueChanged vagy IntegerValueChanged), újra engedélyeznie kell ezeket az eseményeket.

CAnimationValue::SetDefaultValue

Alapértelmezett érték beállítása.

void SetDefaultValue(DOUBLE dblDefaultValue);

Paraméterek

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

Megjegyzések

Ezzel a módszerrel állíthat be alapértelmezett értéket. Az alapértelmezett érték akkor lesz visszaadva az alkalmazásnak, ha az animáció nem indult el, és/vagy az alapul szolgáló COM-objektum nem lett létrehozva. Ha a CAnimationVarible-ben beágyazott mögöttes COM-objektum már létrejött, ez a metódus újra létrehozza azt, ezért előfordulhat, hogy újra meg kell hívnia az EnableValueChanged/EnableIntegerValueChanged metódusokat.

Lásd még

osztályok