CAnimationValue Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CAnimationValue Class.
Implements the functionality of animation object that has one value.
Syntax
class CAnimationValue : public CAnimationBaseObject;
Members
Public Constructors
| Name | Description |
|---|---|
| CAnimationValue::CAnimationValue | Overloaded. Constructs a CAnimationValue object. |
Public Methods
| Name | Description |
|---|---|
| CAnimationValue::AddTransition | Adds a transition to be applied to a value. |
| CAnimationValue::GetValue | Overloaded. Retrieves the current value. |
| CAnimationValue::GetVariable | Provides access to encapsulated animation variable. |
| CAnimationValue::SetDefaultValue | Sets default value. |
Protected Methods
| Name | Description |
|---|---|
| CAnimationValue::GetAnimationVariableList | Puts the encapsulated animation variable into a list. (Overrides CAnimationBaseObject::GetAnimationVariableList.) |
Public Operators
| Name | Description |
|---|---|
| CAnimationValue::operator DOUBLE | Provides conversion between CAnimationValue and DOUBLE. |
| CAnimationValue::operator INT32 | Provides conversion between CAnimationValue and INT32. |
| CAnimationValue::operator= | Overloaded. Assigns an INT32 value to CAnimationValue. |
Protected Data Members
| Name | Description |
|---|---|
| CAnimationValue::m_value | The encapsulated animation variable that represents animation value. |
Remarks
The CAnimationValue class encapsulates a single CAnimationVariable object and can represent in applications a single animated value. For example, you can use this class for animated transparency (fade effect), angle (to rotate objects), or for any other case when you need to create an animation depending on a single animated value. To use this class in application, just instantiate an object of this class, add it to animation controller using CAnimationController::AddAnimationObject and call AddTransition for each transition to be applied to the value.
Inheritance Hierarchy
Requirements
Header: afxanimationcontroller.h
CAnimationValue::AddTransition
Adds a transition to be applied to a value.
void AddTransition(CBaseTransition* pTransition);
Parameters
pTransition
A pointer to transition object.
Remarks
Call this function to add a transition to internal list of transitions to be applied to an animation variable. When you add transitions, they are not applied immediately and stored in an internal list. Transitions are applied (added to a storyboard for a particular value) when you call CAnimationController::AnimateGroup.
CAnimationValue::CAnimationValue
Constructs a CAnimationValue object.
CAnimationValue();
CAnimationValue(
DOUBLE dblDefaultValue,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parameters
dblDefaultValue
Specifies default value.
nGroupID
Specifies Group ID.
nObjectID
Specifies Object ID.
dwUserData
specifies user-defined data.
Remarks
Constructs CAnimationValue object with default properties: default value, Group ID and Object ID are set to 0.
CAnimationValue::GetAnimationVariableList
Puts the encapsulated animation variable into a list.
virtual void GetAnimationVariableList(CList<CAnimationVariable*, CAnimationVariable*>& lst);
Parameters
lst
When the function returns, it contains a pointer to CAnimationVariable representing the animated value.
CAnimationValue::GetValue
Retrieves the current value.
BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);
Parameters
dblValue
Output. When the function returns it contains a current value of animation variable.
nValue
Output. When the function returns it contains a current value of animation variable.
Return Value
TRUE if the current value was retrieved successfully; otherwise FALSE.
Remarks
Call this function to retrieve the current value. This implementation calls the encapsulated COM object, and if the call fails, this method returns the default value that was previously set in constructor or with SetDefaultValue.
CAnimationValue::GetVariable
Provides access to encapsulated animation variable.
CAnimationVariable& GetVariable();
Return Value
A reference to encapsulated animation variable.
Remarks
Use this method to access the encapsulated animation variable. From CAnimationVariable you get access to underlying IUIAnimationVariable object, whose pointer can be NULL if animation variable has not been created.
CAnimationValue::m_value
The encapsulated animation variable that represents animation value.
CAnimationVariable m_value;
CAnimationValue::operator DOUBLE
Provides conversion between CAnimationValue and DOUBLE.
operator DOUBLE();
Return Value
Current value of Animation Value.
Remarks
Provides conversion between CAnimationValue and DOUBLE. This method internally calls GetValue and doesn't check for errors. If GetValue fails, the returned value will contain a default value previously set in constructor or with SetDefaultValue.
CAnimationValue::operator INT32
Provides conversion between CAnimationValue and INT32.
operator INT32();
Return Value
Current value of Animation Value as integer.
Remarks
Provides conversion between CAnimationValue and INT32. This method internally calls GetValue and doesn't check for errors. If GetValue fails, the returned value will contain a default value previously set in constructor or with SetDefaultValue.
CAnimationValue::operator=
Assigns a DOUBLE value to CAnimationValue.
void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);
Parameters
dblVal
Specifies the value to be assigned to Animation Value.
nVal
Specifies the value to be assigned to Animation Value.
Remarks
Assigns a DOUBLE value to CAnimationValue. This value is set as a default value for encapsulated animation variable. If you subscribed this animation object to events (ValueChanged or IntegerValueChanged), you need to re-enable these events.
CAnimationValue::SetDefaultValue
Sets default value.
void SetDefaultValue(DOUBLE dblDefaultValue);
Parameters
dblDefaultValue
Specifies the default value.
Remarks
Use this method to set a default value. A default value is returned to application when animation has not been started and/or underlying COM object has not been created. If the underlying COM object encapsulated in CAnimationVarible was already created, this method recreates it, therefore you might need to call EnableValueChanged/EnableIntegerValueChanged methods again.