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

CObject

CAnimationBaseObject

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.

Siehe auch

Klassen