CBaseTransition 類別

文章
08/04/2024

表示基本轉換。

語法

class CBaseTransition : public CObject;

成員

公用列舉類型

名稱	描述
CBaseTransition：：TRANSITION_TYPE 列舉	定義 Windows 動畫 API MFC 實作目前支援的轉換類型。

公用建構函式

名稱	描述
CBaseTransition：：CBaseTransition	建構基底轉換物件。
CBaseTransition：：~CBaseTransition	解構函式。當轉換物件被終結時呼叫。

公用方法

名稱	描述
CBaseTransition：：AddToStoryboard	將轉換新增至分鏡腳本。
CBaseTransition：：AddToStoryboardAtKeyframes	將轉換新增至分鏡腳本。
CBaseTransition：：Clear	釋放封裝的 IUIAnimationTransition COM 物件。
CBaseTransition：：Create	建立 COM 轉換。
CBaseTransition：：GetEndKeyframe	會傳回開始主要畫面格。
CBaseTransition：：GetRelatedVariable	傳回相關變數的指標。
CBaseTransition：：GetStartKeyframe	會傳回開始主要畫面格。
CBaseTransition：：GetTransition	已多載。傳回基礎 COM 轉換物件的指標。
CBaseTransition：：GetType	傳回轉換類型。
CBaseTransition：：IsAdded	指出轉換是否已新增至分鏡腳本。
CBaseTransition：：SetKeyframes	設定轉換的主要畫面格。
CBaseTransition：：SetRelatedVariable	建立動畫變數與轉換之間的關聯性。

受保護的資料成員

名稱	描述
CBaseTransition：：m_bAdded	指定轉換是否已新增至分鏡腳本。
CBaseTransition：：m_pEndKeyframe	儲存指定轉換結尾之主要畫面格的指標。
CBaseTransition：：m_pRelatedVariable	動畫變數的指標，會以儲存在 m_transition 中的轉換產生動畫效果。
CBaseTransition：：m_pStartKeyframe	儲存主要畫面格的指標，指定轉換的開頭。
CBaseTransition：：m_transition	儲存 IUIAnimationTransition 的指標。如果尚未建立 COM 轉換物件，則為 NULL。
CBaseTransition：：m_type	儲存轉換類型。

備註

這個類別會封裝 IUIAnimationTransition 介面，並做為所有轉換的基類。

繼承階層架構

CObject

CBaseTransition

需求

標頭： afxanimationcontroller.h

CBaseTransition：：~CBaseTransition

解構函式。當轉換物件被終結時呼叫。

virtual ~CBaseTransition();

CBaseTransition：：AddToStoryboard

將轉換新增至分鏡腳本。

BOOL AddToStoryboard(IUIAnimationStoryboard* pStoryboard);

參數

pStoryboard
分鏡腳本的指標，其會以動畫顯示相關變數。

傳回值

TRUE 是表示如果已成功將轉換新增至分鏡腳本。

備註

將轉換套用至分鏡腳本中的相關變數。如果這是此分鏡腳本中套用至此變數的第一個轉換，轉換會從分鏡腳本的開頭開始。否則，轉換會附加至最近新增至變數的轉換。

CBaseTransition：：AddToStoryboardAtKeyframes

將轉換新增至分鏡腳本。

BOOL AddToStoryboardAtKeyframes(IUIAnimationStoryboard* pStoryboard);

參數

pStoryboard
分鏡腳本的指標，其會以動畫顯示相關變數。

傳回值

TRUE 是表示如果已成功將轉換新增至分鏡腳本。

備註

將轉換套用至分鏡腳本中的相關變數。如果指定啟動主要畫面格，轉換會從該主要畫面格開始。如果指定了結束主要畫面格，轉換會從開始主要畫面格開始，並在結束主要畫面格停止。如果使用指定的持續時間參數建立轉換，則會以開始和結束主要畫面格之間的持續時間覆寫該持續時間。如果未指定任何主要畫面格，轉換會附加至最近新增至變數的轉換。

CBaseTransition：：CBaseTransition

建構基底轉換物件。

CBaseTransition();

CBaseTransition：：Clear

釋放封裝的 IUIAnimationTransition COM 物件。

void Clear();

備註

這個方法應該從衍生類別的 Create 方法呼叫，以避免 IUITransition 介面流失。

CBaseTransition：：Create

建立 COM 轉換。

virtual BOOL Create(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* pFactory) = 0;

參數

pLibrary
轉換連結庫的指標，可建立標準轉換。自訂轉換可以是 NULL。

pFactory
轉換處理站的指標，可建立自定義轉換。標準轉換可以是 NULL。

傳回值

如果成功建立轉換 COM 物件，則為TRUE;否則為 FALSE。

備註

這是必須在衍生類別中覆寫的純虛擬函式。架構會呼叫它來具現化基礎 COM 轉換物件。

CBaseTransition：：GetEndKeyframe

會傳回開始主要畫面格。

CBaseKeyFrame* GetEndKeyframe();

傳回值

主要畫面格的有效指標，如果不應該在主要畫面格之間插入轉換，則為 NULL。

備註

這個方法可用來存取先前由 SetKeyframes 設定的主要畫面格物件。當轉換新增至分鏡腳本時，由最上層程式代碼呼叫。

CBaseTransition：：GetRelatedVariable

傳回相關變數的指標。

CAnimationVariable* GetRelatedVariable();

傳回值

動畫變數的有效指標，如果 SetRelatedVariable 尚未設定動畫變數，則為 NULL。

備註

這是相關動畫變數的存取子。

CBaseTransition：：GetStartKeyframe

會傳回開始主要畫面格。

CBaseKeyFrame* GetStartKeyframe();

傳回值

主要畫面格的有效指標，如果轉換不應該在主要畫面格之後啟動，則為 NULL。

備註

這個方法可用來存取先前由 SetKeyframes 設定的主要畫面格物件。當轉換新增至分鏡腳本時，由最上層程式代碼呼叫。

CBaseTransition：：GetTransition

傳回基礎 COM 轉換物件的指標。

IUIAnimationTransition* GetTransition(
    IUIAnimationTransitionLibrary* pLibrary,
    IUIAnimationTransitionFactory* pFactory);

IUIAnimationTransition* GetTransition();

參數

pLibrary
轉換連結庫的指標，可建立標準轉換。自訂轉換可以是 NULL。

pFactory
轉換處理站的指標，可建立自定義轉換。標準轉換可以是 NULL。

傳回值

如果無法建立基礎轉換，則為IUIAnimationTransition 或NULL的有效指標。

備註

這個方法會傳回基礎 COM 轉換物件的指標，並視需要建立它。

CBaseTransition：：GetType

傳回轉換類型。

TRANSITION_TYPE GetType() const;

傳回值

其中一個TRANSITION_TYPE列舉值。

備註

這個方法可用來依其類型識別轉換物件。型別是在衍生類別的建構函式中設定。

CBaseTransition：：IsAdded

指出轉換是否已新增至分鏡腳本。

BOOL IsAdded();

傳回值

如果轉換已新增至分鏡腳本，則傳回 TRUE，否則傳回 FALSE。

備註

當最上層程式代碼將轉換新增至分鏡腳本時，會在內部設定此旗標。

CBaseTransition：：m_bAdded

指定轉換是否已新增至分鏡腳本。

BOOL m_bAdded;

CBaseTransition：：m_pEndKeyframe

儲存指定轉換結尾之主要畫面格的指標。

CBaseKeyFrame* m_pEndKeyframe;

CBaseTransition：：m_pRelatedVariable

動畫變數的指標，會以儲存在 m_transition 中的轉換產生動畫效果。

CAnimationVariable* m_pRelatedVariable;

CBaseTransition：：m_pStartKeyframe

儲存主要畫面格的指標，指定轉換的開頭。

CBaseKeyFrame* m_pStartKeyframe;

CBaseTransition：：m_transition

儲存 IUIAnimationTransition 的指標。如果尚未建立 COM 轉換物件，則為 NULL。

ATL::CComPtr<IUIAnimationTransition> m_transition;

CBaseTransition：：m_type

儲存轉換類型。

TRANSITION_TYPE m_type;

CBaseTransition：：SetKeyframes

設定轉換的主要畫面格。

void SetKeyframes(
    CBaseKeyFrame* pStart = NULL,
    CBaseKeyFrame* pEnd = NULL);

參數

pStart
指定轉換開頭的主要畫面格。

pEnd
指定轉換結尾的主要畫面格。

備註

這個方法會告知轉換在指定的主要畫面格之後開始，而且選擇性地，如果 pEnd 不是 NULL，則會在指定的主要畫面格之前結束。如果使用指定的持續時間參數建立轉換，則會以開始和結束主要畫面格之間的持續時間覆寫該持續時間。

CBaseTransition：：SetRelatedVariable

建立動畫變數與轉換之間的關聯性。

void SetRelatedVariable(CAnimationVariable* pVariable);

參數

pVariable
相關動畫變數的指標。

備註

建立動畫變數與轉換之間的關聯性。轉換只能套用至一個變數。

CBaseTransition：：TRANSITION_TYPE 列舉

定義 Windows 動畫 API MFC 實作目前支援的轉換類型。

enum TRANSITION_TYPE;

備註

轉換類型是在特定轉換的建構函式中設定。例如，CSinusoidalTransitionFromRange 會將其類型設定為 SINUSOIDAL_FROM_RANGE。

另請參閱

類別

分享方式：