CAnimationRect 類別

實作可以動畫顯示其邊緣的矩形功能。

語法

class CAnimationRect : public CAnimationBaseObject;

成員

公用建構函式

名稱	描述
CAnimationRect：：CAnimationRect	已多載。 建構動畫 rect 物件。

公用方法

名稱	描述
CAnimationRect：：AddTransition	新增左、上、右和下座標的轉換。
CAnimationRect：：GetBottom	提供 CAnimationVariable 代表底部座標的存取權。
CAnimationRect：：GetDefaultValue	傳回矩形界限的預設值。
CAnimationRect：：GetLeft	提供代表左座標的 CAnimationVariable 存取權。
CAnimationRect：：GetRight	提供代表右座標的 CAnimationVariable 存取權。
CAnimationRect：：GetTop	提供代表頂端座標的 CAnimationVariable 存取權。
CAnimationRect：：GetValue	傳回目前的值。
CAnimationRect：：SetDefaultValue	設定預設值。

受保護的方法

名稱	描述
CAnimationRect：：GetAnimationVariableList	將封裝的動畫變數放入清單中。 （覆寫 CAnimationBaseObject：：GetAnimationVariableList.）

公用運算子

名稱	描述
CAnimationRect：：operator RECT	將 CAnimationRect 轉換為 RECT。
CAnimationRect：：operator=	將 rect 指派給 CAnimationRect。

公用資料成員

名稱	描述
CAnimationRect：：m_bFixedSize	指定矩形是否具有固定大小。

受保護的資料成員

名稱	描述
CAnimationRect：：m_bottomValue	表示動畫矩形下限的封裝動畫變數。
CAnimationRect：：m_leftValue	封裝的動畫變數，代表動畫矩形的左界限。
CAnimationRect：：m_rightValue	表示動畫矩形右系結的封裝動畫變數。
CAnimationRect：：m_szInitial	指定動畫矩形的初始大小。
CAnimationRect：：m_topValue	封裝的動畫變數，代表動畫矩形的頂端界限。

備註

CAnimationRect 類別會封裝四個 CAnimationVariable 物件，而且可以在應用程式矩形中表示。 若要在應用程式中使用此類別，只要具現化此類別的物件，請使用 CAnimationController：：AddAnimationObject 將它新增至動畫控制器，並針對要套用至左、右上方和底部座標的每個轉換呼叫 AddTransition。

繼承階層架構

CObject

CAnimationBaseObject

CAnimationRect

需求

標頭： afxanimationcontroller.h

CAnimationRect：：AddTransition

新增左、上、右和下座標的轉換。

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

參數

pLeftTransition
指定左側的轉換。

pTopTransition
指定頂端的轉換。

pRightTransition
指定右側的轉換。

pBottomTransition
指定底部的轉換。

備註

呼叫此函式，將指定的轉換新增至要套用至每個矩形側邊動畫變數的內部轉換清單。 當您新增轉換時，它們不會立即套用，並儲存在內部清單中。 當您呼叫 CAnimationController：：AnimateGroup 時，會套用轉換（新增至特定值的分鏡腳本）。 如果您不需要將轉換套用至其中一個矩形側邊，您可以傳遞 NULL。

CAnimationRect：：CAnimationRect

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

參數

rect
指定預設矩形。

nGroupID
指定群組識別碼。

nObjectID
指定物件識別碼。

dwUserData
指定使用者定義的數據。

pt
左上角的座標。

sz
矩形的大小。

nLeft
指定左系結的座標。

nTop
指定頂端系結的座標。

nRight
指定右系結的座標。

nBottom
指定下限的座標。

備註

物件是使用左、上、右和下、物件標識碼和群組標識碼的預設值建構，而此標識符會設定為0。 稍後可以使用 SetDefaultValue 和 SetID 在運行時間變更它們。

CAnimationRect：：GetAnimationVariableList

將封裝的動畫變數放入清單中。

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

參數

lst
當函式傳回時，它會包含代表矩形座標的四個 CAnimationVariable 物件的指標。

CAnimationRect：：GetBottom

提供 CAnimationVariable 代表底部座標的存取權。

CAnimationVariable& GetBottom();

傳回值

封裝的 CAnimationVariable 參考，代表底部座標。

備註

您可以呼叫此方法，以直接存取代表底部座標的基礎 CAnimationVariable。

CAnimationRect：：GetDefaultValue

傳回矩形界限的預設值。

CRect GetDefaultValue();

傳回值

CRect 值，包含左、右、上、下預設值。

備註

呼叫此函式來擷取預設值，其先前是由建構函式或 SetDefaultValue 所設定。

CAnimationRect：：GetLeft

提供代表左座標的 CAnimationVariable 存取權。

CAnimationVariable& GetLeft();

傳回值

表示左座標之封裝 CAnimationVariable 的參考。

備註

您可以呼叫這個方法，以直接存取代表左座標的基礎 CAnimationVariable。

CAnimationRect：：GetRight

提供代表右座標的 CAnimationVariable 存取權。

CAnimationVariable& GetRight();

傳回值

封裝的 CAnimationVariable 參考，代表右座標。

備註

您可以呼叫此方法，以直接存取代表正確座標的基礎 CAnimationVariable。

CAnimationRect：：GetTop

提供代表頂端座標的 CAnimationVariable 存取權。

CAnimationVariable& GetTop();

傳回值

封裝的 CAnimationVariable 參考，代表頂端座標。

備註

您可以呼叫此方法，以直接存取代表頂端座標的基礎 CAnimationVariable。

CAnimationRect：：GetValue

傳回目前的值。

BOOL GetValue(CRect& rect);

參數

rect
輸出。 當這個方法傳回時，包含目前的值。

傳回值

如果已成功擷取目前值，則為TRUE;否則為 FALSE。

備註

呼叫此函式以擷取動畫矩形的目前值。 如果此方法失敗或左、上、右和下層的基礎 COM 物件尚未初始化，rect 會包含預設值，先前是在建構函式或 SetDefaultValue 中設定。

CAnimationRect：：m_bFixedSize

指定矩形是否具有固定大小。

BOOL m_bFixedSize;

備註

如果這個成員為 true，則矩形的大小是固定的，而且每次根據固定大小移動左上角時，都會重新計算右下角的值。 將此值設定為TRUE，以輕鬆地將矩形移至畫面周圍。 在此情況下，會忽略套用至右座標和底部座標的轉換。 當您建構 物件和/或呼叫 SetDefaultValue 時，大小會儲存在內部。 根據預設，這個成員會設定為 FALSE。

CAnimationRect：：m_bottomValue

表示動畫矩形下限的封裝動畫變數。

CAnimationVariable m_bottomValue;

CAnimationRect：：m_leftValue

封裝的動畫變數，代表動畫矩形的左界限。

CAnimationVariable m_leftValue;

CAnimationRect：：m_rightValue

表示動畫矩形右系結的封裝動畫變數。

CAnimationVariable m_rightValue;

CAnimationRect：：m_szInitial

指定動畫矩形的初始大小。

CSize m_szInitial;

CAnimationRect：：m_topValue

封裝的動畫變數，代表動畫矩形的頂端界限。

CAnimationVariable m_topValue;

CAnimationRect：：operator RECT

將 CAnimationRect 轉換為 RECT。

operator RECT();

傳回值

動畫矩形的目前值為 RECT。

備註

此函式會在內部呼叫 GetValue。 如果 GetValue 因為某些原因而失敗，傳回的 RECT 會包含所有矩形座標的預設值。

CAnimationRect：：operator=

將 rect 指派給 CAnimationRect。

void operator=(const RECT& rect);

參數

rect
動畫矩形的新值。

備註

建議您在動畫開始之前執行此動作，因為此運算符會呼叫 SetDefaultValue，這會在建立色彩元件時重新建立基礎 COM 物件。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），則必須重新啟用這些事件。

CAnimationRect：：SetDefaultValue

設定預設值。

void SetDefaultValue(const CRect& rect);

參數

rect
指定左、上、右和下的新預設值。

備註

使用此函式將預設值設定為動畫物件。 此方法會將預設值指派給矩形的界限。 如果已建立基礎 COM 物件，也會重新建立它們。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），則必須重新啟用這些事件。

另請參閱

類別