CAnimationValue-Klasse

Implementiert die Funktion eines Animationsobjekts, das über einen Wert verfügt.

Syntax

class CAnimationValue : public CAnimationBaseObject;

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Öffentliche Operatoren

Geschützte Datenmember

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

CObject

CAnimationBaseObject

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.

Siehe auch

Klassen