CAnimationColor-Klasse
Implementiert die Funktion einer Farbe, deren Rot-, Grün- und Blauanteil animiert werden kann.
Syntax
class CAnimationColor : public CAnimationBaseObject;
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CAnimationColor::CAnimationColor | Überladen. Erstellt ein Animationsfarbobjekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CAnimationColor::AddTransition | Fügt Übergänge für Rot-, Grün- und Blaukomponenten hinzu. |
| CAnimationColor::GetB | Bietet Zugriff auf CAnimationVariable, die blaue Komponente darstellt. |
| CAnimationColor::GetDefaultValue | Gibt die Standardwerte für Farbkomponenten zurück. |
| CAnimationColor::GetG | Bietet Zugriff auf CAnimationVariable, die grüne Komponente darstellt. |
| CAnimationColor::GetR | Bietet Zugriff auf CAnimationVariable, die rote Komponente darstellt. |
| CAnimationColor::GetValue | Gibt den aktuellen Wert zurück. |
| CAnimationColor::SetDefaultValue | Legt den Standardwert fest. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CAnimationColor::GetAnimationVariableList | Fügt die gekapselten Animationsvariablen in eine Liste ein. (Außerkraftsetzungen CAnimationBaseObject::GetAnimationVariableList.) |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
| CAnimationColor::operator COLORREF | |
| CAnimationColor::operator= | Weist CAnimationColor Farbe zu. |
Geschützte Datenmember
| Name | Beschreibung |
|---|---|
| CAnimationColor::m_bValue | Die gekapselte Animationsvariable, die die Blaue Komponente der Animationsfarbe darstellt. |
| CAnimationColor::m_gValue | Die gekapselte Animationsvariable, die die grüne Komponente der Animationsfarbe darstellt. |
| CAnimationColor::m_rValue | Die gekapselte Animationsvariable, die die rote Komponente der Animationsfarbe darstellt. |
Hinweise
Die CAnimationColor-Klasse kapselt drei CAnimationVariable-Objekte und kann in Anwendungen eine Farbe darstellen. Sie können diese Klasse beispielsweise verwenden, um Farben eines beliebigen Objekts auf dem Bildschirm zu animieren (z. B. Textfarbe, Hintergrundfarbe usw.). Um diese Klasse in der Anwendung zu verwenden, instanziieren Sie einfach ein Objekt dieser Klasse, fügen Sie sie mithilfe von CAnimationController::AddAnimationObject hinzu, und rufen Sie AddTransition für jeden Übergang auf Red, Green und Blue-Komponenten auf.
Vererbungshierarchie
CAnimationColor
Anforderungen
Header: afxanimationcontroller.h
CAnimationColor::AddTransition
Fügt Übergänge für Rot-, Grün- und Blaukomponenten hinzu.
void AddTransition(
CBaseTransition* pRTransition,
CBaseTransition* pGTransition,
CBaseTransition* pBTransition);
Parameter
pRTransition
Übergang für rote Komponente.
pGTransition
Übergang für grüne Komponente.
pBTransition
Übergang für blaue Komponente.
Hinweise
Rufen Sie diese Funktion auf, um die angegebenen Übergänge zur internen Liste der Übergänge hinzuzufügen, die auf Animationsvariablen angewendet werden sollen, die Farbkomponenten darstellen. Wenn Sie Übergänge hinzufügen, werden sie nicht sofort angewendet und in einer internen Liste gespeichert. Übergänge werden angewendet (einem Storyboard für einen bestimmten Wert hinzugefügt), wenn Sie CAnimationController::AnimateGroup aufrufen. Wenn Sie keinen Übergang auf eine der Farbkomponenten anwenden müssen, können Sie NULL übergeben.
CAnimationColor::CAnimationColor
Erstellt ein CAnimationColor -Objekt.
CAnimationColor();
CAnimationColor(
COLORREF color,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
Parameter
color
Gibt die Standardfarbe an.
nGroupID
Gibt die Gruppen-ID an.
nObjectID
Gibt die Objekt-ID an.
dwUserData
Gibt benutzerdefinierte Daten an.
Hinweise
Das Objekt wird mit Standardwerten für Rot, Grün, Blau, Objekt-ID und Gruppen-ID erstellt, die auf 0 festgelegt wird. Sie können später zur Laufzeit mithilfe von SetDefaultValue und SetID geändert werden.
CAnimationColor::GetAnimationVariableList
Fügt die gekapselten Animationsvariablen in eine Liste ein.
virtual void GetAnimationVariableList(CList<CAnimationVariable*>& lst);
Parameter
Lst
Wenn die Funktion zurückgegeben wird, enthält sie Zeiger auf drei CAnimationVariable-Objekte, die rote, grüne und blaue Komponenten darstellen.
CAnimationColor::GetB
Bietet Zugriff auf CAnimationVariable, die blaue Komponente darstellt.
CAnimationVariable& GetB();
Rückgabewert
Ein Verweis auf die gekapselte CAnimationVariable-Komponente, die blaue Komponente darstellt.
Hinweise
Sie können diese Methode aufrufen, um direkten Zugriff auf die zugrunde liegende CAnimationVariable-Komponente abzurufen, die blaue Komponente darstellt.
CAnimationColor::GetDefaultValue
Gibt die Standardwerte für Farbkomponenten zurück.
COLORREF GetDefaultValue();
Rückgabewert
Ein COLORREF-Wert, der Standardwerte für RGB-Komponenten enthält.
Hinweise
Rufen Sie diese Funktion auf, um den Standardwert abzurufen, der zuvor durch Konstruktor oder SetDefaultValue festgelegt wurde.
CAnimationColor::GetG
Bietet Zugriff auf CAnimationVariable, die grüne Komponente darstellt.
CAnimationVariable& GetG();
Rückgabewert
Ein Verweis auf gekapselte CAnimationVariable-Komponente, die grüne Komponente darstellt.
Hinweise
Sie können diese Methode aufrufen, um direkten Zugriff auf die zugrunde liegende CAnimationVariable-Komponente abzurufen, die grüne Komponente darstellt.
CAnimationColor::GetR
Bietet Zugriff auf CAnimationVariable, die rote Komponente darstellt.
CAnimationVariable& GetR();
Rückgabewert
Ein Verweis auf gekapselte CAnimationVariable,die rote Komponente darstellt.
Hinweise
Sie können diese Methode aufrufen, um direkten Zugriff auf zugrunde liegende CAnimationVariable-Komponenten abzurufen.
CAnimationColor::GetValue
Gibt den aktuellen Wert zurück.
BOOL GetValue(COLORREF& color);
Parameter
color
Ausgabe Enthält den aktuellen Wert, wenn diese Methode zurückgegeben wird.
Rückgabewert
TRUE, wenn der aktuelle Wert erfolgreich abgerufen wurde; andernfalls FALSE.
Hinweise
Rufen Sie diese Funktion auf, um den aktuellen Wert der Animationsfarbe abzurufen. Wenn diese Methode fehlschlägt oder zugrunde liegende COM-Objekte für Farbkomponenten nicht initialisiert wurden, enthält die Farbe den Standardwert, der zuvor im Konstruktor oder von SetDefaultValue festgelegt wurde.
CAnimationColor::m_bValue
Die gekapselte Animationsvariable, die die Blaue Komponente der Animationsfarbe darstellt.
CAnimationVariable m_bValue;
CAnimationColor::m_gValue
Die gekapselte Animationsvariable, die die grüne Komponente der Animationsfarbe darstellt.
CAnimationVariable m_gValue;
CAnimationColor::m_rValue
Die gekapselte Animationsvariable, die die rote Komponente der Animationsfarbe darstellt.
CAnimationVariable m_rValue;
CAnimationColor::operator COLORREF
operator COLORREF();
Rückgabewert
CAnimationColor::operator=
Weist CAnimationColor Farbe zu.
void operator=(COLORREF color);
Parameter
color
Gibt den neuen Wert "Animationsfarbe" an.
Hinweise
Es wird empfohlen, dies vor dem Start der Animation zu tun, da dieser Operator SetDefaultValue aufruft, wodurch die zugrunde liegenden COM-Objekte für Farbkomponenten neu erstellt werden, wenn sie erstellt wurden. Wenn Sie dieses Animationsobjekt für Ereignisse abonniert haben (ValueChanged oder IntegerValueChanged), müssen Sie diese Ereignisse erneut aktivieren.
CAnimationColor::SetDefaultValue
Legt den Standardwert fest.
void SetDefaultValue(COLORREF color);
Parameter
color
Gibt neue Standardwerte für rote, grüne und blaue Komponenten an.
Hinweise
Verwenden Sie diese Funktion, um einen Standardwert auf ein Animationsobjekt festzulegen. Diese Methoden weisen Farbkomponenten der Animationsfarbe Standardwerte zu. Außerdem werden zugrunde liegende COM-Objekte neu erstellt, wenn sie erstellt wurden. Wenn Sie dieses Animationsobjekt für Ereignisse abonniert haben (ValueChanged oder IntegerValueChanged), müssen Sie diese Ereignisse erneut aktivieren.