CAnimationRect osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Egy téglalap funkcióit valósítja meg, amelyek oldalai animálhatók.

Szemantika

class CAnimationRect : public CAnimationBaseObject;

Tagok

Nyilvános konstruktorok

Név	Description
CAnimationRect::CAnimationRect	Túlterhelt. Animációs rect objektumot hoz létre.

Nyilvános metódusok

Név	Description
CAnimationRect::AddTransition	Áttűnéseket ad hozzá a bal, a felső, a jobb és az alsó koordinátákhoz.
CAnimationRect::GetBottom	Hozzáférést biztosít az alsó koordinátát képviselő CAnimationVariable-hez.
CAnimationRect::GetDefaultValue	A téglalapok határainak alapértelmezett értékeit adja vissza.
CAnimationRect::GetLeft	Hozzáférést biztosít a bal koordinátát képviselő CAnimationVariable-hez.
CAnimationRect::GetRight	Hozzáférést biztosít a megfelelő koordinátát képviselő CAnimationVariable-hez.
CAnimationRect::GetTop	Hozzáférést biztosít a legfelső koordinátát képviselő CAnimationVariable-hez.
CAnimationRect::GetValue	Aktuális értéket ad vissza.
CAnimationRect::SetDefaultValue	Alapértelmezett érték beállítása.

Védett metódusok

Név	Description
CAnimationRect::GetAnimationVariableList	A beágyazott animációs változókat egy listába helyezi. (Felülbírálások CAnimationBaseObject::GetAnimationVariableList.)

Nyilvános operátorok

Név	Description
CAnimationRect::operátor RECT	A CAnimationRectet RECT-re konvertálja.
CAnimationRect::operátor=	Rect hozzárendelése a CAnimationRecthez.

Nyilvános adatok tagjai

Név	Description
CAnimationRect::m_bFixedSize	Meghatározza, hogy a téglalap rögzített méretű-e.

Védett adattagok

Név	Description
CAnimationRect::m_bottomValue	A beágyazott animációs változó, amely az animációs téglalap alsó határát jelöli.
CAnimationRect::m_leftValue	A beágyazott animációs változó, amely az animációs téglalap bal határát jelöli.
CAnimationRect::m_rightValue	A beágyazott animációs változó, amely az animációs téglalap jobb határát jelöli.
CAnimationRect::m_szInitial	Az animációs téglalap kezdeti méretét adja meg.
CAnimationRect::m_topValue	A beágyazott animációs változó, amely az animációs téglalap felső határát jelöli.

Megjegyzések

A CAnimationRect osztály négy CAnimationVariable objektumot foglal magában, és egy téglalapot jelölhet az alkalmazásokban. Ha ezt az osztályt szeretné használni az alkalmazásban, csak példányosíthatja az osztály egy objektumát, adja hozzá az animációvezérlőhöz a CAnimationController::AddAnimationObject paranccsal, és hívja meg az AddTransition parancsot minden egyes áttűnéshez, amelyet a bal, jobb felső és alsó koordinátákra kell alkalmazni.

Öröklési hierarchia

CObject

CAnimationBaseObject

CAnimationRect

Requirements

Fejléc: afxanimationcontroller.h

CAnimationRect::AddTransition

Áttűnéseket ad hozzá a bal, a felső, a jobb és az alsó koordinátákhoz.

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

Paraméterek

pLeftTransition
A bal oldali áttűnést adja meg.

pTopTransition
A felső oldal áttűnését adja meg.

pRightTransition
A jobb oldali áttűnést adja meg.

pBottomTransition
Az alsó oldal átmenetét adja meg.

Megjegyzések

Hívja meg ezt a függvényt, hogy adja hozzá a megadott áttűnéseket az egyes téglalapoldalak animációs változóira alkalmazni kívánt áttűnések belső listájához. Áttűnések hozzáadásakor a rendszer nem alkalmazza őket azonnal, és egy belső listában tárolja őket. A CAnimationController::AnimateGroup hívásakor az áttűnéseket a rendszer alkalmazza (hozzáadja egy adott értékhez tartozó storyboardhoz). Ha nem kell áttűnést alkalmaznia a téglalap egyik oldalára, a NULL értéket is átadhatja.

CAnimationRect::CAnimationRect

CAnimationRect objektumot hoz létre.

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éterek

téglalap
Az alapértelmezett téglalapot adja meg.

nGroupID
Megadja a csoportazonosítót.

nObjectID
Objektumazonosítót ad meg.

dwUserData
Felhasználó által definiált adatokat ad meg.

Pt
A bal felső sarok koordinátája.

sz
Téglalap mérete.

nLeft
A bal oldali kötött koordinátát adja meg.

nTop
A felső határ koordinátáját adja meg.

nRight
A jobb kötés koordinátáját adja meg.

nBottom
Az alsó kötött koordinátát adja meg.

Megjegyzések

Az objektum a bal, a felső, a jobb és az alsó, az objektumazonosító és a csoportazonosító alapértelmezett értékeivel jön létre, amelyek értéke 0 lesz. Később, futásidőben módosíthatók a SetDefaultValue és a SetID használatával.

CAnimationRect::GetAnimationVariableList

A beágyazott animációs változókat egy listába helyezi.

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

Paraméterek

Lst
Amikor a függvény visszatér, négy CAnimationVariable objektumra mutató mutatót tartalmaz, amelyek téglalap koordinátáit jelölik.

CAnimationRect::GetBottom

Hozzáférést biztosít az alsó koordinátát képviselő CAnimationVariable-hez.

CAnimationVariable& GetBottom();

Visszaadott érték

Hivatkozás az alsó koordinátát képviselő beágyazott CAnimationVariable-ra.

Megjegyzések

Ezt a metódust úgy hívhatja meg, hogy közvetlen hozzáférést kapjon az alsó koordinátát képviselő mögöttes CAnimationVariable-hez.

CAnimationRect::GetDefaultValue

A téglalapok határainak alapértelmezett értékeit adja vissza.

CRect GetDefaultValue();

Visszaadott érték

A bal, jobb, felső és alsó alapértelmezett értékeket tartalmazó CRect érték.

Megjegyzések

Hívja meg ezt a függvényt az alapértelmezett érték lekéréséhez, amelyet korábban konstruktor vagy SetDefaultValue állított be.

CAnimationRect::GetLeft

Hozzáférést biztosít a bal koordinátát képviselő CAnimationVariable-hez.

CAnimationVariable& GetLeft();

Visszaadott érték

A bal koordinátát képviselő beágyazott CAnimationVariable-ra mutató hivatkozás.

Megjegyzések

Ezt a metódust úgy hívhatja meg, hogy közvetlen hozzáférést kapjon a bal koordinátát képviselő mögöttes CAnimationVariable-hez.

CAnimationRect::GetRight

Hozzáférést biztosít a megfelelő koordinátát képviselő CAnimationVariable-hez.

CAnimationVariable& GetRight();

Visszaadott érték

Hivatkozás a megfelelő koordinátát képviselő beágyazott CAnimationVariable-ra.

Megjegyzések

Ezt a metódust úgy hívhatja meg, hogy közvetlen hozzáférést kapjon a megfelelő koordinátát képviselő mögöttes CAnimationVariable-hez.

CAnimationRect::GetTop

Hozzáférést biztosít a legfelső koordinátát képviselő CAnimationVariable-hez.

CAnimationVariable& GetTop();

Visszaadott érték

Hivatkozás a legfelső koordinátát képviselő beágyazott CAnimationVariable-ra.

Megjegyzések

Ezt a metódust hívhatja úgy, hogy közvetlen hozzáférést kapjon a legfelső koordinátát képviselő mögöttes CAnimationVariable-hez.

CAnimationRect::GetValue

Aktuális értéket ad vissza.

BOOL GetValue(CRect& rect);

Paraméterek

téglalap
Kimeneti. Az aktuális értéket tartalmazza, amikor ez a metódus visszatér.

Visszaadott érték

IGAZ, ha az aktuális értéket sikerült beolvasni; egyéb esetben HAMIS.

Megjegyzések

Hívja meg ezt a függvényt az animációs téglalap aktuális értékének lekéréséhez. Ha ez a módszer nem működik, vagy a bal, felső, jobb és alsó COM-objektumok nem inicializálódtak, a rect az alapértelmezett értéket tartalmazza, amelyet korábban konstruktor vagy SetDefaultValue állított be.

CAnimationRect::m_bFixedSize

Meghatározza, hogy a téglalap rögzített méretű-e.

BOOL m_bFixedSize;

Megjegyzések

Ha ez a tag igaz, akkor a téglalap mérete rögzített, a jobb és az alsó értékek újraszámítása minden alkalommal, amikor a bal felső sarok a rögzített méretnek megfelelően lesz áthelyezve. Ha igaz értékre állítja ezt az értéket, egyszerűen áthelyezheti a téglalapot a képernyőn. Ebben az esetben a jobb és az alsó koordinátákra alkalmazott áttűnések figyelmen kívül lesznek hagyva. A méretet a rendszer belsőleg tárolja az objektum létrehozásakor és/vagy a SetDefaultValue meghívásakor. Alapértelmezés szerint ez a tag FALSE (HAMIS) értékre van állítva.

CAnimationRect::m_bottomValue

A beágyazott animációs változó, amely az animációs téglalap alsó határát jelöli.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

A beágyazott animációs változó, amely az animációs téglalap bal határát jelöli.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

A beágyazott animációs változó, amely az animációs téglalap jobb határát jelöli.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Az animációs téglalap kezdeti méretét adja meg.

CSize m_szInitial;

CAnimationRect::m_topValue

A beágyazott animációs változó, amely az animációs téglalap felső határát jelöli.

CAnimationVariable m_topValue;

CAnimationRect::operátor RECT

A CAnimationRectet RECT-re konvertálja.

operator RECT();

Visszaadott érték

Az animációs téglalap aktuális értéke RECT-ként.

Megjegyzések

Ez a függvény belsőleg meghívja a GetValue-t. Ha a GetValue valamilyen okból meghiúsul, a visszaadott RECT az összes téglalapkoordináta alapértelmezett értékeit tartalmazza.

CAnimationRect::operátor=

Rect hozzárendelése a CAnimationRecthez.

void operator=(const RECT& rect);

Paraméterek

téglalap
Az animációs téglalap új értéke.

Megjegyzések

Ezt javasoljuk az animáció indítása előtt, mert ez az operátor meghívja a SetDefaultValue-t, amely újra létrehozza a színösszetevők alapjául szolgáló COM-objektumokat, ha létrejöttek. Ha előfizetett erre az animációs objektumra eseményekre (ValueChanged vagy IntegerValueChanged), újra engedélyeznie kell ezeket az eseményeket.

CAnimationRect::SetDefaultValue

Alapértelmezett érték beállítása.

void SetDefaultValue(const CRect& rect);

Paraméterek

téglalap
Új alapértelmezett értékeket ad meg a bal, a felső, a jobb és az alsó értékhez.

Megjegyzések

Ezzel a függvénnyel alapértelmezett értéket állíthat be animációs objektumra. Ez a metódus alapértelmezett értékeket rendel a téglalapok határaihoz. Az alapul szolgáló COM-objektumokat is újra létrehozza, ha létrejöttek. Ha előfizetett erre az animációs objektumra eseményekre (ValueChanged vagy IntegerValueChanged), újra engedélyeznie kell ezeket az eseményeket.

Lásd még

osztályok