CKeyFrame 类

表示动画关键帧。

语法

class CKeyFrame : public CBaseKeyFrame;

成员

公共构造函数

名称	描述
CKeyFrame::CKeyFrame	已重载。 构造依赖于其他关键帧的关键帧。

公共方法

名称	描述
CKeyFrame::AddToStoryboard	向情节提要添加关键帧。 （替代 CBaseKeyFrame::AddToStoryboard。）
CKeyFrame::AddToStoryboardAfterTransition	在转换后向情节提要添加关键帧。
CKeyFrame::AddToStoryboardAtOffset	在偏移处向情节提要添加关键帧。
CKeyFrame::GetExistingKeyframe	返回指向此关键帧所依赖的关键帧的指针。
CKeyFrame::GetOffset	返回与其他关键帧之间的偏移。
CKeyFrame::GetTransition	返回指向此关键帧所依赖的转换的指针。

受保护的数据成员

名称	描述
CKeyFrame::m_offset	指定此关键帧与存储在 m_pExistingKeyFrame 中的关键帧之间的偏移。
CKeyFrame::m_pExistingKeyFrame	存储指向现有关键帧的指针。 此关键帧将添加到情节提要中，其中 m_offset 添加到现有关键帧。
CKeyFrame::m_pTransition	存储指向从此关键帧开始的转换的指针。

备注

此类实现动画关键帧。 关键帧表示情节提要中的某个时刻，可用于指定转换的开始和结束时间。 关键帧可基于其他关键帧并具有偏移（以秒为单位），或者可基于转换并表示该转换结束的时刻。

继承层次结构

CObject

CBaseKeyFrame

CKeyFrame

要求

标头： afxanimationcontroller.h

CKeyFrame::AddToStoryboard

向情节提要添加关键帧。

virtual BOOL AddToStoryboard(
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDeepAdd);

参数

pStoryboard
指向情节提要的指针。

bDeepAdd
指定是否以递归方式添加关键帧或转换。

返回值

TRUE，如果成功添加关键帧。

注解

此方法将关键帧添加到情节提要。 如果此方法依赖于其他关键帧或转换并且 bDeepAdd 为 TRUE，则会尝试以递归方式添加它们。

CKeyFrame::AddToStoryboardAfterTransition

在转换后向情节提要添加关键帧。

BOOL AddToStoryboardAfterTransition(
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDeepAdd);

参数

pStoryboard
指向情节提要的指针。

bDeepAdd
指定是否以递归方式添加转换。

返回值

TRUE，如果成功添加关键帧。

备注

此函数有框架调用，以在转换后向情节提要添加关键帧。

CKeyFrame::AddToStoryboardAtOffset

在偏移处向情节提要添加关键帧。

virtual BOOL AddToStoryboardAtOffset(
    IUIAnimationStoryboard* pStoryboard,
    BOOL bDeepAdd);

参数

pStoryboard
指向情节提要的指针。

bDeepAdd
指定是否以递归方式添加此关键帧依赖的关键帧。

返回值

TRUE，如果成功添加关键帧。

备注

此函数由框架调用，以在偏移时将关键帧添加到情节提要。

CKeyFrame::CKeyFrame

构造一个依赖于转换的关键帧。

CKeyFrame(CBaseTransition* pTransition);

CKeyFrame(
    CBaseKeyFrame* pKeyframe,
    UI_ANIMATION_SECONDS offset = 0.0);

参数

pTransition
指向转换的指针。

pKeyframe
指向关键帧的指针。

offset
由 pKeyframe 指定的关键帧的偏移量（以秒为单位）。

备注

当指定的转换结束时，构造的关键帧将表示情节提要中的某个时刻。

CKeyFrame::GetExistingKeyframe

返回指向此关键帧所依赖的关键帧的指针。

CBaseKeyFrame* GetExistingKeyframe();

返回值

指向关键帧的有效指针，如果此关键帧不依赖于其他关键帧，则为 NULL。

备注

这是此关键帧所依赖的关键帧的访问器。

CKeyFrame::GetOffset

返回与其他关键帧之间的偏移。

UI_ANIMATION_SECONDS GetOffset();

返回值

与其他关键帧之间的偏移（以秒为单位）。

注解

应调用此方法来确定与其他关键帧之间的偏移（以秒为单位）。

CKeyFrame::GetTransition

返回指向此关键帧所依赖的转换的指针。

CBaseTransition* GetTransition();

返回值

指向转换的有效指针；如果此关键帧不依赖于转换，则为 NULL。

注解

这是此关键帧所依赖的转换的访问器。

CKeyFrame::m_offset

指定此关键帧与存储在 m_pExistingKeyFrame 中的关键帧之间的偏移。

UI_ANIMATION_SECONDS m_offset;

CKeyFrame::m_pExistingKeyFrame

存储指向现有关键帧的指针。 此关键帧将添加到情节提要中，其中 m_offset 添加到现有关键帧。

CBaseKeyFrame* m_pExistingKeyFrame;

CKeyFrame::m_pTransition

存储指向从此关键帧开始的转换的指针。

CBaseTransition* m_pTransition;

另请参阅

类