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
| Nome | Descrição |
|---|---|
| CAnimationColor::CAnimationColor | Sobrecarregado. Constrói um objeto de cor de animação. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CAnimationColor::AddTransition | Adiciona transições para componentes vermelhos, verdes e azuis. |
| CAnimationColor::GetB | Fornece acesso ao CAnimationVariable que representa um componente azul. |
| CAnimationColor::GetDefaultValue | Retorna os valores padrão dos componentes de cor. |
| CAnimationColor::GetG | Fornece acesso ao CAnimationVariable que representa um componente verde. |
| CAnimationColor::GetR | Fornece acesso ao CAnimationVariable que representa um componente vermelho. |
| CAnimationColor::GetValue | Retorna o valor atual. |
| CAnimationColor::SetDefaultValue | Define o valor padrão. |
Métodos protegidos
| Nome | Descrição |
|---|---|
| CAnimationColor::GetAnimationVariableList | Coloca as variáveis de animação encapsuladas em uma lista. (Substitui CAnimationBaseObject::GetAnimationVariableList.) |
Operadores públicos
| Nome | Descrição |
|---|---|
| CAnimationColor::operator COLORREF | |
| CAnimationColor::operator= | Atribui cor a CAnimationColor. |
Membros de dados protegidos
| Nome | Descrição |
|---|---|
| CAnimationColor::m_bValue | A variável de animação encapsulada que representa o componente azul da cor de animação. |
| CAnimationColor::m_gValue | A variável de animação encapsulada que representa o componente verde da cor de animação. |
| CAnimationColor::m_rValue | A variável de animação encapsulada que representa o componente vermelho da cor de animação. |
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
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.