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