CAnimationSize 類別
實作可以動畫顯示其維度的大小物件功能。
語法
class CAnimationSize : public CAnimationBaseObject;
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CAnimationSize：：CAnimationSize | 已多載。 建構動畫大小物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CAnimationSize：：AddTransition | 新增 Width 和 Height 的轉換。 |
| CAnimationSize：：GetCX | 提供代表 Width 的 CAnimationVariable 存取權。 |
| CAnimationSize：：GetCY | 提供代表 Height 的 CAnimationVariable 存取權。 |
| CAnimationSize：：GetDefaultValue | 傳回 Width 和 Height 的預設值。 |
| CAnimationSize：：GetValue | 傳回目前的值。 |
| CAnimationSize：：SetDefaultValue | 設定預設值。 |
受保護的方法
| 名稱 | 描述 |
|---|---|
| CAnimationSize：：GetAnimationVariableList | 將封裝的動畫變數放入清單中。 （覆寫 CAnimationBaseObject：：GetAnimationVariableList.） |
公用運算子
| 名稱 | 描述 |
|---|---|
| CAnimationSize：：operator CSize | 將 CAnimationSize 轉換成 CSize。 |
| CAnimationSize：：operator= | 將 szSrc 指派給 CAnimationSize。 |
受保護的資料成員
| 名稱 | 描述 |
|---|---|
| CAnimationSize：：m_cxValue | 表示動畫大小的寬度的封裝動畫變數。 |
| CAnimationSize：：m_cyValue | 表示動畫大小高度的封裝動畫變數。 |
備註
CAnimationSize 類別會封裝兩個 CAnimationVariable 物件，而且可以在應用程式中表示大小。 例如，您可以使用這個類別，以動畫顯示螢幕上任何二維物件的大小（例如矩形、控件等）。 若要在應用程式中使用此類別，只要具現化此類別的物件，請使用 CAnimationController：：AddAnimationObject 將它新增至動畫控制器，並針對要套用至 Width 和/或 Height 的每個轉換呼叫 AddTransition。
繼承階層架構
CAnimationSize
需求
標頭： afxanimationcontroller.h
CAnimationSize：：AddTransition
新增 Width 和 Height 的轉換。
void AddTransition(
CBaseTransition* pCXTransition,
CBaseTransition* pCYTransition);
參數
pCXTransition
要轉換 Width 的指標。
pCYTransition
Height 轉換的指標。
備註
呼叫此函式，將指定的轉換新增至要套用至 Width 和 Height 之動畫變數的內部轉換清單。 當您新增轉換時，它們不會立即套用，並儲存在內部清單中。 當您呼叫 CAnimationController：：AnimateGroup 時，會套用轉換（新增至特定值的分鏡腳本）。 如果您不需要將轉換套用至其中一個維度，您可以傳遞NULL。
CAnimationSize：：CAnimationSize
建構動畫大小物件。
CAnimationSize();
CAnimationSize(
const CSize& szDefault,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
參數
szDefault
指定預設大小。
nGroupID
指定群組識別碼。
nObjectID
指定物件識別碼。
dwUserData
指定使用者定義的數據。
備註
對像是使用寬度、高度、對象標識碼和群組標識碼的預設值所建構，其設定為0。 稍後可以使用 SetDefaultValue 和 SetID 在運行時間變更它們。
CAnimationSize：：GetAnimationVariableList
將封裝的動畫變數放入清單中。
virtual void GetAnimationVariableList(
CList<CAnimationVariable*,
CAnimationVariable*>& lst);
參數
lst
當函式傳回時，它會包含代表寬度和高度的兩個 CAnimationVariable 物件的指標。
CAnimationSize：：GetCX
提供代表 Width 的 CAnimationVariable 存取權。
CAnimationVariable& GetCX();
傳回值
表示 Width 之封裝 CAnimationVariable 的參考。
備註
您可以呼叫此方法，以直接存取代表 Width 的基礎 CAnimationVariable。
CAnimationSize：：GetCY
提供代表 Height 的 CAnimationVariable 存取權。
CAnimationVariable& GetCY();
傳回值
表示 Height 之封裝 CAnimationVariable 的參考。
備註
您可以呼叫此方法，以直接存取代表 Height 的基礎 CAnimationVariable。
CAnimationSize：：GetDefaultValue
傳回 Width 和 Height 的預設值。
CSize GetDefaultValue();
傳回值
包含預設值的 CSize 物件。
備註
呼叫此函式來擷取預設值，其先前是由建構函式或 SetDefaultValue 所設定。
CAnimationSize：：GetValue
傳回目前的值。
BOOL GetValue(CSize& szValue);
參數
szValue
輸出。 當這個方法傳回時，包含目前的值。
傳回值
如果已成功擷取目前值，則為TRUE;否則為 FALSE。
備註
呼叫此函式以擷取動畫大小的目前值。 如果這個方法失敗或 Width 和 Size 的基礎 COM 物件尚未初始化，szValue 會包含預設值，其先前是在建構函式中或由 SetDefaultValue 所設定。
CAnimationSize：：m_cxValue
表示動畫大小的寬度的封裝動畫變數。
CAnimationVariable m_cxValue;
CAnimationSize：：m_cyValue
表示動畫大小高度的封裝動畫變數。
CAnimationVariable m_cyValue;
CAnimationSize：：operator CSize
將 CAnimationSize 轉換成 CSize。
operator CSize();
傳回值
動畫大小的目前值，以 CSize 表示。
備註
此函式會在內部呼叫 GetValue。 如果 GetValue 因為某些原因而失敗，傳回的大小將會包含 Width 和 Height 的預設值。
CAnimationSize：：operator=
將 szSrc 指派給 CAnimationSize。
void operator=(const CSize& szSrc);
參數
szSrc
是指 CSize 或 SIZE。
備註
將 szSrc 指派給 CAnimationSize。 建議您在動畫開始之前執行此動作，因為此運算符會呼叫 SetDefaultValue，這會在建立 Width 和 Height 的基礎 COM 物件時重新建立這些物件。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），則必須重新啟用這些事件。
CAnimationSize：：SetDefaultValue
設定預設值。
void SetDefaultValue(const CSize& szDefault);
參數
szDefault
指定新的預設大小。
備註
使用此函式將預設值設定為動畫物件。 此方法會將預設值指派給動畫大小的 Width 和 Height。 如果已建立基礎 COM 物件，也會重新建立它們。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），則必須重新啟用這些事件。