CAnimationRect, classe

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

class CAnimationRect : public CAnimationBaseObject;

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.

CObject

CAnimationBaseObject

CAnimationRect

En-tête : afxanimationcontroller.h

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

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

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.

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.

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);

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.

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.

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

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

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

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

CAnimationVariable& GetBottom();

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

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

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

CRect GetDefaultValue();

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

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.

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

CAnimationVariable& GetLeft();

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

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

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

CAnimationVariable& GetRight();

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

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

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

CAnimationVariable& GetTop();

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

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

Retourne la valeur actuelle.

BOOL GetValue(CRect& rect);

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

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

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.

Spécifie si le rectangle a une taille fixe.

BOOL m_bFixedSize;

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.

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

CAnimationVariable m_bottomValue;

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

CAnimationVariable m_leftValue;

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

CAnimationVariable m_rightValue;

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

CSize m_szInitial;

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

CAnimationVariable m_topValue;

Convertit un CAnimationRect en RECT.

operator RECT();

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

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.

Affecte la rect à CAnimationRect.

void operator=(const RECT& rect);

rect
Nouvelle valeur du rectangle d’animation.

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.

Définit la valeur par défaut.

void SetDefaultValue(const CRect& rect);

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

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.

Classes