Compartilhar via

Classe CAnimationValue

  • Artigo

Implementa a funcionalidade do objeto de animação que tem um valor.

Sintaxe

class CAnimationValue : public CAnimationBaseObject;

Membros

Construtores públicos

Nome Descrição
CAnimationValue::CAnimationValue Sobrecarregado. Constrói um objeto CAnimationValue.

Métodos públicos

Nome Descrição
CAnimationValue::AddTransition Adiciona uma transição a ser aplicada a um valor.
CAnimationValue::GetValue Sobrecarregado. Recupera o valor atual.
CAnimationValue::GetVariable Fornece acesso à variável de animação encapsulada.
CAnimationValue::SetDefaultValue Define o valor padrão.

Métodos protegidos

Nome Descrição
CAnimationValue::GetAnimationVariableList Coloca as variáveis de animação encapsuladas em uma lista. (Substitui CAnimationBaseObject::GetAnimationVariableList.)

Operadores públicos

Nome Descrição
CAnimationValue::operator DOUBLE Fornece a conversão entre CAnimationValue e DOUBLE.
CAnimationValue::operator INT32 Fornece a conversão entre CAnimationValue e INT32.
CAnimationValue::operator= Sobrecarregado. Atribui um valor INT32 a CAnimationValue.

Membros de dados protegidos

Nome Descrição
CAnimationValue::m_value A variável de animação encapsulada que representa o valor da animação.

Comentários

A classe CAnimationValue encapsula um único objeto CAnimationVariable, e pode representar um único valor animado em aplicativos. Por exemplo, você pode usar essa classe para transparência animada (efeito de fade), ângulo (para girar objetos) ou em qualquer outro caso em que precisar criar uma animação dependendo de um único valor animado. Para usar essa classe no aplicativo, basta instanciar um objeto dessa classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e chamar AddTransition para cada transição a ser aplicada ao valor.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationValue

Requisitos

Cabeçalho: afxanimationcontroller.h

CAnimationValue::AddTransition

Adiciona uma transição a ser aplicada a um valor.

void AddTransition(CBaseTransition* pTransition);

Parâmetros

pTransition
Um ponteiro para um objeto de transição.

Comentários

Chame essa função para adicionar uma transição à lista interna de transições a serem aplicadas a uma variável de animação. 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.

CAnimationValue::CAnimationValue

Constrói um objeto CAnimationValue.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parâmetros

dblDefaultValue
Especifica o valor padrão.

nGroupID
Especifica a ID do Grupo.

nObjectID
Especifica a ID do objeto.

dwUserData
Especifica dados definidos pelo usuário.

Comentários

Constrói o objeto CAnimationValue com propriedades padrão: o valor padrão, a ID do grupo e a ID do objeto são definidos como 0.

CAnimationValue::GetAnimationVariableList

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

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

Parâmetros

lst
Quando a função retorna, ela contém um ponteiro para CAnimationVariable que representa o valor animado.

CAnimationValue::GetValue

Recupera o valor atual.

BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);

Parâmetros

dblValue
Saída. Quando a função retorna, ela contém um valor atual da variável de animação.

nValue
Saída. Quando a função retorna, ela contém um valor atual da variável de animação.

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. Essa implementação chama o objeto COM encapsulado e, se a chamada falhar, esse método retornará o valor padrão que foi definido anteriormente no construtor ou com SetDefaultValue.

CAnimationValue::GetVariable

Fornece acesso à variável de animação encapsulada.

CAnimationVariable& GetVariable();

Valor de retorno

Uma referência à variável de animação encapsulada.

Comentários

Use esse método para acessar a variável de animação encapsulada. No CAnimationVariable, você obtém acesso ao objeto IUIAnimationVariable subjacente, cujo ponteiro pode ser NULL se a variável de animação não tiver sido criada.

CAnimationValue::m_value

A variável de animação encapsulada que representa o valor da animação.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

Fornece a conversão entre CAnimationValue e DOUBLE.

operator DOUBLE();

Valor de retorno

Valor atual do valor da animação.

Comentários

Fornece a conversão entre CAnimationValue e DOUBLE. Esse método chama internamente GetValue e não verifica se há erros. Se GetValue falhar, o valor retornado conterá um valor padrão definido anteriormente no construtor ou com SetDefaultValue.

CAnimationValue::operator INT32

Fornece a conversão entre CAnimationValue e INT32.

operator INT32();

Valor de retorno

Valor atual do valor da animação como inteiro.

Comentários

Fornece a conversão entre CAnimationValue e INT32. Esse método chama internamente GetValue e não verifica se há erros. Se GetValue falhar, o valor retornado conterá um valor padrão definido anteriormente no construtor ou com SetDefaultValue.

CAnimationValue::operator=

Atribui um valor DOUBLE a CAnimationValue.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

Parâmetros

dblVal
Especifica o valor a ser atribuído ao valor da animação.

nVal
Especifica o valor a ser atribuído ao valor da animação.

Comentários

Atribui um valor DOUBLE a CAnimationValue. Esse valor é definido como um valor padrão para a variável de animação encapsulada. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), precisará reabilitar esses eventos.

CAnimationValue::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parâmetros

dblDefaultValue
Especifica o valor padrão.

Comentários

Use este método para definir um valor padrão. Um valor padrão é retornado ao aplicativo quando a animação não foi iniciada e/ou o objeto COM subjacente não foi criado. Se o objeto COM encapsulado subjacente em CAnimationVarible já tiver sido criado, esse método o recriará; portanto, pode ser necessário chamar os métodos EnableValueChanged/EnableIntegerValueChanged novamente.

Confira também

Classes