CAnimationValue 類別

發行項
10/12/2023

實作有一個值的動畫物件功能。

語法

class CAnimationValue : public CAnimationBaseObject;

成員

公用建構函式

名稱	描述
CAnimationValue：：CAnimationValue	已多載。建構 CAnimationValue 物件。

公用方法

名稱	描述
CAnimationValue：：AddTransition	加入要套用至值的轉換。
CAnimationValue：：GetValue	已多載。擷取目前的值。
CAnimationValue：：GetVariable	提供封裝動畫變數的存取權。
CAnimationValue：：SetDefaultValue	設定預設值。

受保護的方法

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

公用運算子

名稱	描述
CAnimationValue：：operator DOUBLE	提供 CAnimationValue 與 DOUBLE 之間的轉換。
CAnimationValue：：operator INT32	提供 CAnimationValue 與 INT32 之間的轉換。
CAnimationValue：：operator=	已多載。將 INT32 值指派給 CAnimationValue。

受保護的資料成員

名稱	描述
CAnimationValue：：m_value	表示動畫值的封裝動畫變數。

備註

CAnimationValue 類別會封裝單一 CAnimationVariable 物件，而且可以在應用程式中以單一動畫值表示。例如，您可以使用這個類別來建立動畫透明度（淡出效果）、角度（旋轉物件），或根據單一動畫值建立動畫時的任何其他情況。若要在應用程式中使用此類別，只要具現化此類別的物件，請使用 CAnimationController：：AddAnimationObject 將它新增至動畫控制器，並針對要套用至值的每個轉換呼叫 AddTransition。

繼承階層架構

CObject

CAnimationBaseObject

CAnimationValue

需求

標頭： afxanimationcontroller.h

CAnimationValue：：AddTransition

加入要套用至值的轉換。

void AddTransition(CBaseTransition* pTransition);

參數

pTransition
轉換物件的指標。

備註

呼叫此函式，將轉換新增至要套用至動畫變數的內部轉換清單。當您新增轉換時，它們不會立即套用，並儲存在內部清單中。當您呼叫 CAnimationController：：AnimateGroup 時，會套用轉換（新增至特定值的分鏡腳本）。

CAnimationValue：：CAnimationValue

建構 CAnimationValue 物件。

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

參數

dblDefaultValue
指定預設值。

nGroupID
指定群組識別碼。

nObjectID
指定物件識別碼。

dwUserData
指定使用者定義數據。

備註

使用預設屬性建構 CAnimationValue 對象：預設值、群組標識碼和物件識別碼設定為 0。

CAnimationValue：：GetAnimationVariableList

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

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

參數

lst
當函式傳回時，它會包含代表動畫值的 CAnimationVariable 指標。

CAnimationValue：：GetValue

擷取目前的值。

BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);

參數

dblValue
輸出。當函式傳回時，它包含動畫變數的目前值。

nValue
輸出。當函式傳回時，它包含動畫變數的目前值。

傳回值

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

備註

呼叫此函式以擷取目前的值。這個實作會呼叫封裝的 COM 物件，如果呼叫失敗，這個方法會傳回先前在建構函式或 SetDefaultValue 中設定的預設值。

CAnimationValue：：GetVariable

提供封裝動畫變數的存取權。

CAnimationVariable& GetVariable();

傳回值

封裝動畫變數的參考。

備註

使用這個方法來存取封裝的動畫變數。您可以從 CAnimationVariable 存取基礎 IUIAnimationVariable 物件，如果尚未建立動畫變數，其指標可以是 NULL。

CAnimationValue：：m_value

表示動畫值的封裝動畫變數。

CAnimationVariable m_value;

CAnimationValue：：operator DOUBLE

提供 CAnimationValue 與 DOUBLE 之間的轉換。

operator DOUBLE();

傳回值

動畫值的目前值。

備註

提供 CAnimationValue 與 DOUBLE 之間的轉換。此方法會在內部呼叫 GetValue，且不會檢查是否有錯誤。如果 GetValue 失敗，傳回的值會包含先前在建構函式中設定的預設值，或是使用 SetDefaultValue。

CAnimationValue：：operator INT32

提供 CAnimationValue 與 INT32 之間的轉換。

operator INT32();

傳回值

動畫值目前的值為整數。

備註

提供 CAnimationValue 與 INT32 之間的轉換。此方法會在內部呼叫 GetValue，且不會檢查是否有錯誤。如果 GetValue 失敗，傳回的值會包含先前在建構函式中設定的預設值，或是使用 SetDefaultValue。

CAnimationValue：：operator=

將 DOUBLE 值指派給 CAnimationValue。

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

參數

dblVal
指定要指派給動畫值的值。

nVal
指定要指派給動畫值的值。

備註

將 DOUBLE 值指派給 CAnimationValue。此值會設定為封裝動畫變數的預設值。如果您將此動畫物件訂閱至事件（ValueChanged 或 IntegerValueChanged），則必須重新啟用這些事件。

CAnimationValue：：SetDefaultValue

設定預設值。

void SetDefaultValue(DOUBLE dblDefaultValue);

參數