Compartilhar via

Classe CAnimationRect

  • Artigo

Implementa a funcionalidade de um retângulo cujos lados podem ser animados.

Sintaxe

class CAnimationRect : public CAnimationBaseObject;

Membros

Construtores públicos

Nome Descrição
CAnimationRect::CAnimationRect Sobrecarregado. Constrói um objeto rect de animação.

Métodos públicos

Nome Descrição
CAnimationRect::AddTransition Adiciona transições para as coordenadas esquerda, superior, direita e inferior.
CAnimationRect::GetBottom Fornece acesso ao CAnimationVariable que representa a coordenada inferior.
CAnimationRect::GetDefaultValue Retorna os valores padrão dos limites do retângulo.
CAnimationRect::GetLeft Fornece acesso ao CAnimationVariable que representa a coordenada esquerda.
CAnimationRect::GetRight Fornece acesso ao CAnimationVariable que representa a coordenada direita.
CAnimationRect::GetTop Fornece acesso ao CAnimationVariable que representa a coordenada superior.
CAnimationRect::GetValue Retorna o valor atual.
CAnimationRect::SetDefaultValue Define o valor padrão.

Métodos protegidos

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

Operadores públicos

Nome Descrição
CAnimationRect::operator RECT Converte um CAnimationRect em RECT.
CAnimationRect::operator= Atribui rect ao CAnimationRect.

Membros de Dados Públicos

Nome Descrição
CAnimationRect::m_bFixedSize Especifica se o retângulo tem tamanho fixo.

Membros de dados protegidos

Nome Descrição
CAnimationRect::m_bottomValue A variável de animação encapsulada que representa o limite inferior do retângulo de animação.
CAnimationRect::m_leftValue A variável de animação encapsulada que representa o limite esquerdo do retângulo de animação.
CAnimationRect::m_rightValue A variável de animação encapsulada que representa o limite direito do retângulo de animação.
CAnimationRect::m_szInitial Especifica o tamanho inicial do retângulo de animação.
CAnimationRect::m_topValue A variável de animação encapsulada que representa o limite superior do retângulo de animação.

Comentários

A classe CAnimationRect encapsula quatro objetos CAnimationVariable e pode representar um retângulo em aplicativos. 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 às coordenadas esquerda, superior, direita e inferior.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationRect

Requisitos

Cabeçalho: afxanimationcontroller.h

CAnimationRect::AddTransition

Adiciona transições para as coordenadas esquerda, superior, direita e inferior.

void AddTransition(
    CBaseTransition* pLeftTransition,
    CBaseTransition* pTopTransition,
    CBaseTransition* pRightTransition,
    CBaseTransition* pBottomTransition);

Parâmetros

pLeftTransition
Especifica a transição para o lado esquerdo.

pTopTransition
Especifica a transição para a parte superior.

pRightTransition
Especifica a transição para o lado direito.

pBottomTransition
Especifica a transição para a parte inferior.

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 cada lado do retângulo. 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 um dos lados do retângulo, poderá passar NULL.

CAnimationRect::CAnimationRect

Constrói um objeto CAnimationRect.

CAnimationRect();

CAnimationRect(
    const CRect& rect,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    const CPoint& pt,
    const CSize& sz,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    int nLeft,
    int nTop,
    int nRight,
    int nBottom,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parâmetros

rect
Especifica o retângulo padrão.

nGroupID
Especifica a ID do Grupo.

nObjectID
Especifica a ID do objeto.

dwUserData
Especifica dados definidos pelo usuário.

pt
Coordenada do canto superior esquerdo.

sz
Tamanho do retângulo.

nLeft
Especifica a coordenada do limite esquerdo.

nTop
Especifica a coordenada do limite superior.

nRight
Especifica a coordenada do limite direito.

nBottom
Especifica a coordenada do limite inferior.

Comentários

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

CAnimationRect::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 quatro objetos CAnimationVariable que representam coordenadas de retângulo.

CAnimationRect::GetBottom

Fornece acesso ao CAnimationVariable que representa a coordenada inferior.

CAnimationVariable& GetBottom();

Valor de retorno

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

Comentários

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

CAnimationRect::GetDefaultValue

Retorna os valores padrão dos limites do retângulo.

CRect GetDefaultValue();

Valor de retorno

Um valor CRect que contém padrões para esquerda, direita, partes superior e inferior.

Comentários

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

CAnimationRect::GetLeft

Fornece acesso ao CAnimationVariable que representa a coordenada esquerda.

CAnimationVariable& GetLeft();

Valor de retorno

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

Comentários

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

CAnimationRect::GetRight

Fornece acesso ao CAnimationVariable que representa a coordenada direita.

CAnimationVariable& GetRight();

Valor de retorno

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

Comentários

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

CAnimationRect::GetTop

Fornece acesso ao CAnimationVariable que representa a coordenada superior.

CAnimationVariable& GetTop();

Valor de retorno

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

Comentários

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

CAnimationRect::GetValue

Retorna o valor atual.

BOOL GetValue(CRect& rect);

Parâmetros

rect
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 retângulo de animação. Se esse método falhar ou os objetos COM subjacentes para esquerda, parte superior, direita e parte inferior não tiverem sido inicializados, o rect conterá o valor padrão, que foi definido anteriormente no construtor ou por SetDefaultValue.

CAnimationRect::m_bFixedSize

Especifica se o retângulo tem tamanho fixo.

BOOL m_bFixedSize;

Comentários

Se esse membro estiver definido como true, o tamanho do retângulo será fixo e os valores direito e inferior serão recalculados sempre que o canto superior esquerdo for movido de acordo com o tamanho fixo. Defina esse valor como TRUE para mover facilmente o retângulo ao redor da tela. Nesse caso, as transições aplicadas às coordenadas direita e inferior serão ignoradas. O tamanho é armazenado internamente quando você constrói o objeto e/ou chama SetDefaultValue. Por padrão, esse membro é definido como FALSE.

CAnimationRect::m_bottomValue

A variável de animação encapsulada que representa o limite inferior do retângulo de animação.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

A variável de animação encapsulada que representa o limite esquerdo do retângulo de animação.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

A variável de animação encapsulada que representa o limite direito do retângulo de animação.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Especifica o tamanho inicial do retângulo de animação.

CSize m_szInitial;

CAnimationRect::m_topValue

A variável de animação encapsulada que representa o limite superior do retângulo de animação.

CAnimationVariable m_topValue;

CAnimationRect::operator RECT

Converte um CAnimationRect em RECT.

operator RECT();

Valor de retorno

Valor atual do retângulo de animação como RECT.

Comentários

Essa função chama GetValue internamente. Se GetValue por algum motivo falhar, o RECT retornado conterá valores padrão para todas as coordenadas do retângulo.

CAnimationRect::operator=

Atribui rect ao CAnimationRect.

void operator=(const RECT& rect);

Parâmetros

rect
O novo valor do retângulo de animação.

Comentários

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

CAnimationRect::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const CRect& rect);

Parâmetros

rect
Especifica novos valores padrão para esquerda, parte superior, direita e parte inferior.

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 aos limites do retângulo. 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