CAnimationPoint 類別

實作可以動畫顯示其座標的點功能。

語法

class CAnimationPoint : public CAnimationBaseObject;

成員

公用建構函式

名稱	描述
CAnimationPoint::CAnimationPoint	已多載。 CAnimationPoint建構物件。

公用方法

名稱	描述
CAnimationPoint::AddTransition	新增 X 和 Y 座標的轉換。
CAnimationPoint::GetDefaultValue	傳回 X 和 Y 座標的預設值。
CAnimationPoint::GetValue	傳回目前的值。
CAnimationPoint::GetX	提供 X 座標的 CAnimationVariable 存取權。
CAnimationPoint::GetY	提供 Y 座標的 CAnimationVariable 存取權。
CAnimationPoint::SetDefaultValue	設定預設值。

受保護的方法

名稱	描述
CAnimationPoint::GetAnimationVariableList	將封裝的動畫變數放入清單中。 重寫 CAnimationBaseObject::GetAnimationVariableList

公用運算子

名稱	描述
CAnimationPoint::operator CPoint	將 CAnimationPoint 轉換成 CPoint。
CAnimationPoint::operator=	ptSrc指定給 CAnimationPoint。

受保護的資料成員

名稱	描述
CAnimationPoint::m_xValue	表示動畫點 X 座標的封裝動畫變數。
CAnimationPoint::m_yValue	封裝的動畫變數，表示動畫點的 Y 座標。

備註

類別 CAnimationPoint 會封裝兩個 CAnimationVariable 物件，而且可以在應用程式一個點中表示。 例如，您可以使用這個類別，以動畫顯示螢幕上任何物件的位置，例如文字字串、圓形、點等等。 若要在應用程式中使用此類別，只要具現化這個類別的物件，請使用 CAnimationController::AddAnimationObject將它新增至動畫控制器，並呼叫 AddTransition 每個要套用至 X 和/或 Y 座標的轉換。

繼承階層架構

CObject
CAnimationBaseObject
CAnimationPoint

需求

頁眉： afxanimationcontroller.h

CAnimationPoint::AddTransition

新增 X 和 Y 座標的轉換。

void AddTransition(
    CBaseTransition* pXTransition,
    CBaseTransition* pYTransition);

參數

pXTransition
X 座標轉換的指標。

pYTransition
要轉換 Y 座標的指標。

備註

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

CAnimationPoint::CAnimationPoint

建構 CAnimationPoint 物件。

CAnimationPoint();

CAnimationPoint(
    const CPoint& ptDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

參數

ptDefault
指定預設點座標。

nGroupID
指定群組識別碼。

nObjectID
指定物件識別碼。

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

備註

CAnimationPoint使用預設屬性建構物件。 默認點座標[群組標識符] 和 [物件標識符] 會設定為零。

CAnimationPoint::GetAnimationVariableList

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

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

參數

lst
當函式傳回時，它會包含代表 X 和 Y 座標之兩個 CAnimationVariable 物件的指標。

CAnimationPoint::GetDefaultValue

傳回 X 和 Y 座標的預設值。

CPoint GetDefaultValue();

傳回值

包含預設值的點。

備註

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

CAnimationPoint::GetValue

傳回目前的值。

BOOL GetValue(CPoint& ptValue);

參數

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

傳回值

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

備註

呼叫此函式以擷取動畫點的目前值。 如果這個方法失敗，或 X 和 Y 座標的基礎 COM 物件尚未初始化， ptValue 則包含先前在建構函式或 所 SetDefaultValue設定的預設值。

CAnimationPoint::GetX

提供 X 座標的存取 CAnimationVariable 權。

CAnimationVariable& GetX();

傳回值

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

備註

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

CAnimationPoint::GetY

提供 Y 座標的存取 CAnimationVariable 權。

CAnimationVariable& GetY();

傳回值

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

備註

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

CAnimationPoint：：m_xValue

表示動畫點 X 座標的封裝動畫變數。

CAnimationVariable m_xValue;

CAnimationPoint::m_yValue

封裝的動畫變數，表示動畫點的 Y 座標。

CAnimationVariable m_yValue;

CAnimationPoint::operator CPoint

將 CAnimationPoint 轉換成 CPoint。

operator CPoint();

傳回值

目前的 值 CAnimationPoint ，當做 CPoint。

備註

這個函式會在內部呼叫 GetValue。 如果 GetValue 失敗，傳回的點將會包含 X 和 Y 座標的預設值。

CAnimationPoint::operator=

ptSrc指定給 CAnimationPoint。

void operator=(const CPoint& ptSrc);

參數

ptSrc
是指 CPoint 或 POINT。

備註

ptSrc指定給 CAnimationPoint。 建議您在動畫開始之前執行此動作，因為此運算符會呼叫 SetDefaultValue，這會在建立 X 和 Y 座標時重新建立 X 和 Y 座標的基礎 COM 物件。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），請重新啟用這些事件。

CAnimationPoint::SetDefaultValue

設定預設值。

void SetDefaultValue(const POINT& ptDefault);

參數

ptDefault
指定預設值。

備註

使用此函式將預設值設定為動畫物件。 這個方法會將預設值指派給動畫點的 X 和 Y 座標。 如果已建立基礎 COM 物件，也會重新建立它們。 如果您將此動畫物件訂閱至事件 （ValueChanged 或 IntegerValueChanged），請重新啟用這些事件。

另請參閱

類別