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
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.