CAnimationValue-Klasse
Implementiert die Funktion eines Animationsobjekts, das über einen Wert verfügt.
Syntax
class CAnimationValue : public CAnimationBaseObject;
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CAnimationValue::CAnimationValue | Überladen. Erstellt ein CAnimationValue -Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CAnimationValue::AddTransition | Fügt einen Übergang hinzu, der auf einen Wert angewendet werden soll. |
| CAnimationValue::GetValue | Überladen. Ruft den aktuellen Wert ab. |
| CAnimationValue::GetVariable | Bietet Zugriff auf gekapselte Animationsvariablen. |
| CAnimationValue::SetDefaultValue | Legt den Standardwert fest. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CAnimationValue::GetAnimationVariableList | Fügt die gekapselte Animationsvariable in eine Liste ein. (Außerkraftsetzungen CAnimationBaseObject::GetAnimationVariableList.) |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
| CAnimationValue::operator DOUBLE | Stellt konvertierung zwischen CAnimationValue und DOUBLE bereit. |
| CAnimationValue::operator INT32 | Stellt konvertierung zwischen CAnimationValue und INT32 bereit. |
| CAnimationValue::operator= | Überladen. Weist CAnimationValue einen INT32-Wert zu. |
Geschützte Datenmember
| Name | Beschreibung |
|---|---|
| CAnimationValue::m_value | Die gekapselte Animationsvariable, die den Animationswert darstellt. |
Hinweise
Die CAnimationValue-Klasse kapselt ein einzelnes CAnimationVariable -Objekt und kann in Anwendungen einen einzelnen animierten Wert darstellen. Sie können diese Klasse beispielsweise für animierte Transparenz (Einblendungseffekt), Winkel (zum Drehen von Objekten) oder für jeden anderen Fall verwenden, wenn Sie eine Animation je nach einem einzelnen animierten Wert erstellen müssen. Um diese Klasse in der Anwendung zu verwenden, instanziieren Sie einfach ein Objekt dieser Klasse, fügen Sie sie mithilfe von CAnimationController::AddAnimationObject hinzu, und rufen Sie AddTransition für jeden Übergang auf den Wert auf.
Vererbungshierarchie
CAnimationValue
Anforderungen
Header: afxanimationcontroller.h
CAnimationValue::AddTransition
Fügt einen Übergang hinzu, der auf einen Wert angewendet werden soll.
void AddTransition(CBaseTransition* pTransition);
Parameter
pTransition
Ein Zeiger zum Übergangsobjekt.
Hinweise
Rufen Sie diese Funktion auf, um einen Übergang zur internen Liste der Übergänge hinzuzufügen, die auf eine Animationsvariable angewendet werden sollen. Wenn Sie Übergänge hinzufügen, werden sie nicht sofort angewendet und in einer internen Liste gespeichert. Übergänge werden angewendet (einem Storyboard für einen bestimmten Wert hinzugefügt), wenn Sie CAnimationController::AnimateGroup aufrufen.
CAnimationValue::CAnimationValue
Erstellt ein CAnimationValue -Objekt.
CAnimationValue();
CAnimationValue(
DOUBLE dblDefaultValue,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parameter
dblDefaultValue
Gibt den Standardwert an.
nGroupID
Gibt die Gruppen-ID an.
nObjectID
Gibt die Objekt-ID an.
dwUserData
Gibt benutzerdefinierte Daten an.
Hinweise
Erstellt ein CAnimationValue-Objekt mit Standardeigenschaften: Standardwert, Gruppen-ID und Objekt-ID werden auf 0 festgelegt.
CAnimationValue::GetAnimationVariableList
Fügt die gekapselte Animationsvariable in eine Liste ein.
virtual void GetAnimationVariableList(
CList<CAnimationVariable*,
CAnimationVariable*>& lst);
Parameter
Lst
Wenn die Funktion zurückgegeben wird, enthält sie einen Zeiger auf CAnimationVariable, der den animierten Wert darstellt.
CAnimationValue::GetValue
Ruft den aktuellen Wert ab.
BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);
Parameter
dblValue
Ausgabe Wenn die Funktion zurückgibt, enthält sie einen aktuellen Wert der Animationsvariable.
nValue
Ausgabe Wenn die Funktion zurückgibt, enthält sie einen aktuellen Wert der Animationsvariable.
Rückgabewert
TRUE, wenn der aktuelle Wert erfolgreich abgerufen wurde; andernfalls FALSE.
Hinweise
Rufen Sie diese Funktion auf, um den aktuellen Wert abzurufen. Diese Implementierung ruft das gekapselte COM-Objekt auf, und wenn der Aufruf fehlschlägt, gibt diese Methode den Standardwert zurück, der zuvor im Konstruktor oder mit SetDefaultValue festgelegt wurde.
CAnimationValue::GetVariable
Bietet Zugriff auf gekapselte Animationsvariablen.
CAnimationVariable& GetVariable();
Rückgabewert
Ein Verweis auf die gekapselte Animationsvariable.
Hinweise
Verwenden Sie diese Methode, um auf die gekapselte Animationsvariable zuzugreifen. Von CAnimationVariable erhalten Sie Zugriff auf das zugrunde liegende IUIAnimationVariable-Objekt, dessen Zeiger NULL sein kann, wenn keine Animationsvariable erstellt wurde.
CAnimationValue::m_value
Die gekapselte Animationsvariable, die den Animationswert darstellt.
CAnimationVariable m_value;
CAnimationValue::operator DOUBLE
Stellt konvertierung zwischen CAnimationValue und DOUBLE bereit.
operator DOUBLE();
Rückgabewert
Aktueller Wert des Animationswerts.
Hinweise
Stellt konvertierung zwischen CAnimationValue und DOUBLE bereit. Diese Methode ruft Intern GetValue auf und sucht nicht auf Fehler. Wenn "GetValue" fehlschlägt, enthält der zurückgegebene Wert einen Standardwert, der zuvor im Konstruktor oder mit SetDefaultValue festgelegt wurde.
CAnimationValue::operator INT32
Stellt konvertierung zwischen CAnimationValue und INT32 bereit.
operator INT32();
Rückgabewert
Aktueller Wert des Animationswerts als ganze Zahl.
Hinweise
Stellt konvertierung zwischen CAnimationValue und INT32 bereit. Diese Methode ruft Intern GetValue auf und sucht nicht auf Fehler. Wenn "GetValue" fehlschlägt, enthält der zurückgegebene Wert einen Standardwert, der zuvor im Konstruktor oder mit SetDefaultValue festgelegt wurde.
CAnimationValue::operator=
Weist CAnimationValue einen DOUBLE-Wert zu.
void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);
Parameter
dblVal
Gibt den Wert an, der dem Animationswert zugewiesen werden soll.
nVal
Gibt den Wert an, der dem Animationswert zugewiesen werden soll.
Hinweise
Weist CAnimationValue einen DOUBLE-Wert zu. Dieser Wert wird als Standardwert für die gekapselte Animationsvariable festgelegt. Wenn Sie dieses Animationsobjekt für Ereignisse abonniert haben (ValueChanged oder IntegerValueChanged), müssen Sie diese Ereignisse erneut aktivieren.
CAnimationValue::SetDefaultValue
Legt den Standardwert fest.
void SetDefaultValue(DOUBLE dblDefaultValue);
Parameter
dblDefaultValue
Gibt den Standardwert an.
Hinweise
Verwenden Sie diese Methode, um einen Standardwert festzulegen. Ein Standardwert wird an die Anwendung zurückgegeben, wenn die Animation nicht gestartet wurde und/oder das zugrunde liegende COM-Objekt nicht erstellt wurde. Wenn das zugrunde liegende COM-Objekt, das in CAnimationVarible gekapselt wurde, bereits erstellt wurde, erstellt diese Methode sie erneut, daher müssen Sie möglicherweise enableValueChanged/EnableIntegerValueChanged-Methoden erneut aufrufen.