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），請重新啟用這些事件。