CAnimationColor (clase)
Implementa la funcionalidad de un color cuyos componentes rojo, verde y azul se pueden animar.
Sintaxis
class CAnimationColor : public CAnimationBaseObject;
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CAnimationColor::CAnimationColor | Con sobrecarga. Construye un objeto de color de animación. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CAnimationColor::AddTransition | Agrega transiciones para los componentes Rojo, Verde y Azul. |
| CAnimationColor::GetB | Proporciona acceso a CAnimationVariable que representa el componente Azul. |
| CAnimationColor::GetDefaultValue | Devuelve los valores predeterminados de los componentes de color. |
| CAnimationColor::GetG | Proporciona acceso a CAnimationVariable que representa el componente Verde. |
| CAnimationColor::GetR | Proporciona acceso a CAnimationVariable que representa el componente Rojo. |
| CAnimationColor::GetValue | Esta función se usa para obtener el valor actual. |
| CAnimationColor::SetDefaultValue | Esta función se usa para establecer el valor predeterminado. |
Métodos protegidos
| Nombre | Descripción |
|---|---|
| CAnimationColor::GetAnimationVariableList | Esta función se usa para colocar las variables de animación encapsuladas en una lista. (Invalida CAnimationBaseObject::GetAnimationVariableList.) |
Operadores públicos
| Nombre | Descripción |
|---|---|
| CAnimationColor::operator COLORREF | |
| CAnimationColor::operator= | Asigna color a CAnimationColor. |
Miembros de datos protegidos
| Nombre | Descripción |
|---|---|
| CAnimationColor::m_bValue | Variable de animación encapsulada que representa el componente Azul del color de animación. |
| CAnimationColor::m_gValue | Variable de animación encapsulada que representa el componente Verde del color de animación. |
| CAnimationColor::m_rValue | Variable de animación encapsulada que representa el componente Rojo del color de animación. |
Comentarios
La clase CAnimationColor encapsula tres objetos CAnimationVariable y se puede representar en un color de una aplicación. Por ejemplo, puede usar esta clase para animar los colores de cualquier objeto en la pantalla (como el color de texto, el color de fondo, etc.). 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 llamar a la función AddTransition para que cada transición se aplique a los componentes Rojo, Verde y Azul.
Jerarquía de herencia
CAnimationColor
Requisitos
Encabezado: afxanimationcontroller.h
CAnimationColor::AddTransition
Agrega transiciones para los componentes Rojo, Verde y Azul.
void AddTransition(
CBaseTransition* pRTransition,
CBaseTransition* pGTransition,
CBaseTransition* pBTransition);
Parámetros
pRTransition
Transición para el componente Rojo.
pGTransition
Transición para componente Verde.
pBTransition
Transición para el componente Azul.
Comentarios
Llame a esta función para agregar las transiciones especificadas a la lista interna de transiciones que se aplicarán a las variables de animación que representan los componentes de color. 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. Si no necesita aplicar una transición a uno de los componentes de color, puede pasar el valor NULL.
CAnimationColor::CAnimationColor
Construye un objeto CAnimationColor.
CAnimationColor();
CAnimationColor(
COLORREF color,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parámetros
color
Especifica el color predeterminado.
nGroupID
Especifica el identificador de grupo.
nObjectID
Este parámetro se usa para especificar el id. de objeto.
dwUserData
Este parámetro se usa para especificar los datos definidos por el usuario.
Comentarios
El objeto se construye con los valores predeterminados para verde, azul, id. de objeto e id. de grupo que se establecerán en 0. Estos valores se pueden cambiar más tarde, en tiempo de ejecución, mediante las funciones SetDefaultValue y SetID.
CAnimationColor::GetAnimationVariableList
Esta función se usa para colocar las variables de animación encapsuladas en una lista.
virtual void GetAnimationVariableList(CList<CAnimationVariable*>& lst);
Parámetros
lst
Cuando se devuelve la función, contiene punteros a tres objetos CAnimationVariable que representan los componentes rojo, verde y azul.
CAnimationColor::GetB
Proporciona acceso a CAnimationVariable que representa el componente Azul.
CAnimationVariable& GetB();
Valor devuelto
Referencia a un objeto CAnimationVariable encapsulado que representa el componente Azul.
Comentarios
Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa el componente Azul.
CAnimationColor::GetDefaultValue
Devuelve los valores predeterminados de los componentes de color.
COLORREF GetDefaultValue();
Valor devuelto
Valor COLORREF que contiene los valores predeterminados de los componentes RGB.
Comentarios
Llame a esta función para recuperar el valor predeterminado que se estableció anteriormente mediante el uso de un constructor o la función SetDefaultValue.
CAnimationColor::GetG
Proporciona acceso a CAnimationVariable que representa el componente Verde.
CAnimationVariable& GetG();
Valor devuelto
Referencia a un objeto CAnimationVariable encapsulado que representa el componente Verde.
Comentarios
Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa el componente Verde.
CAnimationColor::GetR
Proporciona acceso a CAnimationVariable que representa el componente Rojo.
CAnimationVariable& GetR();
Valor devuelto
Referencia a un objeto CAnimationVariable encapsulado que representa el componente Rojo.
Comentarios
Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa el componente Rojo.
CAnimationColor::GetValue
Esta función se usa para obtener el valor actual.
BOOL GetValue(COLORREF& color);
Parámetros
color
Salida. En este valor, se almacena el valor actual en el momento en que se devuelve este método.
Valor devuelto
Si el valor actual se recuperó correctamente, el valor devuelto será TRUE; de lo contrario, será FALSE.
Comentarios
Llame a esta función para recuperar el valor actual del color de animación. Si se produce un error en este método o no se han inicializado los objetos COM subyacentes para los componentes de color, el color contiene el valor predeterminado que se estableció anteriormente en un constructor o por SetDefaultValue.
CAnimationColor::m_bValue
Variable de animación encapsulada que representa el componente Azul del color de animación.
CAnimationVariable m_bValue;
CAnimationColor::m_gValue
Variable de animación encapsulada que representa el componente Verde del color de animación.
CAnimationVariable m_gValue;
CAnimationColor::m_rValue
Variable de animación encapsulada que representa el componente Rojo del color de animación.
CAnimationVariable m_rValue;
CAnimationColor::operator COLORREF
operator COLORREF();
Valor devuelto
CAnimationColor::operator=
Asigna color a CAnimationColor.
void operator=(COLORREF color);
Parámetros
color
Especifica el nuevo valor de color de animación.
Comentarios
Este proceso de asignación debe realizarse antes del inicio de una animación, ya que al usarlo se llama a la función SetDefaultValue y, gracias a esta, se vuelven a crear los objetos COM subyacentes de los componentes de color si estos ya se han creado. Si ha suscrito este objeto de animación a algún evento (ValueChanged o IntegerValueChanged), deberá volver a habilitarlo.
CAnimationColor::SetDefaultValue
Esta función se usa para establecer el valor predeterminado.
void SetDefaultValue(COLORREF color);
Parámetros
color
Especifica nuevos valores predeterminados para los componentes rojo, verde y azul.
Comentarios
Use esta función para establecer un valor predeterminado en el objeto de animación. Estos métodos asignan valores predeterminados a los componentes de color de animación. También se vuelven a crear los objetos COM subyacentes si estos ya se han creado. Si ha suscrito este objeto de animación a algún evento (ValueChanged o IntegerValueChanged), deberá volver a habilitarlo.