Share via


CAnimationRect, classe

Implémente les fonctionnalités d'un rectangle dont les côtés peuvent être animés.

Syntaxe

class CAnimationRect : public CAnimationBaseObject;

Membres

Constructeurs publics

Nom Description
CAnimationRect ::CAnimationRect Surcharge. Construit un objet rect d’animation.

Méthodes publiques

Nom Description
CAnimationRect ::AddTransition Ajoute des transitions pour les coordonnées gauche, supérieure, droite et inférieure.
CAnimationRect ::GetBottom Fournit l’accès à CAnimationVariable représentant la coordonnée inférieure.
CAnimationRect ::GetDefaultValue Retourne les valeurs par défaut pour les limites du rectangle.
CAnimationRect ::GetLeft Fournit l’accès à CAnimationVariable représentant la coordonnée gauche.
CAnimationRect ::GetRight Fournit l’accès à CAnimationVariable représentant la coordonnée appropriée.
CAnimationRect ::GetTop Fournit l’accès à CAnimationVariable représentant la coordonnée supérieure.
CAnimationRect ::GetValue Retourne la valeur actuelle.
CAnimationRect ::SetDefaultValue Définit la valeur par défaut.

Méthodes protégées

Nom Description
CAnimationRect ::GetAnimationVariableList Place les variables d’animation encapsulées dans une liste. (Remplacements CAnimationBaseObject ::GetAnimationVariableList.)

Opérateurs publics

Nom Description
CAnimationRect ::operator RECT Convertit un CAnimationRect en RECT.
CAnimationRect ::operator= Affecte la rect à CAnimationRect.

Membres de données publics

Nom Description
CAnimationRect ::m_bFixedSize Spécifie si le rectangle a une taille fixe.

Membres de données protégés

Nom Description
CAnimationRect ::m_bottomValue Variable d’animation encapsulée qui représente la limite inférieure du rectangle d’animation.
CAnimationRect ::m_leftValue Variable d’animation encapsulée qui représente la limite gauche du rectangle d’animation.
CAnimationRect ::m_rightValue Variable d’animation encapsulée qui représente la limite droite du rectangle d’animation.
CAnimationRect ::m_szInitial Spécifie la taille initiale du rectangle d’animation.
CAnimationRect ::m_topValue Variable d’animation encapsulée qui représente la limite supérieure du rectangle d’animation.

Notes

La classe CAnimationRect encapsule quatre objets CAnimationVariable et peut représenter dans des applications un rectangle. 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 aux coordonnées gauche, supérieure et inférieure.

Hiérarchie d'héritage

CObject

CAnimationBaseObject

CAnimationRect

Spécifications

En-tête : afxanimationcontroller.h

CAnimationRect ::AddTransition

Ajoute des transitions pour les coordonnées gauche, supérieure, droite et inférieure.

void AddTransition(
    CBaseTransition* pLeftTransition,
    CBaseTransition* pTopTransition,
    CBaseTransition* pRightTransition,
    CBaseTransition* pBottomTransition);

Paramètres

pLeftTransition
Spécifie la transition pour le côté gauche.

pTopTransition
Spécifie la transition pour le côté supérieur.

pRightTransition
Spécifie la transition pour le côté droit.

pBottomTransition
Spécifie la transition pour le côté inférieur.

Notes

Appelez cette fonction pour ajouter les transitions spécifiées à la liste interne des transitions à appliquer aux variables d’animation pour chaque côté rectangle. 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. Si vous n’avez pas besoin d’appliquer une transition à l’un des côtés du rectangle, vous pouvez passer NULL.

CAnimationRect ::CAnimationRect

Construit un objet CAnimationRect.

CAnimationRect();

CAnimationRect(
    const CRect& rect,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    const CPoint& pt,
    const CSize& sz,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    int nLeft,
    int nTop,
    int nRight,
    int nBottom,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Paramètres

Rect
Spécifie le rectangle 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.

pt
Coordonnées du coin supérieur gauche.

Sz
Taille du rectangle.

nLeft
Spécifie la coordonnée de la limite gauche.

Ntop
Spécifie la coordonnée de la limite supérieure.

nRight
Spécifie la coordonnée de la limite droite.

nBottom
Spécifie la coordonnée de la limite inférieure.

Notes

L’objet est construit avec des valeurs par défaut pour la gauche, le haut, la droite et le bas, l’ID d’objet et l’ID de groupe, qui seront définis sur 0. Ils peuvent être modifiés ultérieurement au moment de l’exécution à l’aide de SetDefaultValue et de SetID.

CAnimationRect ::GetAnimationVariableList

Place les variables d’animation encapsulées dans une liste.

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

Paramètres

Lst
Lorsque la fonction est retournée, elle contient des pointeurs vers quatre objets CAnimationVariable représentant les coordonnées du rectangle.

CAnimationRect ::GetBottom

Fournit l’accès à CAnimationVariable représentant la coordonnée inférieure.

CAnimationVariable& GetBottom();

Valeur de retour

Référence à CAnimationVariable encapsulée représentant la coordonnée inférieure.

Notes

Vous pouvez appeler cette méthode pour obtenir un accès direct à CAnimationVariable sous-jacent représentant la coordonnée inférieure.

CAnimationRect ::GetDefaultValue

Retourne les valeurs par défaut pour les limites du rectangle.

CRect GetDefaultValue();

Valeur de retour

Valeur CRect contenant les valeurs par défaut pour la gauche, la droite, le haut et le bas.

Notes

Appelez cette fonction pour récupérer la valeur par défaut, qui a été précédemment définie par le constructeur ou SetDefaultValue.

CAnimationRect ::GetLeft

Fournit l’accès à CAnimationVariable représentant la coordonnée gauche.

CAnimationVariable& GetLeft();

Valeur de retour

Référence à CAnimationVariable encapsulée représentant la coordonnée gauche.

Notes

Vous pouvez appeler cette méthode pour obtenir un accès direct à CAnimationVariable sous-jacent représentant la coordonnée gauche.

CAnimationRect ::GetRight

Fournit l’accès à CAnimationVariable représentant la coordonnée appropriée.

CAnimationVariable& GetRight();

Valeur de retour

Référence à CAnimationVariable encapsulée représentant la coordonnée droite.

Notes

Vous pouvez appeler cette méthode pour obtenir un accès direct à CAnimationVariable sous-jacent représentant la coordonnée appropriée.

CAnimationRect ::GetTop

Fournit l’accès à CAnimationVariable représentant la coordonnée supérieure.

CAnimationVariable& GetTop();

Valeur de retour

Référence à cAnimationVariable encapsulée représentant la coordonnée supérieure.

Notes

Vous pouvez appeler cette méthode pour obtenir un accès direct à CAnimationVariable sous-jacent représentant la coordonnée supérieure.

CAnimationRect ::GetValue

Retourne la valeur actuelle.

BOOL GetValue(CRect& rect);

Paramètres

Rect
Sortie. Contient la valeur actuelle lorsque cette méthode retourne.

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 du rectangle d’animation. Si cette méthode échoue ou sous-jacent des objets COM de gauche, de haut, de droite et de bas n’ont pas été initialisés, rect contient la valeur par défaut, qui a été précédemment définie dans le constructeur ou par SetDefaultValue.

CAnimationRect ::m_bFixedSize

Spécifie si le rectangle a une taille fixe.

BOOL m_bFixedSize;

Notes

Si ce membre est vrai, la taille du rectangle est fixe et les valeurs de droite et inférieure sont recalculées chaque fois que le coin supérieur gauche est déplacé en fonction de la taille fixe. Définissez cette valeur sur TRUE pour déplacer facilement le rectangle autour de l’écran. Dans ce cas, les transitions appliquées aux coordonnées droite et inférieure sont ignorées. La taille est stockée en interne lorsque vous construisez l’objet et/ou appelez SetDefaultValue. Par défaut, ce membre a la valeur FALSE.

CAnimationRect ::m_bottomValue

Variable d’animation encapsulée qui représente la limite inférieure du rectangle d’animation.

CAnimationVariable m_bottomValue;

CAnimationRect ::m_leftValue

Variable d’animation encapsulée qui représente la limite gauche du rectangle d’animation.

CAnimationVariable m_leftValue;

CAnimationRect ::m_rightValue

Variable d’animation encapsulée qui représente la limite droite du rectangle d’animation.

CAnimationVariable m_rightValue;

CAnimationRect ::m_szInitial

Spécifie la taille initiale du rectangle d’animation.

CSize m_szInitial;

CAnimationRect ::m_topValue

Variable d’animation encapsulée qui représente la limite supérieure du rectangle d’animation.

CAnimationVariable m_topValue;

CAnimationRect ::operator RECT

Convertit un CAnimationRect en RECT.

operator RECT();

Valeur de retour

Valeur actuelle du rectangle d’animation en tant que RECT.

Notes

Cette fonction appelle en interne GetValue. Si GetValue échoue pour une raison quelconque, le RECT retourné contient des valeurs par défaut pour toutes les coordonnées de rectangle.

CAnimationRect ::operator=

Affecte la rect à CAnimationRect.

void operator=(const RECT& rect);

Paramètres

Rect
Nouvelle valeur du rectangle d’animation.

Notes

Il est recommandé de le faire avant le début de l’animation, car cet opérateur appelle SetDefaultValue, qui recrée les objets COM sous-jacents pour les composants de couleur s’ils ont été créés. Si vous avez abonné cet objet d’animation à des événements (ValueChanged ou IntegerValueChanged), vous devez réactiver ces événements.

CAnimationRect ::SetDefaultValue

Définit la valeur par défaut.

void SetDefaultValue(const CRect& rect);

Paramètres

Rect
Spécifie de nouvelles valeurs par défaut pour la gauche, le haut, la droite et le bas.

Notes

Utilisez cette fonction pour définir une valeur par défaut sur l’objet d’animation. Ces méthodes attribuent des valeurs par défaut aux limites du rectangle. Il recrée également les objets COM sous-jacents s’ils ont été créés. Si vous avez abonné cet objet d’animation à des événements (ValueChanged ou IntegerValueChanged), vous devez réactiver ces événements.

Voir aussi

Classes