Classe CAnimationValue

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

Sintaxe

class CAnimationValue : public CAnimationBaseObject;

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Operadores Públicos

Membros de Dados Protegidos

Observações

A classe CAnimationValue encapsula um único objeto CAnimationVariable e pode representar em aplicações um único valor animado. Por exemplo, podes usar esta classe para transparência animada (efeito de desvanecimento), ângulo (para rodar objetos) ou para qualquer outro caso em que precises de criar uma animação dependendo de um único valor animado. 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 AddTransition para cada transição a aplicar ao valor.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationValue

Requerimentos

Cabeçalho: afxanimationcontroller.h

CAnimationValue::AddTransition

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

void AddTransition(CBaseTransition* pTransition);

Parâmetros

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

Observações

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

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 o ID do grupo.

nObjectID
Especifica o ID do Objeto.

dwUserData
especifica dados definidos pelo utilizador.

Observações

Constrói o objeto CAnimationValue com propriedades por defeito: valor padrão, ID de Grupo e ID de Objeto estão definidos para 0.

CAnimationValue::GetAnimationVariableList

Coloca a variável de animação encapsulada numa lista.

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

Parâmetros

lst
Quando a função retorna, 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, contém um valor atual da variável de animação.

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

Valor de retorno

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

Observações

Chame esta função para recuperar o valor atual. Esta implementação chama o objeto COM encapsulado e, se a chamada falhar, este método devolve o valor predefinido que estava previamente definido no construtor ou com SetDefaultValue.

CAnimationValue::GetVariable

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

CAnimationVariable& GetVariable();

Valor de retorno

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

Observações

Use este método para aceder à variável de animação encapsulada. A partir de CAnimationVariable tens acesso ao objeto subjacente IUIAnimationVariable, 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::operador DOUBLE

Fornece conversão entre CAnimationValue e DOUBLE.

operator DOUBLE();

Valor de retorno

Valor atual do Valor de Animação.

Observações

Fornece conversão entre CAnimationValue e DOUBLE. Este método chama internamente o GetValue e não verifica erros. Se o GetValue falhar, o valor devolvido conterá um valor por defeito previamente definido no construtor ou com o SetDefaultValue.

CAnimationValue::operator INT32

Fornece conversão entre CAnimationValue e INT32.

operator INT32();

Valor de retorno

Valor atual de Valor de Animação como inteiro.

Observações

Fornece conversão entre CAnimationValue e INT32. Este método chama internamente o GetValue e não verifica erros. Se o GetValue falhar, o valor devolvido conterá um valor por defeito previamente definido no construtor ou com o SetDefaultValue.

CAnimationValue::operator=

Atribui um valor DUPLO a CAnimationValue.

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

Parâmetros

dblVal
Especifica o valor a atribuir ao Valor de Animação.

nVal
Especifica o valor a atribuir ao Valor de Animação.

Observações

Atribui um valor DUPLO a CAnimationValue. Este valor é definido como valor padrão para variável de animação encapsulada. Se subscreveu este objeto de animação a eventos (ValueChanged ou IntegerValueChanged), precisa de reativar esses eventos.

CAnimationValue::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parâmetros

dblDefaultValue
Especifica o valor padrão.

Observações

Use este método para definir um valor padrão. Um valor por defeito é devolvido à aplicação quando a animação não foi iniciada e/ou o objeto COM subjacente não foi criado. Se o objeto COM subjacente encapsulado no CAnimationVarible já foi criado, este método recria-o, por isso poderá ser necessário chamar novamente os métodos EnableValueChanged/EnableIntegerValueChanged.

Consulte também

Classes