Classe CAnimationPoint

Implementa a funcionalidade de um ponto cujas coordenadas podem ser animadas.

Sintaxe

class CAnimationPoint : public CAnimationBaseObject;

Membros

Construtores públicos

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

Métodos públicos

Nome	Descrição
CAnimationPoint::AddTransition	Adiciona transições para as coordenadas X e Y.
CAnimationPoint::GetDefaultValue	Retorna os valores padrão para coordenadas X e Y.
CAnimationPoint::GetValue	Retorna o valor atual.
CAnimationPoint::GetX	Fornece acesso à coordenada X CAnimationVariable.
CAnimationPoint::GetY	Fornece acesso à coordenada Y CAnimationVariable.
CAnimationPoint::SetDefaultValue	Define o valor padrão.

Métodos protegidos

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

Operadores públicos

Nome	Descrição
CAnimationPoint::operator CPoint	Converte uma CAnimationPoint em uma CPoint.
CAnimationPoint::operator=	Atribui ptSrc a CAnimationPoint.

Membros de dados protegidos

Nome	Descrição
CAnimationPoint::m_xValue	A variável de animação encapsulada que representa a coordenada X do ponto de animação.
CAnimationPoint::m_yValue	A variável de animação encapsulada que representa a coordenada Y do ponto de animação.

Comentários

A classe CAnimationPoint encapsula dois objetos CAnimationVariable e pode representar um ponto em aplicativos. Por exemplo, você pode usar essa classe para animar uma posição de qualquer objeto na tela, como cadeia de caracteres de texto, círculo, ponto e assim por diante. Para usar essa classe em um aplicativo, basta criar uma instância de um objeto dessa classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e solicitar AddTransition para que cada transição seja aplicada às coordenadas X e/ou Y.

Hierarquia de herança

CObject
CAnimationBaseObject
CAnimationPoint

Requisitos

Cabeçalho: afxanimationcontroller.h

CAnimationPoint::AddTransition

Adiciona transições para as coordenadas X e Y.

void AddTransition(
    CBaseTransition* pXTransition,
    CBaseTransition* pYTransition);

Parâmetros

pXTransition
Um ponteiro para fazer a transição para coordenadas X.

pYTransition
Um ponteiro para fazer a transição para coordenadas Y.

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 para X e Y. Quando você adiciona transições, elas não são aplicadas imediatamente e são 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 uma dessas coordenadas, poderá passar NULL.

CAnimationPoint::CAnimationPoint

Constrói um objeto CAnimationPoint.

CAnimationPoint();

CAnimationPoint(
    const CPoint& ptDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parâmetros

ptDefault
Especifica coordenadas de ponto 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 um novo objeto CAnimationPoint com propriedades padrão. As coordenadas de ponto padrão, ID de Grupo e ID de Objeto, são definidas como zero.

CAnimationPoint::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 ponteiros para dois objetos CAnimationVariable que representam as coordenadas X e Y.

CAnimationPoint::GetDefaultValue

Retorna os valores padrão para coordenadas X e Y.

CPoint GetDefaultValue();

Valor de retorno

Um ponto que contém o valor padrão.

Comentários

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

CAnimationPoint::GetValue

Retorna o valor atual.

BOOL GetValue(CPoint& ptValue);

Parâmetros

ptValue
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 do ponto da animação. Se esse método falhar ou os objetos COM subjacentes para coordenadas X e Y não tiverem sido inicializados, ptValue conterá o valor padrão definido anteriormente no construtor ou por SetDefaultValue.

CAnimationPoint::GetX

Fornece acesso a CAnimationVariable para a coordenada X.

CAnimationVariable& GetX();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada X.

Comentários

Você pode chamar esse método para obter acesso direto à CAnimationVariable subjacente que representa a coordenada X.

CAnimationPoint::GetY

Fornece acesso a CAnimationVariable para a coordenada Y.

CAnimationVariable& GetY();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada Y.

Comentários

Você pode chamar esse método para obter acesso direto à CAnimationVariable subjacente que representa a coordenada Y.

CAnimationPoint::m_xValue

A variável de animação encapsulada que representa a coordenada X do ponto de animação.

CAnimationVariable m_xValue;

CAnimationPoint::m_yValue

A variável de animação encapsulada que representa a coordenada Y do ponto de animação.

CAnimationVariable m_yValue;

CAnimationPoint::operator CPoint

Converte uma CAnimationPoint em uma CPoint.

operator CPoint();

Valor de retorno

Valor atual de CAnimationPoint como CPoint.

Comentários

Essa função chama GetValue internamente. Se GetValue falhar, o ponto retornado conterá valores padrão para as coordenadas X e Y.

CAnimationPoint::operator=

Atribui ptSrc a CAnimationPoint.

void operator=(const CPoint& ptSrc);

Parâmetros

ptSrc
Refere-se a CPoint ou POINT.

Comentários

Atribui ptSrc a CAnimationPoint. É recomendável fazer isso antes do início da animação, pois esse operador chama SetDefaultValue, que recria os objetos COM subjacentes para as coordenadas X e Y se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), habilite novamente esses eventos.

CAnimationPoint::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const POINT& ptDefault);

Parâmetros

ptDefault
Especifica o valor de ponto padrão.

Comentários

Use essa função para definir um valor padrão para o objeto de animação. Esse método atribui valores padrão às coordenadas X e Y do ponto de animação. Ele também recria objetos COM subjacentes se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), habilite novamente esses eventos.

Confira também

Classes