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
| Nome | Descrição |
|---|---|
| CAnimationSize::CAnimationSize | Sobrecarregado. Constrói um objeto de tamanho de animação. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CAnimationSize::AddTransition | Adiciona transições para Largura e Altura. |
| CAnimationSize::GetCX | Fornece acesso ao CAnimationVariable que representa a Largura. |
| CAnimationSize::GetCY | Fornece acesso ao CAnimationVariable que representa a Altura. |
| CAnimationSize::GetDefaultValue | Retorna os valores padrão para Largura e Altura. |
| CAnimationSize::GetValue | Retorna o valor atual. |
| CAnimationSize::SetDefaultValue | Define o valor padrão. |
Métodos protegidos
| Nome | Descrição |
|---|---|
| CAnimationSize::GetAnimationVariableList | Coloca as variáveis de animação encapsuladas em uma lista. (Substitui CAnimationBaseObject::GetAnimationVariableList.) |
Operadores públicos
| Nome | Descrição |
|---|---|
| CAnimationSize::operator CSize | Converte um CAnimationSize em um CSize. |
| CAnimationSize::operator= | Atribui szSrc ao CAnimationSize. |
Membros de dados protegidos
| Nome | Descrição |
|---|---|
| CAnimationSize::m_cxValue | A variável de animação encapsulada que representa a largura do tamanho da animação. |
| CAnimationSize::m_cyValue | A variável de animação encapsulada que representa a altura do tamanho da animação. |
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
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.