Condividi tramite


Classe CAnimationValue

Implementa la funzionalità di oggetto di animazione con un valore.

Sintassi

class CAnimationValue : public CAnimationBaseObject;

Membri

Costruttori pubblici

Nome Descrizione
CAnimationValue::CAnimationValue Con overload. Costruisce un oggetto CAnimationValue.

Metodi pubblici

Nome Descrizione
CAnimationValue::AddTransition Aggiunge una transizione da applicare a un valore.
CAnimationValue::GetValue Con overload. Recupera il valore corrente.
CAnimationValue::GetVariable Fornisce l'accesso alla variabile di animazione incapsulata.
CAnimationValue::SetDefaultValue Imposta il valore predefinito.

Metodi protetti

Nome Descrizione
CAnimationValue::GetAnimationVariableList Inserisce la variabile di animazione incapsulata in un elenco. (sostituzioni )CAnimationBaseObject::GetAnimationVariableList.

Operatori pubblici

Nome Descrizione
CAnimationValue::operator DOUBLE Fornisce la conversione tra CAnimationValue e DOUBLE.
CAnimationValue::operator INT32 Fornisce la conversione tra CAnimationValue e INT32.
CAnimationValue::operator= Con overload. Assegna un valore INT32 a CAnimationValue.

Membri dati protetti

Nome Descrizione
CAnimationValue::m_value Variabile di animazione incapsulata che rappresenta il valore dell'animazione.

Osservazioni:

La classe CAnimationValue incapsula un singolo oggetto CAnimationVariable e può rappresentare nelle applicazioni un singolo valore animato. Ad esempio, puoi usare questa classe per la trasparenza animata (effetto dissolvenza), l'angolo (per ruotare gli oggetti) o per qualsiasi altro caso quando devi creare un'animazione a seconda di un singolo valore animato. Per usare questa classe nell'applicazione, è sufficiente creare un'istanza di un oggetto di questa classe, aggiungerla al controller di animazione usando CAnimationController::AddAnimationObject e chiamare AddTransition per ogni transizione da applicare al valore.

Gerarchia di ereditarietà

CObject

CAnimationBaseObject

CAnimationValue

Requisiti

Intestazione: afxanimationcontroller.h

CAnimationValue::AddTransition

Aggiunge una transizione da applicare a un valore.

void AddTransition(CBaseTransition* pTransition);

Parametri

pTransition
Puntatore all'oggetto di transizione.

Osservazioni:

Chiamare questa funzione per aggiungere una transizione all'elenco interno di transizioni da applicare a una variabile di animazione. Quando si aggiungono transizioni, non vengono applicate immediatamente e archiviate in un elenco interno. Le transizioni vengono applicate (aggiunte a uno storyboard per un determinato valore) quando si chiama CAnimationController::AnimateGroup.

CAnimationValue::CAnimationValue

Costruisce un oggetto CAnimationValue.

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parametri

dblDefaultValue
Specifica il valore predefinito.

nGroupID
Specifica l'ID gruppo.

nObjectID
Specifica l'ID oggetto.

dwUserData
specifica i dati definiti dall'utente.

Osservazioni:

Costruisce l'oggetto CAnimationValue con proprietà predefinite: valore predefinito, ID gruppo e ID oggetto sono impostati su 0.

CAnimationValue::GetAnimationVariableList

Inserisce la variabile di animazione incapsulata in un elenco.

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

Parametri

Lst
Quando la funzione termina, contiene un puntatore a CAnimationVariable che rappresenta il valore animato.

CAnimationValue::GetValue

Recupera il valore corrente.

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

Parametri

dblValue
Output. Quando la funzione restituisce contiene un valore corrente della variabile di animazione.

nValue
Output. Quando la funzione restituisce contiene un valore corrente della variabile di animazione.

Valore restituito

TRUE se il valore corrente è stato recuperato correttamente; in caso contrario FALSE.

Osservazioni:

Chiamare questa funzione per recuperare il valore corrente. Questa implementazione chiama l'oggetto COM incapsulato e, se la chiamata ha esito negativo, questo metodo restituisce il valore predefinito impostato in precedenza nel costruttore o con SetDefaultValue.

CAnimationValue::GetVariable

Fornisce l'accesso alla variabile di animazione incapsulata.

CAnimationVariable& GetVariable();

Valore restituito

Riferimento alla variabile di animazione incapsulata.

Osservazioni:

Usare questo metodo per accedere alla variabile di animazione incapsulata. Da CAnimationVariable si ottiene l'accesso all'oggetto IUIAnimationVariable sottostante, il cui puntatore può essere NULL se la variabile di animazione non è stata creata.

CAnimationValue::m_value

Variabile di animazione incapsulata che rappresenta il valore dell'animazione.

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

Fornisce la conversione tra CAnimationValue e DOUBLE.

operator DOUBLE();

Valore restituito

Valore corrente dell'animazione.

Osservazioni:

Fornisce la conversione tra CAnimationValue e DOUBLE. Questo metodo chiama internamente GetValue e non verifica la presenza di errori. Se GetValue ha esito negativo, il valore restituito conterrà un valore predefinito impostato in precedenza nel costruttore o con SetDefaultValue.

CAnimationValue::operator INT32

Fornisce la conversione tra CAnimationValue e INT32.

operator INT32();

Valore restituito

Valore corrente di Animation Value come integer.

Osservazioni:

Fornisce la conversione tra CAnimationValue e INT32. Questo metodo chiama internamente GetValue e non verifica la presenza di errori. Se GetValue ha esito negativo, il valore restituito conterrà un valore predefinito impostato in precedenza nel costruttore o con SetDefaultValue.

CAnimationValue::operator=

Assegna un valore DOUBLE a CAnimationValue.

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

Parametri

dblVal
Specifica il valore da assegnare a Valore animazione.

nVal
Specifica il valore da assegnare a Valore animazione.

Osservazioni:

Assegna un valore DOUBLE a CAnimationValue. Questo valore viene impostato come valore predefinito per la variabile di animazione incapsulata. Se hai sottoscritto questo oggetto animazione agli eventi (ValueChanged o IntegerValueChanged), devi riabilitare questi eventi.

CAnimationValue::SetDefaultValue

Imposta il valore predefinito.

void SetDefaultValue(DOUBLE dblDefaultValue);

Parametri

dblDefaultValue
Specifica il valore predefinito.

Osservazioni:

Utilizzare questo metodo per impostare un valore predefinito. Un valore predefinito viene restituito all'applicazione quando l'animazione non è stata avviata e/o l'oggetto COM sottostante non è stato creato. Se l'oggetto COM sottostante incapsulato in CAnimationVarible è già stato creato, questo metodo lo ricrea, pertanto potrebbe essere necessario chiamare nuovamente i metodi EnableValueChanged/EnableIntegerValueChanged.

Vedi anche

Classi