CAnimationPoint 类

实现可对点坐标进行动画处理的点功能。

语法

class CAnimationPoint : public CAnimationBaseObject;

成员

公共构造函数

名称	描述
CAnimationPoint::CAnimationPoint	已重载。 构造 CAnimationPoint 对象。

公共方法

名称	描述
CAnimationPoint::AddTransition	为 X 坐标和 Y 坐标添加切换。
CAnimationPoint::GetDefaultValue	返回 X 坐标和 Y 坐标的默认值。
CAnimationPoint::GetValue	返回当前值。
CAnimationPoint::GetX	提供对 CAnimationVariable X 坐标的访问权限。
CAnimationPoint::GetY	提供对 CAnimationVariable Y 坐标的访问权限。
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 将其添加到动画控制器，然后为每个要应用于 X 和/或 Y 坐标的切换调用 AddTransition。

继承层次结构

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
指定组 ID。

nObjectID
指定对象 ID。

dwUserData
指定用户定义的数据。

注解

构造具有默认属性的 CAnimationPoint 对象。 默认点坐标、组 ID 和对象 ID 设置为零。

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 的引用。

备注

可以调用此方法来直接访问表示 Y 坐标的基础 CAnimationVariable。

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 坐标的基础 COM 对象（如果已创建这些对象）。 如果为该动画对象订阅了事件（ValueChanged 或 IntegerValueChanged），请重新启用这些事件。

CAnimationPoint::SetDefaultValue

设置默认值。

void SetDefaultValue(const POINT& ptDefault);

参数

ptDefault
指定默认点值。

备注

使用此函数将默认值设置为动画对象。 此方法将默认值分配给动画点的 X 坐标和 Y 坐标。 如果已创建基础 COM 对象，它还会重新创建这些对象。 如果为该动画对象订阅了事件（ValueChanged 或 IntegerValueChanged），请重新启用这些事件。

另请参阅

类