Classe CAnimationColor

Implementa a funcionalidade de uma cor cujos componentes vermelhos, verdes e azuis podem ser animados.

Sintaxe

class CAnimationColor : public CAnimationBaseObject;

Membros

Construtores públicos

Métodos públicos

Métodos protegidos

Operadores públicos

Membros de dados protegidos

Comentários

A classe CAnimationColor encapsula três objetos CAnimationVariable e pode representar uma cor em aplicativos. Por exemplo, você pode usar essa classe para animar as cores de qualquer objeto na tela (como a cor do texto, a cor da tela de fundo etc). Para usar essa classe no aplicativo, basta instanciar um objeto da classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e chamar AddTransition para cada transição a ser aplicada a componentes vermelhos, verdes e azuis.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationColor

Requisitos

Cabeçalho: afxanimationcontroller.h

CAnimationColor::AddTransition

Adiciona transições para componentes vermelhos, verdes e azuis.

void AddTransition(
    CBaseTransition* pRTransition,
    CBaseTransition* pGTransition,
    CBaseTransition* pBTransition);

Parâmetros

pRTransition
Transição para o componente vermelho.

pGTransition
Transição para o componente verde.

pBTransition
Transição para o componente azul.

Comentários

Chame essa função para adicionar as transições especificadas à lista interna de transições a serem aplicadas a variáveis de animação que representam os componentes de cor. Quando você adiciona transições, elas não são aplicadas imediatamente e armazenadas em uma lista interna. As transições são aplicadas (adicionadas a um storyboard para um valor específico) quando você chama CAnimationController::AnimateGroup. Se você não precisar aplicar uma transição a um dos componentes de cor, poderá passar NULL.

CAnimationColor::CAnimationColor

Constrói um objeto CAnimationColor.

CAnimationColor();

CAnimationColor(
    COLORREF color,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parâmetros

color
Especifica a cor padrão.

nGroupID
Especifica a ID do Grupo.

nObjectID
Especifica a ID do objeto.

dwUserData
Especifica dados definidos pelo usuário.

Comentários

O objeto é construído com valores padrão para vermelho, verde, azul, ID de objeto e ID de grupo, que serão definidos como 0. Eles podem ser alterados posteriormente no runtime usando SetDefaultValue e SetID.

CAnimationColor::GetAnimationVariableList

Coloca as variáveis de animação encapsuladas em uma lista.

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

Parâmetros

lst
Quando a função é retornada, ela contém ponteiros para três objetos CAnimationVariable que representam componentes vermelhos, verdes e azuis.

CAnimationColor::GetB

Fornece acesso ao CAnimationVariable que representa um componente azul.

CAnimationVariable& GetB();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa componentes azuis.

Comentários

Você pode chamar esse método para obter acesso direto ao CAnimationVariable subjacente que representa componentes azuis.

CAnimationColor::GetDefaultValue

Retorna os valores padrão dos componentes de cor.

COLORREF GetDefaultValue();

Valor de retorno

Um valor de COLORREF que contém padrões para componentes RGB.

Comentários

Chame essa função para recuperar o valor padrão que foi definido anteriormente pelo construtor ou SetDefaultValue.

CAnimationColor::GetG

Fornece acesso ao CAnimationVariable que representa um componente verde.

CAnimationVariable& GetG();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa componentes verdes.

Comentários

Você pode chamar esse método para obter acesso direto ao CAnimationVariable subjacente que representa componentes verdes.

CAnimationColor::GetR

Fornece acesso ao CAnimationVariable que representa um componente vermelho.

CAnimationVariable& GetR();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa componentes vermelhos.

Comentários

Você pode chamar esse método para obter acesso direto ao CAnimationVariable subjacente que representa componentes vermelhos.

CAnimationColor::GetValue

Retorna o valor atual.

BOOL GetValue(COLORREF& color);

Parâmetros

color
Saída. Contém o valor atual quando esse método retorna.

Valor de retorno

TRUE, se o valor atual foi recuperado com êxito; caso contrário, FALSE.

Comentários

Chame essa função para recuperar o valor atual da cor da animação. Se esse método falhar ou os objetos COM subjacentes dos componentes de cor não tiverem sido inicializados, a cor conterá o valor padrão, que foi definido anteriormente no construtor ou por SetDefaultValue.

CAnimationColor::m_bValue

A variável de animação encapsulada que representa o componente azul da cor de animação.

CAnimationVariable m_bValue;

CAnimationColor::m_gValue

A variável de animação encapsulada que representa o componente verde da cor de animação.

CAnimationVariable m_gValue;

CAnimationColor::m_rValue

A variável de animação encapsulada que representa o componente vermelho da cor de animação.

CAnimationVariable m_rValue;

CAnimationColor::operator COLORREF

operator COLORREF();

Valor de retorno

CAnimationColor::operator=

Atribui cor a CAnimationColor.

void operator=(COLORREF color);

Parâmetros

color
Especifica um novo valor da cor de animação.

Comentários

É recomendável fazer isso antes do início da animação, pois esse operador chama SetDefaultValue, que recria os objetos COM subjacentes para componentes de cor, se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), precisará reabilitar esses eventos.

CAnimationColor::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(COLORREF color);

Parâmetros

color
Especifica novos valores padrão para componentes vermelhos, verdes e azuis.

Comentários

Use essa função para definir um valor padrão para o objeto de animação. Esses métodos atribuem valores padrão aos componentes de cor de animação. Eles também recriarão objetos COM subjacentes se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), precisará reabilitar esses eventos.

Confira também

Classes