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

Comentários

A classe CAnimationRect encapsula dois objetos CAnimationVariable e pode representar um tamanho em aplicativos. Por exemplo, você pode usar essa classe para animar um tamanho de qualquer objeto bidimensional na tela (como retângulo, controle etc). 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 à largura e/ou altura.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationSize

Requisitos

Cabeçalho: afxanimationcontroller.h

CAnimationSize::AddTransition

Adiciona transições para Largura e Altura.

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

Parâmetros

pCXTransition
Um ponteiro para fazer a transição para Largura.

pCYTransition
Um ponteiro para fazer a transição para Altura.

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 Largura e Altura. 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. Se você não precisar aplicar uma transição a uma dessas dimensões, poderá passar NULL.

CAnimationSize::CAnimationSize

Constrói um objeto de tamanho de 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 a ID do Grupo.

nObjectID
Especifica a ID do objeto.

dwUserData
Especifica dados definidos pelo usuário.

Comentários

O objeto é construído com valores padrão para largura, altura, ID de Objeto e ID de Grupo, que serão definidos como 0. Eles podem ser alterados posteriormente no runtime usando SetDefaultValue e SetID.

CAnimationSize::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 a largura e a altura.

CAnimationSize::GetCX

Fornece acesso ao CAnimationVariable que representa a Largura.

CAnimationVariable& GetCX();

Valor de retorno

Uma referência ao CAnimationVariable encapsulado que representa a Largura.

Comentários

Você pode chamar esse 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 ao CAnimationVariable encapsulado que representa a Altura.

Comentários

Você pode chamar esse método para obter acesso direto ao CAnimationVariable subjacente que representa a Altura.

CAnimationSize::GetDefaultValue

Retorna os valores padrão para Largura e Altura.

CSize GetDefaultValue();

Valor de retorno

Um objeto CSize que contém valores padrão.

Comentários

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

CAnimationSize::GetValue

Retorna o valor atual.

BOOL GetValue(CSize& szValue);

Parâmetros

szValue
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 tamanho de animação. Se esse método falhar ou os objetos COM subjacentes para Largura e Tamanho não tiverem sido inicializados, o szValue conterá o valor padrão, que foi definido anteriormente no construtor ou por 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 em um CSize.

operator CSize();

Valor de retorno

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

Comentários

Essa função chama GetValue internamente. Se GetValue por algum motivo falhar, o tamanho retornado conterá valores padrão para Largura e Altura.

CAnimationSize::operator=

Atribui szSrc ao CAnimationSize.

void operator=(const CSize& szSrc);

Parâmetros

szSrc
Refere-se a CSize ou SIZE.

Comentários

Atribui szSrc ao CAnimationSize. É recomendável fazer isso antes do início da animação, pois esse operador chama SetDefaultValue, que recria os objetos COM subjacentes para Largura e Altura se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), precisará reabilitar esses eventos.

CAnimationSize::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const CSize& szDefault);

Parâmetros

szDefault
Especifica o novo tamanho padrão.

Comentários

Use essa função para definir um valor padrão para o objeto de animação. Esses métodos atribuem valores padrão à Largura e à Altura do tamanho da animação. Eles também recriarão objetos COM subjacentes se eles tiverem sido criados. Se você assinou esse objeto de animação em eventos (ValueChanged ou IntegerValueChanged), precisará reabilitar esses eventos.

Confira também

Classes