CAnimationPoint classe

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

Sintaxe

class CAnimationPoint : public CAnimationBaseObject;

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Operadores Públicos

Membros de Dados Protegidos

Observações

A CAnimationPoint classe encapsula dois CAnimationVariable objetos e pode representar em aplicações um ponto. Por exemplo, pode usar esta classe para animar a posição de qualquer objeto no ecrã, como uma cadeia de texto, círculo, ponto, e assim por diante. Para usar esta classe numa aplicação, basta instanciar um objeto dessa classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject, e pedir AddTransition que cada transição seja aplicada às coordenadas X e/ou Y.

Hierarquia de herança

CObject
CAnimationBaseObject
CAnimationPoint

Requerimentos

Cabeçalho:afxanimationcontroller.h

CAnimationPoint::AddTransition

Adiciona transições para coordenadas X e Y.

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

Parâmetros

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

pYTransition
Um ponteiro para a transição da coordenada Y.

Observações

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

CAnimationPoint::CAnimationPoint

Constrói um CAnimationPoint objeto.

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

nObjectID
Especifica o ID do Objeto.

dwUserData
Especifica dados definidos pelo utilizador.

Observações

Constrói um CAnimationPoint objeto com propriedades por defeito. As coordenadas padrão dos pontos, ID de Grupo e ID de Objeto, estão definidas a zero.

CAnimationPoint::GetAnimationVariableList

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

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

Parâmetros

lst
Quando a função retorna, contém ponteiros para dois CAnimationVariable objetos que representam as coordenadas X e Y.

CAnimationPoint::GetDefaultValue

Devolve os valores padrão para as coordenadas X e Y.

CPoint GetDefaultValue();

Valor de retorno

Um ponto contendo o valor padrão.

Observações

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

CAnimationPoint::GetValue

Devolve o valor atual.

BOOL GetValue(CPoint& ptValue);

Parâmetros

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

Valor de retorno

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

Observações

Chame esta função para recuperar o valor atual do ponto de animação. Se este método falhar ou se os objetos COM subjacentes para coordenadas X e Y não tiverem sido inicializados, ptValue contém o valor padrão previamente definido no construtor ou por SetDefaultValue.

CAnimationPoint::GetX

Fornece acesso a CAnimationVariable para a coordenada X.

CAnimationVariable& GetX();

Valor de retorno

Uma referência a encapsulado CAnimationVariable representando a coordenada X.

Observações

Pode chamar este método para obter acesso direto ao subjacente CAnimationVariable que representa a coordenada X.

CAnimationPoint::GetY

Fornece acesso para CAnimationVariable a coordenada Y.

CAnimationVariable& GetY();

Valor de retorno

Uma referência ao encapsulado CAnimationVariable que representa a coordenada Y.

Observações

Pode chamar este método para obter acesso direto ao subjacente CAnimationVariable 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 a CAnimationPoint em um CPointarquivo .

operator CPoint();

Valor de retorno

Valor atual de CAnimationPoint como CPoint.

Observações

Esta função chama GetValueinternamente . Se GetValue falhar, o ponto devolvido 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.

Observações

Atribui ptSrc a CAnimationPoint. Recomenda-se fazer isso antes do início da animação, porque este operador chama SetDefaultValue, que recria os objetos COM subjacentes para as coordenadas X e Y, caso tenham sido criados. Se subscreveram este objeto de animação para eventos (ValueChanged ou IntegerValueChanged), reativem esses eventos.

CAnimationPoint::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const POINT& ptDefault);

Parâmetros

ptDefault
Especifica o valor de pontos padrão.

Observações

Use esta função para definir um valor padrão para o objeto animação. Este método atribui valores por defeito às coordenadas X e Y do ponto de animação. Também recria os objetos COM subjacentes, caso tenham sido criados. Se subscreveram este objeto de animação para eventos (ValueChanged ou IntegerValueChanged), reativem esses eventos.

Consulte também

Classes