CAnimationValue – třída
Implementuje funkce animačního objektu, který má jednu hodnotu.
Syntaxe
class CAnimationValue : public CAnimationBaseObject;
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CAnimationValue::CAnimationValue | Přetíženo. Vytvoří objekt CAnimationValue. |
Veřejné metody
| Název | Popis |
|---|---|
| CAnimationValue::AddTransition | Přidá přechod, který se použije k hodnotě. |
| CAnimationValue::GetValue | Přetíženo. Načte aktuální hodnotu. |
| CAnimationValue::GetVariable | Poskytuje přístup k zapouzdřené animační proměnné. |
| CAnimationValue::SetDefaultValue | Nastaví výchozí hodnotu. |
Chráněné metody
| Název | Popis |
|---|---|
| CAnimationValue::GetAnimationVariableList | Vloží zapouzdřenou animační proměnnou do seznamu. (Přepsání CAnimationBaseObject::GetAnimationVariableList.) |
Veřejné operátory
| Název | Popis |
|---|---|
| CAnimationValue::operator DOUBLE | Poskytuje převod mezi CAnimationValue a DOUBLE. |
| CAnimationValue::operator INT32 | Poskytuje převod mezi CAnimationValue a INT32. |
| CAnimationValue::operator= | Přetíženo. Přiřadí hodnotu INT32 CAnimationValue. |
Chráněné datové členy
| Název | Popis |
|---|---|
| CAnimationValue::m_value | Zapouzdřená animační proměnná, která představuje animační hodnotu. |
Poznámky
CAnimationValue třída zapouzdřuje jeden CAnimationVariable objekt a může představovat v aplikacích jednu animovanou hodnotu. Tuto třídu můžete použít například pro animované průhlednosti (efekt prolnutí), úhel (otočení objektů) nebo pro případ, kdy potřebujete vytvořit animaci v závislosti na jedné animované hodnotě. Chcete-li použít tuto třídu v aplikaci, stačí vytvořit instanci objektu této třídy, přidat jej do kontroleru animace pomocí CAnimationController::AddAnimationObject a volat AddTransition pro každý přechod, který se má použít na hodnotu.
Hierarchie dědičnosti
CAnimationValue
Požadavky
Hlavička: afxanimationcontroller.h
CAnimationValue::AddTransition
Přidá přechod, který se použije k hodnotě.
void AddTransition(CBaseTransition* pTransition);
Parametry
PTransition
Ukazatel na objekt přechodu.
Poznámky
Voláním této funkce přidáte přechod do interního seznamu přechodů, které se použijí na animační proměnnou. Když přidáte přechody, nepoužijí se okamžitě a uloží se do interního seznamu. Přechody se použijí (při volání CAnimationController::AnimateGroup do scénáře pro konkrétní hodnotu).
CAnimationValue::CAnimationValue
Vytvoří objekt CAnimationValue.
CAnimationValue();
CAnimationValue(
DOUBLE dblDefaultValue,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parametry
dblDefaultValue
Určuje výchozí hodnotu.
nGroupID
Určuje ID skupiny.
nObjectID
Určuje ID objektu.
dwUserData
určuje uživatelem definovaná data.
Poznámky
Konstrukty CAnimationValue objekt s výchozími vlastnostmi: výchozí hodnota, ID skupiny a ID objektu jsou nastaveny na 0.
CAnimationValue::GetAnimationVariableList
Vloží zapouzdřenou animační proměnnou do seznamu.
virtual void GetAnimationVariableList(
CList<CAnimationVariable*,
CAnimationVariable*>& lst);
Parametry
Lst
Když funkce vrátí, obsahuje ukazatel na CAnimationVariable představující animovanou hodnotu.
CAnimationValue::GetValue
Načte aktuální hodnotu.
BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);
Parametry
dblValue
Výstup. Když funkce vrátí, obsahuje aktuální hodnotu proměnné animace.
nValue
Výstup. Když funkce vrátí, obsahuje aktuální hodnotu proměnné animace.
Návratová hodnota
TRUE, pokud byla aktuální hodnota úspěšně načtena; jinak NEPRAVDA.
Poznámky
Voláním této funkce načtěte aktuální hodnotu. Tato implementace volá zapouzdřený objekt COM a pokud volání selže, tato metoda vrátí výchozí hodnotu, která byla dříve nastavena v konstruktoru nebo s SetDefaultValue.
CAnimationValue::GetVariable
Poskytuje přístup k zapouzdřené animační proměnné.
CAnimationVariable& GetVariable();
Návratová hodnota
Odkaz na zapouzdřenou animační proměnnou.
Poznámky
Tuto metodu použijte pro přístup k zapouzdřené animační proměnné. Z CAnimationVariable získáte přístup k podkladovému IUIAnimationVariable objektu, jehož ukazatel může být NULL, pokud nebyla vytvořena animační proměnná.
CAnimationValue::m_value
Zapouzdřená animační proměnná, která představuje animační hodnotu.
CAnimationVariable m_value;
CAnimationValue::operator DOUBLE
Poskytuje převod mezi CAnimationValue a DOUBLE.
operator DOUBLE();
Návratová hodnota
Aktuální hodnota animační hodnoty
Poznámky
Poskytuje převod mezi CAnimationValue a DOUBLE. Tato metoda interně volá GetValue a nekontroluje chyby. Pokud getValue selže, vrácená hodnota bude obsahovat výchozí hodnotu dříve nastavenou v konstruktoru nebo s SetDefaultValue.
CAnimationValue::operator INT32
Poskytuje převod mezi CAnimationValue a INT32.
operator INT32();
Návratová hodnota
Aktuální hodnota animační hodnoty jako celé číslo
Poznámky
Poskytuje převod mezi CAnimationValue a INT32. Tato metoda interně volá GetValue a nekontroluje chyby. Pokud getValue selže, vrácená hodnota bude obsahovat výchozí hodnotu dříve nastavenou v konstruktoru nebo s SetDefaultValue.
CAnimationValue::operator=
Přiřadí hodnotu DOUBLE CAnimationValue.
void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);
Parametry
dblVal
Určuje hodnotu, která se má přiřadit k animační hodnotě.
nVal
Určuje hodnotu, která se má přiřadit k animační hodnotě.
Poznámky
Přiřadí hodnotu DOUBLE CAnimationValue. Tato hodnota je nastavena jako výchozí hodnota pro zapouzdřenou animační proměnnou. Pokud jste tento animační objekt přihlásili k odběru událostí (ValueChanged nebo IntegerValueChanged), musíte tyto události znovu povolit.
CAnimationValue::SetDefaultValue
Nastaví výchozí hodnotu.
void SetDefaultValue(DOUBLE dblDefaultValue);
Parametry
dblDefaultValue
Určuje výchozí hodnotu.
Poznámky
Tuto metodu použijte k nastavení výchozí hodnoty. Výchozí hodnota se vrátí do aplikace, pokud nebyla spuštěna animace nebo nebyl vytvořen podkladový objekt MODELU COM. Pokud byl již vytvořen základní objekt COM zapouzdřený v CAnimationVarible, tato metoda jej znovu vytvoří, proto může být nutné volat EnableValueChanged/EnableIntegerValueChanged metody znovu.