Classe CBaseTransition

Representa uma transição básica.

Sintaxe

class CBaseTransition : public CObject;

Membros

Enumerações públicas

Nome	Descrição
CBaseTransition::TRANSITION_TYPE Enumeration	Define os tipos de transição compatíveis com a implementação do MFC da API de Animação do Windows.

Construtores públicos

Nome	Descrição
CBaseTransition::CBaseTransition	Constrói um objeto de transição base.
CBaseTransition::~CBaseTransition	O destruidor. Chamado quando um objeto de transição está sendo destruído.

Métodos públicos

Nome	Descrição
CBaseTransition::AddToStoryboard	Adiciona uma transição a um storyboard.
CBaseTransition::AddToStoryboardAtKeyframes	Adiciona uma transição a um storyboard.
CBaseTransition::Clear	Libera o objeto COM IUIAnimationTransition encapsulado.
CBaseTransition::Create	Cria uma transição COM.
CBaseTransition::GetEndKeyframe	Retorna o quadro-chave inicial.
CBaseTransition::GetRelatedVariable	Retorna um ponteiro para a variável relacionada.
CBaseTransition::GetStartKeyframe	Retorna o quadro-chave inicial.
CBaseTransition::GetTransition	Sobrecarregado. Retorna um ponteiro para o objeto de transição COM subjacente.
CBaseTransition::GetType	Retorna o tipo de transição.
CBaseTransition::IsAdded	Informa se uma transição foi adicionada a um storyboard.
CBaseTransition::SetKeyframes	Define quadros-chave para uma transição.
CBaseTransition::SetRelatedVariable	Estabelece uma relação entre a variável de animação e a transição.

Membros de dados protegidos

Nome	Descrição
CBaseTransition::m_bAdded	Especifica se uma transição foi adicionada a um storyboard.
CBaseTransition::m_pEndKeyframe	Armazena um ponteiro para o quadro-chave que especifica o final da transição.
CBaseTransition::m_pRelatedVariable	Um ponteiro para uma variável de animação, que é animada com a transição armazenada em m_transition.
CBaseTransition::m_pStartKeyframe	Armazena um ponteiro para o quadro-chave que especifica o início da transição.
CBaseTransition::m_transition	Armazena um ponteiro para IUIAnimationTransition. NULL se um objeto de transição COM não tiver sido criado.
CBaseTransition::m_type	Armazena o tipo de transição.

Comentários

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

Hierarquia de herança

CObject

CBaseTransition

Requisitos

Cabeçalho: afxanimationcontroller.h

CBaseTransition::~CBaseTransition

O destruidor. Chamado quando um objeto de transição está sendo destruído.

virtual ~CBaseTransition();

CBaseTransition::AddToStoryboard

Adiciona uma transição a um storyboard.

BOOL AddToStoryboard(IUIAnimationStoryboard* pStoryboard);

Parâmetros

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

Valor de retorno

TRUE se a transição foi adicionada com êxito a um storyboard.

Comentários

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

CBaseTransition::AddToStoryboardAtKeyframes

Adiciona uma transição a um storyboard.

BOOL AddToStoryboardAtKeyframes(IUIAnimationStoryboard* pStoryboard);

Parâmetros

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

Valor de retorno

TRUE se a transição foi adicionada com êxito a um storyboard.

Comentários

Aplica a transição à variável relacionada no storyboard. Se o quadro-chave inicial tiver sido especificado, a transição começará nele. Se o quadro-chave final tiver sido especificado, a transição começará no quadro-chave inicial e será interrompida no quadro-chave final. Se a transição tiver sido criada com um parâmetro de duração especificado, essa duração será substituída pela duração do período entre os quadros-chave inicial e final. Se nenhum quadro-chave foi especificado, a transição será acrescentada à transição adicionada mais recentemente à variável.

CBaseTransition::CBaseTransition

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

CBaseTransition();

CBaseTransition::Clear

Libera o objeto COM IUIAnimationTransition encapsulado.

void Clear();

Comentários

Esse método deve ser chamado do método Create de uma classe derivada para evitar o vazamento da 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ção, que cria transições padrão. Pode ser NULL para transições personalizadas.

pFactory
Um ponteiro para a fábrica de transição, 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 êxito; caso contrário, FALSE.

Comentários

Essa é uma função virtual pura que deve ser substituída em uma classe derivada. Ela é chamada pela estrutura para criar uma instância do objeto de transição COM subjacente.

CBaseTransition::GetEndKeyframe

Retorna o quadro-chave inicial.

CBaseKeyFrame* GetEndKeyframe();

Valor de retorno

Um ponteiro válido para um quadro-chave ou NULL se uma transição não deve ser inserida entre quadros-chave.

Comentários

Esse método pode ser usado para acessar um objeto de quadro-chave definido anteriormente por SetKeyframes. Ele é chamado pelo código de nível superior quando transições estão sendo adicionadas ao storyboard.

CBaseTransition::GetRelatedVariable

Retorna um ponteiro para a 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 por SetRelatedVariable.

Comentários

Esse é um acessador para a variável de animação relacionada.

CBaseTransition::GetStartKeyframe

Retorna o quadro-chave inicial.

CBaseKeyFrame* GetStartKeyframe();

Valor de retorno

Um ponteiro válido para um quadro-chave ou NULL se uma transição não deve ser iniciada após um quadro-chave.

Comentários

Esse método pode ser usado para acessar um objeto de quadro-chave definido anteriormente por SetKeyframes. Ele é chamado pelo código de nível superior quando transições estão sendo adicionadas ao storyboard.

CBaseTransition::GetTransition

Retorna 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ção, que cria transições padrão. Pode ser NULL para transições personalizadas.

pFactory
Um ponteiro para a fábrica de transição, 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.

Comentários

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

CBaseTransition::GetType

Retorna o tipo de transição.

TRANSITION_TYPE GetType() const;

Valor de retorno

Um dos valores enumerados de TRANSITION_TYPE.

Comentários

Esse método pode ser usado para identificar um objeto de transição segundo seu tipo. O tipo é definido em um construtor em uma classe derivada.

CBaseTransition::IsAdded

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

BOOL IsAdded();

Valor de retorno

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

Comentários

Esse sinalizador é definido internamente quando o código de nível superior 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 quadro-chave que especifica o final da transição.

CBaseKeyFrame* m_pEndKeyframe;

CBaseTransition::m_pRelatedVariable

Um ponteiro 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 quadro-chave que especifica o início da transição.

CBaseKeyFrame* m_pStartKeyframe;

CBaseTransition::m_transition

Armazena um ponteiro 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 quadros-chave para uma transição.

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

Parâmetros

pStart
Um quadro-chave que especifica o início da transição.

pEnd
Um quadro-chave que especifica o final da transição.

Comentários

Esse método instrui a transição a iniciar após o quadro-chave especificado e, opcionalmente, se pEnd não for NULL, terminar antes do quadro-chave especificado. Se a transição tiver sido criada com um parâmetro de duração especificado, essa duração será substituída pela duração do período entre os quadros-chave inicial e final.

CBaseTransition::SetRelatedVariable

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

void SetRelatedVariable(CAnimationVariable* pVariable);

Parâmetros

pVariable
Um ponteiro para a variável de animação relacionada.

Comentários

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

CBaseTransition::TRANSITION_TYPE Enumeration

Define os tipos de transição compatíveis com a implementação do MFC da API de Animação do Windows.

enum TRANSITION_TYPE;

Comentários

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

Confira também

Classes