CAnimationVariable-Klasse

Stellt eine Animationsvariable dar.

Syntax

class CAnimationVariable;

Member

Öffentliche Konstruktoren

Name	Beschreibung
CAnimationVariable::CAnimationVariable	Erstellt ein Animationsvariablenobjekt.
CAnimationVariable::~CAnimationVariable	Der Destruktor. Wird aufgerufen, wenn ein CAnimationVariable-Objekt zerstört wird.

Öffentliche Methoden

Name	Beschreibung
CAnimationVariable::AddTransition	Fügt einen Übergang hinzu.
CAnimationVariable::ApplyTransitions	Fügt Übergänge aus der internen Liste zum Storyboard hinzu.
CAnimationVariable::ClearTransitions	Löscht Übergänge.
CAnimationVariable::Create	Erstellt das zugrunde liegende Com-Objekt der Animationsvariable.
CAnimationVariable::CreateTransitions	Erstellt alle Übergänge, die auf diese Animationsvariable angewendet werden sollen.
CAnimationVariable::EnableIntegerValueChangedEvent	Aktiviert oder deaktiviert das IntegerValueChanged-Ereignis.
CAnimationVariable::EnableValueChangedEvent	Aktiviert oder deaktiviert das ValueChanged-Ereignis.
CAnimationVariable::GetDefaultValue	Gibt den Standardwert zurück.
CAnimationVariable::GetParentAnimationObject	Gibt das übergeordnete Animationsobjekt zurück.
CAnimationVariable::GetValue	Überladen. Gibt den aktuellen Wert der Animationsvariablen zurück.
CAnimationVariable::GetVariable	Gibt einen Zeiger auf das IUIAnimationVariable COM -Objekt zurück.
CAnimationVariable::SetDefaultValue	Legt den Standardwert fest und gibt das IUIAnimationVariable COM-Objekt frei.

Geschützte Methoden

Name	Beschreibung
CAnimationVariable::SetParentAnimationObject	Legt die Beziehung zwischen einer Animationsvariable und einem Animationsobjekt fest.

Öffentliche Datenmember

Name	Beschreibung
CAnimationVariable::m_bAutodestroyTransitions	Gibt an, ob verwandte Übergangsobjekte gelöscht werden sollen.

Geschützte Datenmember

Name	Beschreibung
CAnimationVariable::m_dblDefaultValue	Gibt den Standardwert an, der an IUIAnimationVariable weitergegeben wird.
CAnimationVariable::m_lstTransitions	Enthält eine Liste der Übergänge, die diese Animationsvariable animieren.
CAnimationVariable::m_pParentObject	Ein Zeiger auf ein Animationsobjekt, das diese Animationsvariable kapselt.
CAnimationVariable::m_variable	Speichert einen Zeiger auf das IUIAnimationVariable COM-Objekt. NULL, wenn das COM-Objekt noch nicht erstellt wurde oder wenn die Erstellung fehlgeschlagen ist.

Hinweise

Die CAnimationVariable-Klasse kapselt das IUIAnimationVariable COM-Objekt. Außerdem enthält sie eine Liste der Übergänge, die auf die Animationsvariable in einem Storyboard angewendet werden sollen. CAnimationVariable-Objekte sind in Animationsobjekte eingebettet, die in einer Anwendung einen animierten Wert, einen Punkt, eine Größe, eine Farbe und ein Rechteck darstellen können.

Vererbungshierarchie

CAnimationVariable

Anforderungen

Header: afxanimationcontroller.h

CAnimationVariable::~CAnimationVariable

Der Destruktor. Wird aufgerufen, wenn ein CAnimationVariable-Objekt zerstört wird.

virtual ~CAnimationVariable();

CAnimationVariable::AddTransition

Fügt einen Übergang hinzu.

void AddTransition(CBaseTransition* pTransition);

Parameter

pTransition
Ein Zeiger auf einen hinzuzufügenden Übergang.

Hinweise

Diese Methode wird aufgerufen, um einen Übergang zur internen Liste der Übergänge hinzuzufügen, die auf die Animationsvariable angewendet werden sollen. Diese Liste sollte gelöscht werden, wenn eine Animation geplant wurde.

CAnimationVariable::ApplyTransitions

Fügt Übergänge aus der internen Liste zum Storyboard hinzu.

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

Parameter

pController
Ein Zeiger auf den übergeordneten Animationscontroller.

pStoryboard
Ein Zeiger auf das Storyboard.

bDependOnKeyframes
TRUE, wenn diese Methode Übergänge hinzufügen soll, die von Keyframes abhängig sind.

Hinweise

Diese Methode fügt Übergänge aus der internen Liste zum Storyboard hinzu. Der Code der obersten Ebene wird mehrmals aufgerufen, um Übergänge hinzuzufügen, die nicht von Keyframes abhängen, und Übergänge hinzufügen, die von Keyframes abhängig sind. Wenn die zugrunde liegende Animationsvariable COM-Objekt nicht erstellt wurde, erstellt diese Methode sie in dieser Phase.

CAnimationVariable::CAnimationVariable

Erstellt ein Animationsvariablenobjekt.

CAnimationVariable(DOUBLE dblDefaultValue = 0.0);

Parameter

dblDefaultValue
Gibt den Standardwert an.

Hinweise

Erstellt ein Animationsvariablenobjekt und legt seinen Standardwert fest. Ein Standardwert wird verwendet, wenn eine Variable nicht animiert wird oder nicht animiert werden kann.

CAnimationVariable::ClearTransitions

Löscht Übergänge.

void ClearTransitions(BOOL bAutodestroy);

Parameter

bAutodestroy
Gibt an, ob diese Methode Übergangsobjekte löschen soll.

Hinweise

Mit dieser Methode werden alle Übergänge aus der internen Liste der Übergänge entfernt. Wenn bAutodestroy WAHR ist oder m_bAutodestroyTransitions WAHR ist, werden Übergänge gelöscht. Andernfalls sollte der Aufrufer die Übergangsobjekte umstellen.

CAnimationVariable::Create

Erstellt das zugrunde liegende Com-Objekt der Animationsvariable.

virtual BOOL Create(IUIAnimationManager* pManager);

Parameter

pManager
Ein Zeiger auf animations-Manager.

Rückgabewert

TRUE, wenn die Animationsvariable erfolgreich erstellt wurde; andernfalls FALSE.

Hinweise

Diese Methode erstellt die zugrunde liegende Animationsvariable COM-Objekt und legt den Standardwert fest.

CAnimationVariable::CreateTransitions

Erstellt alle Übergänge, die auf diese Animationsvariable angewendet werden sollen.

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

Parameter

pLibrary
Ein Zeiger auf eine IUIAnimationTransitionLibrary-Schnittstelle, die eine Bibliothek mit Standardübergängen definiert.

Rückgabewert

TRUE, wenn Übergänge erfolgreich erstellt wurden; andernfalls FALSE.

Hinweise

Diese Methode wird vom Framework aufgerufen, wenn Sie Übergänge erstellen müssen, die der internen Liste der Übergänge der Variablen hinzugefügt wurden.

CAnimationVariable::EnableIntegerValueChangedEvent

Aktiviert oder deaktiviert das IntegerValueChanged-Ereignis.

void EnableIntegerValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parameter

pController
Ein Zeiger auf den übergeordneten Controller.

bEnable
TRUE - Enable event, FALSE - disable event.

Hinweise

Wenn valueChanged-Ereignis aktiviert ist, ruft das Framework die virtuelle Methode CAnimationController::OnAnimationIntegerValueChanged auf. Sie müssen sie in einer von CAnimationController abgeleiteten Klasse überschreiben, um dieses Ereignis zu verarbeiten. Diese Methode wird jedes Mal aufgerufen, wenn der ganzzahlige Wert der Animationsvariable geändert wird.

CAnimationVariable::EnableValueChangedEvent

Aktiviert oder deaktiviert das ValueChanged-Ereignis.

void EnableValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parameter

pController
Ein Zeiger auf den übergeordneten Controller.

bEnable
TRUE - Enable event, FALSE - disable event.

Hinweise

Wenn das ValueChanged-Ereignis aktiviert ist, ruft das Framework die virtuelle Methode CAnimationController::OnAnimationValueChanged auf. Sie müssen sie in einer von CAnimationController abgeleiteten Klasse überschreiben, um dieses Ereignis zu verarbeiten. Diese Methode wird jedes Mal aufgerufen, wenn der Wert der Animationsvariable geändert wird.

CAnimationVariable::GetDefaultValue

Gibt den Standardwert zurück.

DOUBLE GetDefaultValue() const;

Rückgabewert

Der Standardwert.

Hinweise

Verwenden Sie diese Funktion, um den Standardwert der Animationsvariable zu erhalten. Der Standardwert kann im Konstruktor oder von der SetDefaultValue-Methode festgelegt werden.

CAnimationVariable::GetParentAnimationObject

Gibt das übergeordnete Animationsobjekt zurück.

CAnimationBaseObject* GetParentAnimationObject();

Rückgabewert

Ein Zeiger auf das übergeordnete Animationsobjekt, wenn eine Beziehung hergestellt wurde, andernfalls NULL.

Hinweise

Diese Methode kann aufgerufen werden, um einen Zeiger auf ein übergeordnetes Animationsobjekt (ein Container) abzurufen.

CAnimationVariable::GetValue

Gibt den aktuellen Wert der Animationsvariablen zurück.

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

Parameter

dblValue
Der aktuelle Wert der Animationsvariable.

nValue
Der aktuelle Wert der Animationsvariable.

Rückgabewert

S_OK, wenn der Wert erfolgreich abgerufen wurde oder die zugrunde liegende Animationsvariable nicht erstellt wurde. Andernfalls HRESULT-Fehlercode.

Hinweise

Diese Methode kann aufgerufen werden, um den aktuellen Wert der Animationsvariable abzurufen. Wenn das zugrunde liegende COM-Objekt nicht erstellt wurde, enthält dblValue einen Standardwert, wenn die Funktion zurückgegeben wird.

CAnimationVariable::GetVariable

Gibt einen Zeiger auf das IUIAnimationVariable COM -Objekt zurück.

IUIAnimationVariable* GetVariable();

Rückgabewert

Ein gültiger Zeiger auf das IUIAnimationVariable COM-Objekt oder NULL, wenn keine Animationsvariable erstellt wurde oder nicht erstellt werden kann.

Hinweise

Verwenden Sie diese Funktion, um auf das zugrunde liegende IUIAnimationVariable COM-Objekt zuzugreifen und die Methoden direkt bei Bedarf aufzurufen.

CAnimationVariable::m_bAutodestroyTransitions

Gibt an, ob verwandte Übergangsobjekte gelöscht werden sollen.

BOOL m_bAutodestroyTransitions;

Hinweise

Legen Sie diesen Wert auf TRUE fest, um das Löschen von Übergangsobjekten zu erzwingen, wenn sie aus der internen Liste der Übergänge entfernt werden. Wenn dieser Wert FALSE ist, sollten die Übergänge durch Aufrufen der Anwendung gelöscht werden. Die Liste der Übergänge wird immer gelöscht, nachdem eine Animation geplant wurde. Der Standardwert ist FALSE.

CAnimationVariable::m_dblDefaultValue

Gibt den Standardwert an, der an IUIAnimationVariable weitergegeben wird.

DOUBLE m_dblDefaultValue;

CAnimationVariable::m_lstTransitions

Enthält eine Liste der Übergänge, die diese Animationsvariable animieren.

CObList m_lstTransitions;

CAnimationVariable::m_pParentObject

Ein Zeiger auf ein Animationsobjekt, das diese Animationsvariable kapselt.

CAnimationBaseObject* m_pParentObject;

CAnimationVariable::m_variable

Speichert einen Zeiger auf das IUIAnimationVariable COM-Objekt. NULL, wenn das COM-Objekt noch nicht erstellt wurde oder wenn die Erstellung fehlgeschlagen ist.

ATL::CComPtr<IUIAnimationVariable> m_variable;

CAnimationVariable::SetDefaultValue

Legt den Standardwert fest und gibt das IUIAnimationVariable COM-Objekt frei.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parameter

dblDefaultValue
Gibt den neuen Standardwert an.

Hinweise

Verwenden Sie diese Methode, um den Standardwert zurückzusetzen. Diese Methode gibt das interne IUIAnimationVariable COM-Objekt frei. Wenn die Animationsvariable neu erstellt wird, ruft das zugrunde liegende COM-Objekt den neuen Standardwert ab. Der Standardwert wird von GetValue zurückgegeben, wenn das COM-Objekt, das die Animationsvariable darstellt, nicht erstellt wird oder die Variable nicht animiert wurde.

CAnimationVariable::SetParentAnimationObject

Legt die Beziehung zwischen einer Animationsvariable und einem Animationsobjekt fest.

void SetParentAnimationObject(CAnimationBaseObject* pParentObject);

Parameter

pParentObject
Ein Zeiger auf ein Animationsobjekt, das diese Variable enthält.

Hinweise

Diese Methode wird intern aufgerufen, um eine 1:1-Beziehung zwischen einer Animationsvariable und einem Animationsobjekt herzustellen, das sie kapselt.

Siehe auch

Klassen