Compartir por

CAnimationColor (clase)

  • Artigo

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

CObject

CAnimationBaseObject

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.

Consulte también

Clases