CAnimationValue (clase)

Implementa la funcionalidad del objeto de animación que tiene un valor.

Sintaxis

class CAnimationValue : public CAnimationBaseObject;

Miembros

Constructores públicos

Nombre	Descripción
CAnimationValue::CAnimationValue	Con sobrecarga. Construye un objeto CAnimationValue.

Métodos públicos

Nombre	Descripción
CAnimationValue::AddTransition	Agrega una transición que se va a aplicar a un valor.
CAnimationValue::GetValue	Con sobrecarga. Recupera la fuente actual.
CAnimationValue::GetVariable	Proporciona acceso a la variable de animación encapsulada.
CAnimationValue::SetDefaultValue	Esta función se usa para establecer el valor predeterminado.

Métodos protegidos

Nombre	Descripción
CAnimationValue::GetAnimationVariableList	Esta función se usa para colocar la variable de animación encapsuladas en una lista. (Invalida CAnimationBaseObject::GetAnimationVariableList.)

Operadores públicos

Nombre	Descripción
CAnimationValue::operator DOUBLE	Proporciona conversión entre CAnimationValue y DOUBLE.
CAnimationValue::operator INT32	Proporciona conversión entre CAnimationValue e INT32.
CAnimationValue::operator=	Con sobrecarga. Asigna un valor INT32 a CAnimationValue.

Miembros de datos protegidos

Nombre	Descripción
CAnimationValue::m_value	Variable de animación encapsulada que representa el valor de animación.

Comentarios

La clase CAnimationValue encapsula un único objeto CAnimationVariable y puede representar en las aplicaciones un único valor animado. Por ejemplo, puedes usar esta clase para la transparencia animada (efecto de atenuación), el ángulo (para rotar objetos) o para cualquier otro caso cuando necesites crear una animación en función de un único valor animado. Para usar esta clase en una aplicación, basta con crear una instancia de un objeto de esta clase, agregarla al controlador de animación mediante la función CAnimationController::AddAnimationObject y, por último, llamar a la función AddTransition para que cada transición se aplique al valor.

Jerarquía de herencia

CObject

CAnimationBaseObject

CAnimationValue

Requisitos

Encabezado: afxanimationcontroller.h

CAnimationValue::AddTransition

Agrega una transición que se va a aplicar a un valor.

void AddTransition(CBaseTransition* pTransition);

Parámetros

pTransition
Un puntero a un objeto de transición.

Comentarios

Llama a esta función para agregar una transición a una lista interna de transiciones que se aplicarán a una variable de animación. Al agregar transiciones, estas no se aplicarán inmediatamente, sino que se almacenarán en una lista interna. Las transiciones se aplican (se agregan a un guión gráfico para un valor determinado) cuando se llama a la función CAnimationController::AnimateGroup.

CAnimationValue::CAnimationValue

Construye un objeto CAnimationValue.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parámetros

dblDefaultValue
Especifica valor predeterminado.

nGroupID
Especifica el identificador de grupo.

nObjectID
Este parámetro se usa para especificar el id. de objeto.

dwUserData
Especifica datos definidos por el usuario.

Comentarios

Construye el objeto CAnimationValue con propiedades predeterminadas: el valor predeterminado, el id. de grupo y el identificador de objeto se establecen en 0.

CAnimationValue::GetAnimationVariableList

Esta función se usa para colocar la variable de animación encapsuladas en una lista.

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

Parámetros

lst
Cuando la función devuelve, contiene un puntero a CAnimationVariable que representa el valor animado.

CAnimationValue::GetValue

Recupera la fuente actual.

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

Parámetros

dblValue
Salida. Cuando la función devuelve contiene un valor actual de la variable de animación.

nValue
Salida. Cuando la función devuelve contiene un valor actual de la variable de animación.

Valor devuelto

Si el valor actual se recuperó correctamente, el valor devuelto será TRUE; de lo contrario, será FALSE.

Comentarios

Llama a esta función para recuperar el valor actual. Esta implementación llama al objeto COM encapsulado y, si se produce un error en la llamada, este método devuelve el valor predeterminado que se estableció anteriormente en el constructor o con SetDefaultValue.

CAnimationValue::GetVariable

Proporciona acceso a la variable de animación encapsulada.

CAnimationVariable& GetVariable();

Valor devuelto

Referencia a la variable de animación encapsulada.

Comentarios

Usa este método para acceder a la variable de animación encapsulada. Desde CAnimationVariable se obtiene acceso al objeto IUIAnimationVariable subyacente, cuyo puntero puede ser NULL si no se ha creado la variable de animación.

CAnimationValue::m_value

Variable de animación encapsulada que representa el valor de animación.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

Proporciona conversión entre CAnimationValue y DOUBLE.

operator DOUBLE();

Valor devuelto

Valor actual de Valor de animación.

Comentarios

Proporciona conversión entre CAnimationValue y DOUBLE. Este método llama internamente a GetValue y no comprueba si hay errores. Si se produce un error en GetValue, el valor devuelto contendrá un valor predeterminado establecido previamente en el constructor o con SetDefaultValue.

CAnimationValue::operator INT32

Proporciona conversión entre CAnimationValue e INT32.

operator INT32();

Valor devuelto

Valor actual de Valor de animación como entero.

Comentarios

Proporciona conversión entre CAnimationValue e INT32. Este método llama internamente a GetValue y no comprueba si hay errores. Si se produce un error en GetValue, el valor devuelto contendrá un valor predeterminado establecido previamente en el constructor o con SetDefaultValue.

CAnimationValue::operator=

Asigna un valor DOUBLE a CAnimationValue.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

Parámetros

dblVal
Especifica el valor que se va a asignar al valor de animación.

nVal
Especifica el valor que se va a asignar al valor de animación.

Comentarios

Asigna un valor DOUBLE a CAnimationValue. Este valor se establece como un valor predeterminado para la variable de animación encapsulada. Si ha suscrito este objeto de animación a algún evento (ValueChanged o IntegerValueChanged), deberá volver a habilitarlo.

CAnimationValue::SetDefaultValue

Esta función se usa para establecer el valor predeterminado.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parámetros

dblDefaultValue
Especifica el valor predeterminado.

Comentarios

Usa este método para establecer un valor predeterminado. Se devuelve un valor predeterminado a la aplicación cuando no se ha iniciado la animación o no se ha creado el objeto COM subyacente. Si el objeto COM subyacente encapsulado en CAnimationVarible ya se creó, este método lo vuelve a crear, por lo tanto, es posible que tenga que llamar a los métodos EnableValueChanged/EnableIntegerValueChanged de nuevo.

Consulte también

Clases