Classe CAnimationVariable

Rappresenta una variabile di animazione.

Sintassi

class CAnimationVariable;

Membri

Costruttori pubblici

Nome	Descrizione
CAnimationVariable::CAnimationVariable	Costruisce un oggetto variabile di animazione.
CAnimationVariable::~CAnimationVariable	Distruttore. Chiamato quando un oggetto CAnimationVariable viene eliminato definitivamente.

Metodi pubblici

Nome	Descrizione
CAnimationVariable::AddTransition	Aggiunge una transizione.
CAnimationVariable::ApplyTransitions	Aggiunge transizioni dall'elenco interno allo storyboard.
CAnimationVariable::ClearTransitions	Cancella le transizioni.
CAnimationVariable::Create	Crea l'oggetto COM della variabile di animazione sottostante.
CAnimationVariable::CreateTransitions	Crea tutte le transizioni da applicare a questa variabile di animazione.
CAnimationVariable::EnableIntegerValueChangedEvent	Abilita o disabilita l'evento IntegerValueChanged.
CAnimationVariable::EnableValueChangedEvent	Abilita o disabilita l'evento ValueChanged.
CAnimationVariable::GetDefaultValue	Restituisce il valore predefinito.
CAnimationVariable::GetParentAnimationObject	Restituisce l'oggetto animazione padre.
CAnimationVariable::GetValue	Con overload. Restituisce il valore corrente della variabile di animazione.
CAnimationVariable::GetVariable	Restituisce un puntatore all'oggetto COM IUIAnimationVariable.
CAnimationVariable::SetDefaultValue	Imposta il valore predefinito e rilascia l'oggetto COM IUIAnimationVariable.

Metodi protetti

Nome	Descrizione
CAnimationVariable::SetParentAnimationObject	Imposta la relazione tra una variabile di animazione e un oggetto animazione.

Membri dati pubblici

Nome	Descrizione
CAnimationVariable::m_bAutodestroyTransitions	Specifica se gli oggetti di transizione correlati devono essere eliminati.

Membri dati protetti

Nome	Descrizione
CAnimationVariable::m_dblDefaultValue	Specifica il valore predefinito, propagato a IUIAnimationVariable.
CAnimationVariable::m_lstTransitions	Contiene un elenco di transizioni che animano questa variabile di animazione.
CAnimationVariable::m_pParentObject	Puntatore a un oggetto animazione che incapsula questa variabile di animazione.
CAnimationVariable::m_variable	Archivia un puntatore all'oggetto COM IUIAnimationVariable. NULL se l'oggetto COM non è ancora stato creato o se la creazione non è riuscita.

Osservazioni:

La classe CAnimationVariable incapsula l'oggetto COM IUIAnimationVariable. Contiene anche un elenco di transizioni da applicare alla variabile di animazione in uno storyboard. Gli oggetti CAnimationVariable sono incorporati agli oggetti di animazione, che possono rappresentare in un'applicazione un valore animato, un punto, una dimensione, un colore e un rettangolo.

Gerarchia di ereditarietà

CAnimationVariable

Requisiti

Intestazione: afxanimationcontroller.h

CAnimationVariable::~CAnimationVariable

Distruttore. Chiamato quando un oggetto CAnimationVariable viene eliminato definitivamente.

virtual ~CAnimationVariable();

CAnimationVariable::AddTransition

Aggiunge una transizione.

void AddTransition(CBaseTransition* pTransition);

Parametri

pTransition
Puntatore a una transizione da aggiungere.

Osservazioni:

Questo metodo viene chiamato per aggiungere una transizione all'elenco interno di transizioni da applicare alla variabile di animazione. Questo elenco deve essere cancellato quando è stata pianificata un'animazione.

CAnimationVariable::ApplyTransitions

Aggiunge transizioni dall'elenco interno allo storyboard.

void ApplyTransitions(
    CAnimationController* pController,
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDependOnKeyframes);

Parametri

pController
Puntatore al controller di animazione padre.

pStoryboard
Puntatore allo storyboard.

bDependOnKeyframes
TRUE, se questo metodo deve aggiungere transizioni che dipendono da fotogrammi chiave.

Osservazioni:

Questo metodo aggiunge transizioni dall'elenco interno allo storyboard. Viene chiamato più volte dal codice di primo livello per aggiungere transizioni che non dipendono dai fotogrammi chiave e aggiungere transizioni che dipendono da fotogrammi chiave. Se l'oggetto COM della variabile di animazione sottostante non è stato creato, questo metodo lo crea in questa fase.

CAnimationVariable::CAnimationVariable

Costruisce un oggetto variabile di animazione.

CAnimationVariable(DOUBLE dblDefaultValue = 0.0);

Parametri

dblDefaultValue
Specifica il valore predefinito.

Osservazioni:

Costruisce un oggetto variabile di animazione e ne imposta il valore predefinito. Un valore predefinito viene usato quando una variabile non è animata o non può essere animata.

CAnimationVariable::ClearTransitions

Cancella le transizioni.

void ClearTransitions(BOOL bAutodestroy);

Parametri

bAutodestroy
Specifica se questo metodo deve eliminare oggetti di transizione.

Osservazioni:

Questo metodo rimuove tutte le transizioni dall'elenco interno di transizioni. Se bAutodestroy è TRUE o m_bAutodestroyTransitions è TRUE, le transizioni vengono eliminate. In caso contrario, il chiamante deve deallocare gli oggetti di transizione.

CAnimationVariable::Create

Crea l'oggetto COM della variabile di animazione sottostante.

virtual BOOL Create(IUIAnimationManager* pManager);

Parametri

pManager
Puntatore a Gestione animazioni.

Valore restituito

TRUE se la variabile di animazione è stata creata correttamente; in caso contrario FALSE.

Osservazioni:

Questo metodo crea l'oggetto COM della variabile di animazione sottostante e imposta il valore predefinito.

CAnimationVariable::CreateTransitions

Crea tutte le transizioni da applicare a questa variabile di animazione.

BOOL CreateTransitions(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* \*not used*\);

Parametri

pLibrary
Puntatore a un'interfaccia IUIAnimationTransitionLibrary, che definisce una libreria di transizioni standard.

Valore restituito

TRUE se le transizioni sono state create correttamente; in caso contrario FALSE.

Osservazioni:

Questo metodo viene chiamato dal framework quando deve creare transizioni aggiunte all'elenco interno delle transizioni della variabile.

CAnimationVariable::EnableIntegerValueChangedEvent

Abilita o disabilita l'evento IntegerValueChanged.

void EnableIntegerValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parametri

pController
Puntatore al controller padre.

bEnable
TRUE: abilitare l'evento, FALSE : disabilitare l'evento.

Osservazioni:

Quando l'evento ValueChanged è abilitato, il framework chiama il metodo virtuale CAnimationController::OnAnimationIntegerValueChanged. È necessario eseguirne l'override in una classe derivata da CAnimationController per elaborare questo evento. Questo metodo viene chiamato ogni volta che viene modificato il valore intero della variabile di animazione.

CAnimationVariable::EnableValueChangedEvent

Abilita o disabilita l'evento ValueChanged.

void EnableValueChangedEvent (
    CAnimationController* pController,
    BOOL bEnable);

Parametri

pController
Puntatore al controller padre.

bEnable
TRUE: abilitare l'evento, FALSE : disabilitare l'evento.

Osservazioni:

Quando l'evento ValueChanged è abilitato, il framework chiama il metodo virtuale CAnimationController::OnAnimationValueChanged. È necessario eseguirne l'override in una classe derivata da CAnimationController per elaborare questo evento. Questo metodo viene chiamato ogni volta che viene modificato il valore della variabile di animazione.

CAnimationVariable::GetDefaultValue

Restituisce il valore predefinito.

DOUBLE GetDefaultValue() const;

Valore restituito

Valore predefinito.

Osservazioni:

Usare questa funzione per ottenere il valore predefinito della variabile di animazione. Il valore predefinito può essere impostato nel costruttore o dal metodo SetDefaultValue.

CAnimationVariable::GetParentAnimationObject

Restituisce l'oggetto animazione padre.

CAnimationBaseObject* GetParentAnimationObject();

Valore restituito

Puntatore all'oggetto animazione padre, se è stata stabilita una relazione, altrimenti NULL.

Osservazioni:

Questo metodo può essere chiamato per recuperare un puntatore a un oggetto animazione padre (un contenitore).

CAnimationVariable::GetValue

Restituisce il valore corrente della variabile di animazione.

HRESULT GetValue(DOUBLE& dblValue);
HRESULT GetValue(INT32& nValue);

Parametri

dblValue
Valore corrente della variabile di animazione.

nValue
Valore corrente della variabile di animazione.

Valore restituito

S_OK se il valore è stato ottenuto correttamente o se la variabile di animazione sottostante non è stata creata. In caso contrario, codice di errore HRESULT.

Osservazioni:

Questo metodo può essere chiamato per recuperare il valore corrente della variabile di animazione. Se l'oggetto COM sottostante non è stato creato, dblValue conterrà un valore predefinito, quando la funzione restituisce.

CAnimationVariable::GetVariable

Restituisce un puntatore all'oggetto COM IUIAnimationVariable.

IUIAnimationVariable* GetVariable();

Valore restituito

Puntatore valido all'oggetto COM IUIAnimationVariable oppure NULL se la variabile di animazione non è stata creata o non può essere creata.

Osservazioni:

Usare questa funzione per accedere all'oggetto COM IUIAnimationVariable sottostante e chiamare direttamente i relativi metodi, se necessario.

CAnimationVariable::m_bAutodestroyTransitions

Specifica se gli oggetti di transizione correlati devono essere eliminati.

BOOL m_bAutodestroyTransitions;

Osservazioni:

Impostare questo valore su TRUE per forzare l'eliminazione degli oggetti di transizione quando vengono rimossi dall'elenco interno di transizioni. Se questo valore è FALSE, le transizioni devono essere eliminate chiamando l'applicazione. L'elenco delle transizioni viene sempre cancellato dopo la pianificazione di un'animazione. Il valore predefinito è FALSE.

CAnimationVariable::m_dblDefaultValue

Specifica il valore predefinito, propagato a IUIAnimationVariable.

DOUBLE m_dblDefaultValue;

CAnimationVariable::m_lstTransitions

Contiene un elenco di transizioni che animano questa variabile di animazione.

CObList m_lstTransitions;

CAnimationVariable::m_pParentObject

Puntatore a un oggetto animazione che incapsula questa variabile di animazione.

CAnimationBaseObject* m_pParentObject;

CAnimationVariable::m_variable

Archivia un puntatore all'oggetto COM IUIAnimationVariable. NULL se l'oggetto COM non è ancora stato creato o se la creazione non è riuscita.

ATL::CComPtr<IUIAnimationVariable> m_variable;

CAnimationVariable::SetDefaultValue

Imposta il valore predefinito e rilascia l'oggetto COM IUIAnimationVariable.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parametri

dblDefaultValue
Specifica il nuovo valore predefinito.

Osservazioni:

Utilizzare questo metodo per reimpostare il valore predefinito. Questo metodo rilascia l'oggetto COM interno IUIAnimationVariable, pertanto quando la variabile di animazione viene ricreata, l'oggetto COM sottostante ottiene il nuovo valore predefinito. Il valore predefinito viene restituito da GetValue se l'oggetto COM che rappresenta la variabile di animazione non viene creato o se la variabile non è stata animata.

CAnimationVariable::SetParentAnimationObject

Imposta la relazione tra una variabile di animazione e un oggetto animazione.

void SetParentAnimationObject(CAnimationBaseObject* pParentObject);

Parametri

pParentObject
Puntatore a un oggetto animazione che contiene questa variabile.

Osservazioni:

Questo metodo viene chiamato internamente per stabilire una relazione uno-a-uno tra una variabile di animazione e un oggetto animazione che lo incapsula.

Vedi anche

Classi