CAnimationRect-Klasse

Implementiert die Funktion eines Rechtecks, dessen Seiten animiert werden können.

Syntax

class CAnimationRect : public CAnimationBaseObject;

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Öffentliche Operatoren

Öffentliche Datenmember

Geschützte Datenmember

Hinweise

Die CAnimationRect-Klasse kapselt vier CAnimationVariable-Objekte und kann in Anwendungen ein Rechteck darstellen. 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 links, rechte obere und untere Koordinaten an.

Vererbungshierarchie

CObject

CAnimationBaseObject

CAnimationRect

Anforderungen

Header: afxanimationcontroller.h

CAnimationRect::AddTransition

Fügt Übergänge für linke, obere, rechte und untere Koordinaten hinzu.

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

Parameter

pLeftTransition
Gibt den Übergang für die linke Seite an.

pTopTransition
Gibt den Übergang für die obere Seite an.

pRightTransition
Gibt den Übergang für die rechte Seite an.

pBottomTransition
Gibt den Übergang für die untere Seite an.

Hinweise

Rufen Sie diese Funktion auf, um die angegebenen Übergänge zur internen Liste der Übergänge hinzuzufügen, die auf Animationsvariablen für jedes Rechteck angewendet werden sollen. 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 Rechteckseiten anwenden müssen, können Sie NULL übergeben.

CAnimationRect::CAnimationRect

Erstellt ein CAnimationRect -Objekt.

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

Parameter

rect
Gibt das Standardrechteck an.

nGroupID
Gibt die Gruppen-ID an.

nObjectID
Gibt die Objekt-ID an.

dwUserData
Gibt benutzerdefinierte Daten an.

pt
Koordinate der oberen linken Ecke.

sz
Größe des Rechtecks.

nLeft
Gibt die Koordinate der linken Grenze an.

nTop
Gibt die Koordinate der oberen Grenze an.

nRight
Gibt die Koordinate der rechten Grenze an.

nBottom
Gibt die Koordinate der unteren Grenze an.

Hinweise

Das Objekt wird mit Standardwerten für links, oben, rechts und unten, 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.

CAnimationRect::GetAnimationVariableList

Fügt die gekapselten Animationsvariablen in eine Liste ein.

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

Parameter

Lst
Wenn die Funktion zurückgegeben wird, enthält sie Zeiger auf vier CAnimationVariable-Objekte, die Koordinaten des Rechtecks darstellen.

CAnimationRect::GetBottom

Ermöglicht den Zugriff auf CAnimationVariable, der die untere Koordinate darstellt.

CAnimationVariable& GetBottom();

Rückgabewert

Ein Verweis auf gekapselte CAnimationVariable, die die untere Koordinate darstellt.

Hinweise

Sie können diese Methode aufrufen, um direkten Zugriff auf zugrunde liegende CAnimationVariable abzurufen, die die untere Koordinate darstellt.

CAnimationRect::GetDefaultValue

Gibt die Standardwerte für die Grenzen des Rechtecks zurück.

CRect GetDefaultValue();

Rückgabewert

Ein CRect-Wert, der Standardwerte für links, rechts, oben und unten enthält.

Hinweise

Rufen Sie diese Funktion auf, um den Standardwert abzurufen, der zuvor durch Konstruktor oder SetDefaultValue festgelegt wurde.

CAnimationRect::GetLeft

Bietet Zugriff auf CAnimationVariable, der die linke Koordinate darstellt.

CAnimationVariable& GetLeft();

Rückgabewert

Ein Verweis auf Kapselung CAnimationVariable, der die linke Koordinate darstellt.

Hinweise

Sie können diese Methode aufrufen, um direkten Zugriff auf zugrunde liegende CAnimationVariable abzurufen, die die linke Koordinate darstellt.

CAnimationRect::GetRight

Bietet Zugriff auf CAnimationVariable, der die rechte Koordinate darstellt.

CAnimationVariable& GetRight();

Rückgabewert

Ein Verweis auf Kapselung CAnimationVariable, der die rechte Koordinate darstellt.

Hinweise

Sie können diese Methode aufrufen, um direkten Zugriff auf zugrunde liegende CAnimationVariable abzurufen, die die richtige Koordinate darstellt.

CAnimationRect::GetTop

Ermöglicht den Zugriff auf CAnimationVariable, der die obere Koordinate darstellt.

CAnimationVariable& GetTop();

Rückgabewert

Ein Verweis auf Kapselung CAnimationVariable, der die obere Koordinate darstellt.

Hinweise

Sie können diese Methode aufrufen, um direkten Zugriff auf zugrunde liegende CAnimationVariable abzurufen, die die obere Koordinate darstellt.

CAnimationRect::GetValue

Gibt den aktuellen Wert zurück.

BOOL GetValue(CRect& rect);

Parameter

rect
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 des Animationsrechtecks abzurufen. Wenn diese Methode fehlschlägt oder zugrunde liegenden COM-Objekte für links, oben, rechts und unten nicht initialisiert wurde, enthält rect den Standardwert, der zuvor im Konstruktor oder von SetDefaultValue festgelegt wurde.

CAnimationRect::m_bFixedSize

Gibt an, ob das Rechteck eine feste Größe aufweist.

BOOL m_bFixedSize;

Hinweise

Wenn dieses Element "true" ist, wird die Größe des Rechtecks festgelegt, und die werte für rechts und unten werden jedes Mal neu berechnet, wenn die obere linke Ecke entsprechend der festen Größe verschoben wird. Legen Sie diesen Wert auf TRUE fest, um das Rechteck einfach um den Bildschirm zu verschieben. In diesem Fall werden Übergänge, die auf rechte und untere Koordinaten angewendet werden, ignoriert. Die Größe wird intern gespeichert, wenn Sie das Objekt erstellen und/oder SetDefaultValue aufrufen. Standardmäßig ist dieses Element auf FALSE festgelegt.

CAnimationRect::m_bottomValue

Die gekapselte Animationsvariable, die die untere Grenze des Animationsrechtecks darstellt.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

Die gekapselte Animationsvariable, die die linke Grenze des Animationsrechtecks darstellt.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

Die gekapselte Animationsvariable, die rechte Begrenzung des Animationsrechtecks darstellt.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Gibt die Anfangsgröße des Animationsrechtecks an.

CSize m_szInitial;

CAnimationRect::m_topValue

Die gekapselte Animationsvariable, die die obere Begrenzung des Animationsrechtecks darstellt.

CAnimationVariable m_topValue;

CAnimationRect::operator RECT

Konvertiert eine CAnimationRect in RECT.

operator RECT();

Rückgabewert

Aktueller Wert des Animationsrechtecks als RECT.

Hinweise

Diese Funktion ruft intern GetValue auf. Wenn GetValue aus irgendeinem Grund fehlschlägt, enthält das zurückgegebene RECT Standardwerte für alle Rechteckkoordinaten.

CAnimationRect::operator=

Weist "rect" CAnimationRect zu.

void operator=(const RECT& rect);

Parameter

rect
Der neue Wert des Animationsrechtecks.

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.

CAnimationRect::SetDefaultValue

Legt den Standardwert fest.

void SetDefaultValue(const CRect& rect);

Parameter

rect
Gibt neue Standardwerte für links, oben, rechts und unten an.

Hinweise

Verwenden Sie diese Funktion, um einen Standardwert auf ein Animationsobjekt festzulegen. Diese Methoden weisen den Grenzen des Rechtecks 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