CAnimationColor 類別

發行項
08/04/2024

實作紅色、綠色和藍色元件可以動畫顯示的色彩功能。

語法

class CAnimationColor : public CAnimationBaseObject;

成員

公用建構函式

名稱	描述
CAnimationColor：：CAnimationColor	已多載。建構動畫色彩物件。

公用方法

名稱	描述
CAnimationColor：：AddTransition	新增紅色、綠色和藍色元件的轉換。
CAnimationColor：：GetB	提供代表Blue元件的 CAnimationVariable 存取權。
CAnimationColor：：GetDefaultValue	傳回色彩元件的預設值。
CAnimationColor：：GetG	提供代表綠色元件的 CAnimationVariable 存取權。
CAnimationColor：：GetR	提供代表 Red 元件的 CAnimationVariable 存取權。
CAnimationColor：：GetValue	傳回目前的值。
CAnimationColor：：SetDefaultValue	設定預設值。

受保護的方法

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

公用運算子

名稱	描述
CAnimationColor：：operator COLORREF
CAnimationColor：：operator=	將色彩指派給 CAnimationColor。

受保護的資料成員

名稱	描述
CAnimationColor：：m_bValue	表示動畫色彩藍色元件的封裝動畫變數。
CAnimationColor：：m_gValue	封裝的動畫變數，代表動畫色彩的綠色元件。
CAnimationColor：：m_rValue	表示動畫色彩紅色元件的封裝動畫變數。

備註

CAnimationColor 類別會封裝三個 CAnimationVariable 物件，而且可以在應用程式中以色彩表示。例如，您可以使用這個類別，以動畫顯示畫面上任何物件的色彩（例如文字色彩、背景色彩等）。若要在應用程式中使用此類別，只要具現化此類別的物件，請使用 CAnimationController：：AddAnimationObject 將它新增至動畫控制器，並針對要套用至 Red、Green 和 Blue 元件的每個轉換呼叫 AddTransition。

繼承階層架構

CObject

CAnimationBaseObject

CAnimationColor

需求

標頭： afxanimationcontroller.h

CAnimationColor：：AddTransition

新增紅色、綠色和藍色元件的轉換。

void AddTransition(
    CBaseTransition* pRTransition,
    CBaseTransition* pGTransition,
    CBaseTransition* pBTransition);

參數

pRTransition
轉換紅色元件。

pGTransition
綠色元件的轉換。

pBTransition
藍色元件的轉換。

備註

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

CAnimationColor：：CAnimationColor

建構 CAnimationColor 物件。

CAnimationColor();

CAnimationColor(
    COLORREF color,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

參數

color
指定預設色彩。

nGroupID
指定群組識別碼。

nObjectID
指定物件識別碼。

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

備註

物件是使用紅色、綠色、藍色、對象標識元和群組標識符的預設值所建構，而此標識符會設定為0。稍後可以使用 SetDefaultValue 和 SetID 在運行時間變更它們。

CAnimationColor：：GetAnimationVariableList

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

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

參數

lst
當函式傳回時，它會包含三個 CAnimationVariable 物件的指標，代表紅色、綠色和藍色元件。

CAnimationColor：：GetB

提供代表Blue元件的 CAnimationVariable 存取權。

CAnimationVariable& GetB();

傳回值

代表Blue元件的封裝 CAnimationVariable 參考。

備註

您可以呼叫此方法，以直接存取代表Blue元件的基礎 CAnimationVariable。

CAnimationColor：：GetDefaultValue

傳回色彩元件的預設值。

COLORREF GetDefaultValue();

傳回值

包含 RGB 元件的預設值的 COLORREF 值。

備註

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

CAnimationColor：：GetG

提供代表綠色元件的 CAnimationVariable 存取權。

CAnimationVariable& GetG();

傳回值

封裝的 CAnimationVariable 參考，代表綠色元件。

備註

您可以呼叫此方法，以直接存取代表綠色元件的基礎 CAnimationVariable。

CAnimationColor：：GetR

提供代表 Red 元件的 CAnimationVariable 存取權。

CAnimationVariable& GetR();

傳回值

代表 Red 元件的封裝 CAnimationVariable 參考。

備註

您可以呼叫此方法，以直接存取代表 Red 元件的基礎 CAnimationVariable。

CAnimationColor：：GetValue

傳回目前的值。

BOOL GetValue(COLORREF& color);

參數

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

傳回值

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

備註

呼叫此函式以擷取動畫色彩的目前值。如果這個方法失敗或色彩元件的基礎 COM 物件尚未初始化，色彩會包含預設值，其先前是在建構函式或 SetDefaultValue 中設定。

CAnimationColor：：m_bValue

表示動畫色彩藍色元件的封裝動畫變數。

CAnimationVariable m_bValue;

CAnimationColor：：m_gValue

封裝的動畫變數，代表動畫色彩的綠色元件。

CAnimationVariable m_gValue;

CAnimationColor：：m_rValue

表示動畫色彩紅色元件的封裝動畫變數。

CAnimationVariable m_rValue;

CAnimationColor：：operator COLORREF

operator COLORREF();

傳回值

CAnimationColor：：operator=

將色彩指派給 CAnimationColor。

void operator=(COLORREF color);

參數

color
指定新的值動畫色彩。

備註

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

CAnimationColor：：SetDefaultValue

設定預設值。

void SetDefaultValue(COLORREF color);

參數

color
指定紅色、綠色和藍色元件的新預設值。

備註

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

另請參閱

類別

共用方式為