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
引用 CPointPOINT

注解

ptSrc 分配给 CAnimationPoint。 建议在动画开始之前执行此操作,因为此运算符调用 SetDefaultValue,这会重新创建 X 坐标和 Y 坐标的基础 COM 对象(如果已创建这些对象)。 如果为该动画对象订阅了事件(ValueChangedIntegerValueChanged),请重新启用这些事件。

CAnimationPoint::SetDefaultValue

设置默认值。

void SetDefaultValue(const POINT& ptDefault);

参数

ptDefault
指定默认点值。

备注

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

另请参阅