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），请重新启用这些事件。