Classe CBaseTransition

Representa uma transição básica.

Sintaxe

class CBaseTransition : public CObject;

Membros

Enumerações Públicas

Construtores Públicos

Métodos Públicos

Membros de Dados Protegidos

Observações

Esta classe encapsula a interface IUIAnimationTransition e serve como classe base para todas as transições.

Hierarquia de herança

CObject

CBaseTransition

Requerimentos

Cabeçalho: afxanimationcontroller.h

CBaseTransition::~CBaseTransition

O destruidor. Chamada quando um objeto de transição está a ser destruído.

virtual ~CBaseTransition();

CBaseTransition::AddToStoryboard

Adiciona uma transição a um storyboard.

BOOL AddToStoryboard(IUIAnimationStoryboard* pStoryboard);

Parâmetros

pStoryboard
Um apontador para o storyboard, que irá animar a variável relacionada.

Valor de retorno

VERDADE, se a transição fosse adicionada com sucesso a um storyboard.

Observações

Aplica a transição à variável relacionada no storyboard. Se esta for a primeira transição aplicada a esta variável neste storyboard, a transição começa no início do storyboard. Caso contrário, a transição é adicionada à transição adicionada mais recentemente à variável.

CBaseTransition::AdicionarAStoryboardAtKeyframes

Adiciona uma transição a um storyboard.

BOOL AddToStoryboardAtKeyframes(IUIAnimationStoryboard* pStoryboard);

Parâmetros

pStoryboard
Um apontador para o storyboard, que irá animar a variável relacionada.

Valor de retorno

VERDADE, se a transição fosse adicionada com sucesso a um storyboard.

Observações

Aplica a transição à variável relacionada no storyboard. Se o keyframe inicial foi especificado, a transição começa nesse keyframe. Se o keyframe final foi especificado, a transição começa no keyframe inicial e termina no keyframe final. Se a transição foi criada com um parâmetro de duração especificado, essa duração é sobrescrita pelo tempo entre os keyframes de início e fim. Se não for especificado o keyframe, a transição é adicionada à transição adicionada mais recentemente à variável.

CBaseTransição::CBaseTransição

Constrói um objeto de transição base.

CBaseTransition();

CBaseTransition::Clear

Lançamentos encapsularam o objeto IUIAnimationTransition COM.

void Clear();

Observações

Este método deve ser chamado a partir do método Create de uma classe derivada para evitar fugas na interface IUITransition.

CBaseTransition::Create

Cria uma transição COM.

virtual BOOL Create(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* pFactory) = 0;

Parâmetros

pLibrary
Um ponteiro para a biblioteca de transições, que cria transições padrão. Pode ser NULL para transições personalizadas.

pFactory
Um ponteiro para a fábrica de transições, que cria transições personalizadas. Pode ser NULL para transições padrão.

Valor de retorno

TRUE se um objeto COM de transição foi criado com sucesso; caso contrário, FALSO.

Observações

Esta é uma função puramente virtual que deve ser sobreposta numa classe derivada. É chamado pela framework para instanciar o objeto de transição COM subjacente.

CBaseTransition::GetEndKeyframe

Retorna iniciar keyframe.

CBaseKeyFrame* GetEndKeyframe();

Valor de retorno

Um ponteiro válido para um keyframe, ou NULL se uma transição não deve ser inserida entre keyframes.

Observações

Este método pode ser usado para aceder a um objeto keyframe que anteriormente foi definido por SetKeyframes. É chamado por código de topo quando as transições são adicionadas ao storyboard.

CBaseTransition::GetRelatedVariable

Devolve um ponteiro para variável relacionada.

CAnimationVariable* GetRelatedVariable();

Valor de retorno

Um ponteiro válido para a variável de animação, ou NULL se uma variável de animação não tiver sido definida pelo SetRelatedVariable.

Observações

Este é um acessório à variável de animação relacionada.

CBaseTransition::GetStartKeyframe

Retorna iniciar keyframe.

CBaseKeyFrame* GetStartKeyframe();

Valor de retorno

Um ponteiro válido para um keyframe, ou NULL se uma transição não deve começar após um keyframe.

Observações

Este método pode ser usado para aceder a um objeto keyframe que anteriormente foi definido por SetKeyframes. É chamado por código de topo quando as transições são adicionadas ao storyboard.

CBaseTransition::GetTransition

Devolve um ponteiro para o objeto de transição COM subjacente.

IUIAnimationTransition* GetTransition(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* pFactory);

IUIAnimationTransition* GetTransition();

Parâmetros

pLibrary
Um ponteiro para a biblioteca de transições, que cria transições padrão. Pode ser NULL para transições personalizadas.

pFactory
Um ponteiro para a fábrica de transições, que cria transições personalizadas. Pode ser NULL para transições padrão.

Valor de retorno

Um ponteiro válido para IUIAnimationTransition ou NULL se a transição subjacente não puder ser criada.

Observações

Este método devolve um ponteiro para o objeto de transição COM subjacente e cria-o, se necessário.

CBaseTransition::GetType

Devolve o tipo de transição.

TRANSITION_TYPE GetType() const;

Valor de retorno

Um dos valores enumerados TRANSITION_TYPE.

Observações

Este método pode ser usado para identificar um objeto de transição pelo seu tipo. O tipo é definido num construtor numa classe derivada.

CBaseTransition::IsAdded

Indica se uma transição foi adicionada a um storyboard.

BOOL IsAdded();

Valor de retorno

Retorna TRUE se uma transição tiver sido adicionada a um storyboard, caso contrário FALSE.

Observações

Este flag é definido internamente quando o código de topo adiciona transições ao storyboard.

CBaseTransition::m_bAdded

Especifica se uma transição foi adicionada a um storyboard.

BOOL m_bAdded;

CBaseTransition::m_pEndKeyframe

Armazena um ponteiro para o keyframe que especifica o fim da transição.

CBaseKeyFrame* m_pEndKeyframe;

CBaseTransition::m_pRelatedVariable

Um apontador para uma variável de animação, que é animada com a transição armazenada em m_transition.

CAnimationVariable* m_pRelatedVariable;

CBaseTransition::m_pStartKeyframe

Armazena um ponteiro para o keyframe que especifica o início da transição.

CBaseKeyFrame* m_pStartKeyframe;

CBaseTransition::m_transition

Armazena um apontador para IUIAnimationTransition. NULL se um objeto de transição COM não tiver sido criado.

ATL::CComPtr<IUIAnimationTransition> m_transition;

CBaseTransition::m_type

Armazena o tipo de transição.

TRANSITION_TYPE m_type;

CBaseTransition::SetKeyframes

Define keyframes para uma transição.

void SetKeyframes(
    CBaseKeyFrame* pStart = NULL,
    CBaseKeyFrame* pEnd = NULL);

Parâmetros

pStart
Um keyframe que especifica o início da transição.

pFim
Um keyframe que especifica o fim da transição.

Observações

Este método indica à transição para começar após o keyframe especificado e, opcionalmente, se pEnd não for NULL, terminar antes do keyframe especificado. Se a transição foi criada com um parâmetro de duração especificado, essa duração é sobrescrita pelo tempo entre os keyframes de início e fim.

CBaseTransition::SetVariávelRelacionada.

Estabelece uma relação entre a variável de animação e a transição.

void SetRelatedVariable(CAnimationVariable* pVariable);

Parâmetros

pVariável
Um apontador para uma variável de animação relacionada.

Observações

Estabelece uma relação entre a variável de animação e a transição. Uma transição só pode ser aplicada a uma variável.

CBaseTransition::TRANSITION_TYPE Enumeração

Define os tipos de transição atualmente suportados pela implementação MFC da API Windows Animation.

enum TRANSITION_TYPE;

Observações

Um tipo de transição é definido no construtor de transição específica. Por exemplo, o CSinusoidalTransitionFromRange define o seu tipo para SINUSOIDAL_FROM_RANGE.

Consulte também

Classes