Classe CAnimationColor

Implementa a funcionalidade de uma cor cujos componentes vermelho, verde e azul 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

Observações

A classe CAnimationColor encapsula três objetos CAnimationVariable e pode representar em aplicações uma cor. Por exemplo, podes usar esta classe para animar as cores de qualquer objeto no ecrã (como cor do texto, cor de fundo, etc). Para usar esta classe numa aplicação, basta instanciar um objeto desta classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e chamar o AddTransition para cada transição a ser aplicada aos componentes Vermelho, Verde e Azul.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationColor

Requerimentos

Cabeçalho: afxanimationcontroller.h

CAnimationColor::AddTransition

Adiciona transições para componentes Vermelho, Verde e Azul.

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.

Observações

Chame esta função para adicionar as transições especificadas à lista interna de transições a serem aplicadas a variáveis de animação que representam componentes de cor. Quando adicionas transições, elas não são aplicadas imediatamente e armazenadas numa lista interna. As transições são aplicadas (adicionadas a um storyboard para um valor específico) quando chamas o CAnimationController::AnimateGroup. Se não precisares de aplicar uma transição a um dos componentes de cor, podes passar NULL.

CAnimationColor::CAnimationColor

Constrói um objeto CAnimationColor.

CAnimationColor();

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

Parâmetros

cor
Especifica a cor padrão.

nGroupID
Especifica o ID do grupo.

nObjectID
Especifica o ID do Objeto.

dwUserData
Especifica dados definidos pelo utilizador.

Observações

O objeto é construído com valores predefinidos para vermelho, verde, azul, ID do Objeto e ID do Grupo, que serão definidos para 0. Podem ser alteradas mais tarde em tempo de execução usando SetDefaultValue e SetID.

CAnimationColor::GetAnimationVariableList

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

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

Parâmetros

lst
Quando a função regressa, contém apontadores para três objetos CAnimationVariable que representam componentes vermelho, verde e azul.

CAnimationColor::GetB

Fornece acesso ao CAnimationVariable que representa o componente azul.

CAnimationVariable& GetB();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa o componente azul.

Observações

Pode chamar este método para obter acesso direto ao CAnimationVariable subjacente que representa o componente azul.

CAnimationColor::GetDefaultValue

Devolve os valores padrão dos componentes de cor.

COLORREF GetDefaultValue();

Valor de retorno

Um valor COLORREF contendo os valores definidos para componentes RGB.

Observações

Chame esta função para recuperar o valor por defeito, que foi previamente definido pelo construtor ou pelo SetDefaultValue.

CAnimationColor::GetG

Fornece acesso ao CAnimationVariable que representa o componente Green.

CAnimationVariable& GetG();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa o componente Green.

Observações

Pode chamar este método para obter acesso direto ao CAnimationVariable subjacente que representa o componente Green.

CAnimationColor::GetR

Fornece acesso ao CAnimationVariable que representa o componente vermelho.

CAnimationVariable& GetR();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa o componente vermelho.

Observações

Pode chamar este método para obter acesso direto ao CAnimationVariable subjacente que representa o componente Vermelho.

CAnimationColor::GetValue

Devolve o valor atual.

BOOL GetValue(COLORREF& color);

Parâmetros

cor
Saída. Contém o valor atual quando este método regressa.

Valor de retorno

VERDADE, se o valor atual foi recuperado com sucesso; caso contrário, FALSO.

Observações

Chame esta função para recuperar o valor atual da cor da animação. Se este método falhar ou se os objetos COM subjacentes para os componentes de cor não forem inicializados, a cor contém o valor predefinido, que foi previamente definido no construtor ou pelo SetDefaultValue.

CAnimationColor::m_bValue

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

CAnimationVariable m_bValue;

CAnimationColor::m_gValue

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

CAnimationVariable m_gValue;

CAnimationColor::m_rValue

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

CAnimationVariable m_rValue;

CAnimationColor::operator COLORREF

operator COLORREF();

Valor de retorno

CAnimationColor::operator=

Atribui cor ao CAnimationColor.

void operator=(COLORREF color);

Parâmetros

cor
Especifica o novo valor Cor de Animação.

Observações

Recomenda-se fazer isso antes do início da animação, porque este operador chama SetDefaultValue, que recria os objetos COM subjacentes para os componentes de cor, caso tenham sido criados. Se subscreveu este objeto de animação a eventos (ValueChanged ou IntegerValueChanged), precisa de reativar esses eventos.

CAnimationColor::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(COLORREF color);

Parâmetros

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

Observações

Use esta função para definir um valor padrão para o objeto animação. Este método atribui valores por defeito aos componentes de cor da cor da animação. Também recria objetos COM subjacentes, caso tenham sido criados. Se subscreveu este objeto de animação a eventos (ValueChanged ou IntegerValueChanged), precisa de reativar esses eventos.

Consulte também

Classes