CAnimationValue, classe

Implémente les fonctionnalités d'un objet d'animation qui a une valeur.

Syntaxe

class CAnimationValue : public CAnimationBaseObject;

Membres

Constructeurs publics

Nom	Description
CAnimationValue ::CAnimationValue	Surcharge. Construit un objet CAnimationValue.

Méthodes publiques

Nom	Description
CAnimationValue ::AddTransition	Ajoute une transition à appliquer à une valeur.
CAnimationValue ::GetValue	Surcharge. Récupère la valeur actuelle.
CAnimationValue ::GetVariable	Fournit l’accès à la variable d’animation encapsulée.
CAnimationValue ::SetDefaultValue	Définit la valeur par défaut.

Méthodes protégées

Nom	Description
CAnimationValue ::GetAnimationVariableList	Place la variable d’animation encapsulée dans une liste. (Remplacements CAnimationBaseObject ::GetAnimationVariableList.)

Opérateurs publics

Nom	Description
CAnimationValue ::operator DOUBLE	Fournit la conversion entre CAnimationValue et DOUBLE.
CAnimationValue ::operator INT32	Fournit la conversion entre CAnimationValue et INT32.
CAnimationValue ::operator=	Surcharge. Affecte une valeur INT32 à CAnimationValue.

Membres de données protégés

Nom	Description
CAnimationValue ::m_value	Variable d’animation encapsulée qui représente la valeur d’animation.

Notes

La classe CAnimationValue encapsule un seul objet CAnimationVariable et peut représenter dans les applications une valeur animée unique. Par exemple, vous pouvez utiliser cette classe pour la transparence animée (effet de fondu), l’angle (pour faire pivoter des objets) ou pour tout autre cas lorsque vous devez créer une animation en fonction d’une seule valeur animée. Pour utiliser cette classe dans l’application, instanciez simplement un objet de cette classe, ajoutez-le au contrôleur d’animation à l’aide de CAnimationController ::AddAnimationObject et appelez AddTransition pour chaque transition à appliquer à la valeur.

Hiérarchie d'héritage

CObject

CAnimationBaseObject

CAnimationValue

Spécifications

En-tête : afxanimationcontroller.h

CAnimationValue ::AddTransition

Ajoute une transition à appliquer à une valeur.

void AddTransition(CBaseTransition* pTransition);

Paramètres

pTransition
Pointeur vers l’objet de transition.

Notes

Appelez cette fonction pour ajouter une transition à une liste interne de transitions à appliquer à une variable d’animation. Lorsque vous ajoutez des transitions, elles ne sont pas appliquées immédiatement et stockées dans une liste interne. Les transitions sont appliquées (ajoutées à un storyboard pour une valeur particulière) lorsque vous appelez CAnimationController ::AnimateGroup.

CAnimationValue ::CAnimationValue

Construit un objet CAnimationValue.

CAnimationValue();

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

Paramètres

dblDefaultValue
Spécifie la valeur par défaut.

nGroupID
Spécifie l’ID de groupe.

nObjectID
Spécifie l’ID d’objet.

dwUserData
spécifie les données définies par l’utilisateur.

Notes

Construit l’objet CAnimationValue avec les propriétés par défaut : la valeur par défaut, l’ID de groupe et l’ID d’objet sont définis sur 0.

CAnimationValue ::GetAnimationVariableList

Place la variable d’animation encapsulée dans une liste.

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

Paramètres

Lst
Lorsque la fonction est retournée, elle contient un pointeur vers CAnimationVariable représentant la valeur animée.

CAnimationValue ::GetValue

Récupère la valeur actuelle.

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

Paramètres

dblValue
Sortie. Lorsque la fonction retourne elle contient une valeur actuelle de variable d’animation.

nValue
Sortie. Lorsque la fonction retourne elle contient une valeur actuelle de variable d’animation.

Valeur de retour

TRUE si la valeur actuelle a été récupérée avec succès ; sinon FALSE.

Notes

Appelez cette fonction pour récupérer la valeur actuelle. Cette implémentation appelle l’objet COM encapsulé et, si l’appel échoue, cette méthode retourne la valeur par défaut précédemment définie dans le constructeur ou avec SetDefaultValue.

CAnimationValue ::GetVariable

Fournit l’accès à la variable d’animation encapsulée.

CAnimationVariable& GetVariable();

Valeur de retour

Référence à la variable d’animation encapsulée.

Notes

Utilisez cette méthode pour accéder à la variable d’animation encapsulée. À partir de CAnimationVariable, vous accédez à l’objet IUIAnimationVariable sous-jacent, dont le pointeur peut être NULL si la variable d’animation n’a pas été créée.

CAnimationValue ::m_value

Variable d’animation encapsulée qui représente la valeur d’animation.

CAnimationVariable m_value;

CAnimationValue ::operator DOUBLE

Fournit la conversion entre CAnimationValue et DOUBLE.

operator DOUBLE();

Valeur de retour

Valeur actuelle de la valeur d’animation.

Notes

Fournit la conversion entre CAnimationValue et DOUBLE. Cette méthode appelle en interne GetValue et n’case activée pas pour les erreurs. Si GetValue échoue, la valeur retournée contient une valeur par défaut précédemment définie dans le constructeur ou avec SetDefaultValue.

CAnimationValue ::operator INT32

Fournit la conversion entre CAnimationValue et INT32.

operator INT32();

Valeur de retour

Valeur actuelle de la valeur d’animation en tant qu’entier.

Notes

Fournit la conversion entre CAnimationValue et INT32. Cette méthode appelle en interne GetValue et n’case activée pas pour les erreurs. Si GetValue échoue, la valeur retournée contient une valeur par défaut précédemment définie dans le constructeur ou avec SetDefaultValue.

CAnimationValue ::operator=

Affecte une valeur DOUBLE à CAnimationValue.

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

Paramètres

dblVal
Spécifie la valeur à affecter à la valeur d’animation.

nVal
Spécifie la valeur à affecter à la valeur d’animation.

Notes

Affecte une valeur DOUBLE à CAnimationValue. Cette valeur est définie comme valeur par défaut pour la variable d’animation encapsulée. Si vous avez abonné cet objet d’animation à des événements (ValueChanged ou IntegerValueChanged), vous devez réactiver ces événements.

CAnimationValue ::SetDefaultValue

Définit la valeur par défaut.

void SetDefaultValue(DOUBLE dblDefaultValue);

Paramètres

dblDefaultValue
Spécifie la valeur par défaut.

Notes

Utilisez cette méthode pour définir une valeur par défaut. Une valeur par défaut est retournée à l’application lorsque l’animation n’a pas été démarrée et/ou que l’objet COM sous-jacent n’a pas été créé. Si l’objet COM sous-jacent encapsulé dans CAnimationVarible a déjà été créé, cette méthode le recrée, vous devrez peut-être appeler à nouveau les méthodes EnableValueChanged/EnableIntegerValueChanged.

Voir aussi

Classes