Classe CAnimationSize

Implementa a funcionalidade de um objeto de tamanho cujas dimensões podem ser animadas.

Sintaxe

class CAnimationSize : public CAnimationBaseObject;

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Operadores Públicos

Membros de Dados Protegidos

Observações

A classe CAnimationSize encapsula dois objetos CAnimationVariable e pode representar em aplicações um tamanho. Por exemplo, podes usar esta classe para animar o tamanho de qualquer objeto bidimensional no ecrã (como retângulo, controlo, etc). Para usar esta classe numa aplicação, basta instanciar um objeto dessa classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e chamar o AddTransition para cada transição a ser aplicada a Width e/ou Height.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationSize

Requerimentos

Cabeçalho: afxanimationcontroller.h

CAnimationSize::AddTransition

Adiciona transições para Largura e Altura.

void AddTransition(
    CBaseTransition* pCXTransition,
    CBaseTransition* pCYTransition);

Parâmetros

pCXTransition
Um apontador para transição para Largura.

pCYTransition
Um indicador para a transição da Altura.

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 Largura e Altura. 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. Se não precisares de aplicar uma transição para uma das dimensões, podes passar NULL.

CAnimationSize::CAnimationSize

Constrói um objeto do tamanho de uma animação.

CAnimationSize();

CAnimationSize(
    const CSize& szDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parâmetros

szDefault
Especifica o tamanho padrão.

nGroupID
Especifica o ID do grupo.

nObjectID
Especifica o ID do Objeto.

dwUserData
Especifica dados definidos pelo utilizador.

Observações

O objeto é construído com valores predefinidos para largura, altura, ID do objeto e ID de grupo, que serão definidos para 0. Podem ser alteradas mais tarde em tempo de execução usando SetDefaultValue e SetID.

CAnimationSize::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 apontadores para dois objetos CAnimationVariable que representam a largura e a altura.

CAnimationSize::GetCX

Fornece acesso ao CAnimationVariable representando a Largura.

CAnimationVariable& GetCX();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a Largura.

Observações

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

CAnimationSize::GetCY

Fornece acesso ao CAnimationVariable que representa a Altura.

CAnimationVariable& GetCY();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a Altura.

Observações

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

CAnimationSize::GetDefaultValue

Devolve os valores padrão de Largura e Altura.

CSize GetDefaultValue();

Valor de retorno

Um objeto CSize contendo valores por defeito.

Observações

Chame esta função para recuperar o valor por defeito, que foi previamente definido pelo construtor ou pelo SetDefaultValue.

CAnimationSize::GetValue

Devolve o valor atual.

BOOL GetValue(CSize& szValue);

Parâmetros

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

Valor de retorno

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

Observações

Chame esta função para recuperar o valor atual do tamanho da animação. Se este método falhar ou se os objetos COM subjacentes para Largura e Tamanho não forem inicializados, o szValue contém o valor padrão, que foi previamente definido no construtor ou pelo SetDefaultValue.

CAnimationSize::m_cxValue

A variável de animação encapsulada que representa a largura do tamanho da animação.

CAnimationVariable m_cxValue;

CAnimationSize::m_cyValue

A variável de animação encapsulada que representa a altura do tamanho da animação.

CAnimationVariable m_cyValue;

CAnimationSize::operator CSize

Converte um CAnimationSize num CSize.

operator CSize();

Valor de retorno

Valor atual do tamanho da animação como CSize.

Observações

Esta função chama internamente o GetValue. Se o GetValue por algum motivo falhar, o tamanho devolvido conterá valores predefinidos para Largura e Altura.

CAnimationSize::operator=

Atribui szSrc ao CAnimationSize.

void operator=(const CSize& szSrc);

Parâmetros

szSrc
Refere-se a CSize ou SIZE.

Observações

Atribui szSrc ao CAnimationSize. Recomenda-se fazer isso antes do início da animação, porque este operador chama SetDefaultValue, que recria os objetos COM subjacentes para Largura e Altura, caso tenham sido criados. Se subscreveu este objeto de animação a eventos (ValueChanged ou IntegerValueChanged), precisa de reativar esses eventos.

CAnimationSize::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const CSize& szDefault);

Parâmetros

szDefault
Especifica o novo tamanho padrão.

Observações

Use esta função para definir um valor padrão para o objeto animação. Este método atribui valores padrão à Largura e Altura do tamanho da animação. Também recria objetos COM subjacentes, caso tenham sido criados. Se subscreveu este objeto de animação a eventos (ValueChanged ou IntegerValueChanged), precisa de reativar esses eventos.

Consulte também

Classes