Classe CAnimationRect

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

Sintaxe

class CAnimationRect : public CAnimationBaseObject;

Membros

Construtores Públicos

Métodos Públicos

Métodos Protegidos

Operadores Públicos

Membros de Dados Públicos

Membros de Dados Protegidos

Observações

A classe CAnimationRect encapsula quatro objetos CAnimationVariable e pode representar em aplicações um retângulo. Para usar esta classe numa aplicação, basta instanciar um objeto desta classe, adicioná-lo ao controlador de animação usando CAnimationController::AddAnimationObject e chamar o AddTransition para cada transição a ser aplicada às coordenadas superior e inferior esquerda, direita.

Hierarquia de herança

CObject

CAnimationBaseObject

CAnimationRect

Requerimentos

Cabeçalho: afxanimationcontroller.h

CAnimationRect::AddTransition

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

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

Parâmetros

pTransiçãoEsquerda
Especifica a transição para o lado esquerdo.

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

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

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

Observações

Chame esta função para adicionar as transições especificadas à lista interna de transições a serem aplicadas às variáveis de animação de cada lado do retângulo. 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 a um dos lados do retângulo, podes 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

retângulo
Especifica o retângulo padrão.

nGroupID
Especifica o ID do grupo.

nObjectID
Especifica o ID do Objeto.

dwUserData
Especifica dados definidos pelo utilizador.

pt
Coordenada do canto superior esquerdo.

sz
Tamanho de retângulo.

nEsquerda
Especifica a coordenada do limite à esquerda.

nTop
Especifica a coordenada do limite superior.

nCerto
Especifica a coordenada do limite direito.

nBottom
Especifica a coordenada do limite inferior.

Observações

O objeto é construído com valores predefinidos para esquerda, cima, direita e inferior, ID de 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.

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

CAnimationRect::GetBottom

Fornece acesso à CAnimationVariable que representa a coordenada inferior.

CAnimationVariable& GetBottom();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada inferior.

Observações

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

CAnimationRect::GetDefaultValue

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

CRect GetDefaultValue();

Valor de retorno

Um valor CRect contendo os valores predefinidos para esquerda, direita, topo e baixo.

Observações

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

CAnimationRect::GetLeft

Fornece acesso à CAnimationVariable representando a coordenada esquerda.

CAnimationVariable& GetLeft();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada à esquerda.

Observações

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

CAnimationRect::FazerCerto

Fornece acesso à CAnimationVariable representando a coordenada direita.

CAnimationVariable& GetRight();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada direita.

Observações

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

CAnimationRect::GetTop

Fornece acesso à CAnimationVariable que representa a coordenada superior.

CAnimationVariable& GetTop();

Valor de retorno

Uma referência à CAnimationVariable encapsulada que representa a coordenada superior.

Observações

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

CAnimationRect::GetValue

Devolve o valor atual.

BOOL GetValue(CRect& rect);

Parâmetros

retângulo
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 retângulo de animação. Se este método falhar ou se os objetos COM subjacentes para esquerda, cima, direita e base não forem inicializados, o rect contém o valor padrão, que foi previamente definido no construtor ou pelo SetDefaultValue.

CAnimationRect::m_bFixedSize

Especifica se o retângulo tem tamanho fixo.

BOOL m_bFixedSize;

Observações

Se este elemento for verdadeiro, então o tamanho do retângulo é fixo e os valores direito e inferior são recalculados cada vez que o canto superior esquerdo é movido de acordo com o tamanho fixo. Defina este valor para TRUE para mover facilmente o retângulo pelo ecrã. Neste caso, as transições aplicadas às coordenadas direita e inferior são ignoradas. O tamanho é armazenado internamente quando constrói o objeto e/ou chama SetDefaultValue. Por defeito, este membro está 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.

Observações

Esta função chama internamente o GetValue. Se o GetValue por algum motivo falhar, o RECT devolvido conterá valores predefinidos para todas as coordenadas retangulares.

CAnimationRect::operator=

Atribui o rect ao CAnimationRect.

void operator=(const RECT& rect);

Parâmetros

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

Observações

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

CAnimationRect::SetDefaultValue

Define o valor padrão.

void SetDefaultValue(const CRect& rect);

Parâmetros

retângulo
Especifica novos valores padrão para esquerda, cima, direita e base.

Observações

Use esta função para definir um valor padrão para o objeto animação. Este método atribui valores padrão aos limites do retângulo. 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