CAnimationSize 类

项目
10/12/2023

实现可对大小对象的维度进行动画处理的大小对象功能。

语法

class CAnimationSize : public CAnimationBaseObject;

成员

公共构造函数

名称	描述
CAnimationSize::CAnimationSize	已重载。构造动画大小对象。

公共方法

名称	描述
CAnimationSize::AddTransition	添加宽度和高度的切换。
CAnimationSize::GetCX	提供对表示宽度的 CAnimationVariable 的访问权限。
CAnimationSize::GetCY	提供对表示高度的 CAnimationVariable 的访问权限。
CAnimationSize::GetDefaultValue	返回宽度和高度的默认值。
CAnimationSize::GetValue	返回当前值。
CAnimationSize::SetDefaultValue	设置默认值。

受保护方法

名称	描述
CAnimationSize::GetAnimationVariableList	将封装的动画变量置于列表中。（替代 CAnimationBaseObject::GetAnimationVariableList。）

公共运算符

“属性”	描述
CAnimationSize::operator CSize	将 CAnimationSize 转换为 CSize。
CAnimationSize::operator=	将 szSrc 分配至 CAnimationSize。

受保护的数据成员

名称	描述
CAnimationSize::m_cxValue	表示动画大小的宽度的封装动画变量。
CAnimationSize::m_cyValue	表示动画大小的高度的封装动画变量。

备注

CAnimationSize 类封装两个 CAnimationVariable 对象，并且可在应用程序中表示大小。例如，可使用此类对屏幕上任何二维对象（如矩形、控件等）的大小进行动画处理。若要在应用程序中使用此类，只需实例化此类的对象，使用 CAnimationController::AddAnimationObject 将其添加到动画控制器，然后为每个要应用于宽度和/或高度的切换调用 AddTransition。

继承层次结构

CObject

CAnimationBaseObject

CAnimationSize

要求

标头： afxanimationcontroller.h

CAnimationSize::AddTransition

添加宽度和高度的切换。

void AddTransition(
    CBaseTransition* pCXTransition,
    CBaseTransition* pCYTransition);

参数

pCXTransition
指向宽度切换的指针。

pCYTransition
指向高度切换的指针。

注解

调用此函数，将指定的切换添加到要应用于宽度和高度动画变量的内部切换列表。添加切换时，这些切换不会立即应用，而是存储在内部列表中。调用 CAnimationController::AnimateGroup 时应用切换效果（将其添加到情节提要来获取特定值）。如果不需要将切换效果应用到某个维度，可传递 NULL。

CAnimationSize::CAnimationSize

构造动画大小对象。

CAnimationSize();

CAnimationSize(
    const CSize& szDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

参数

szDefault
指定默认大小。

nGroupID
指定组 ID。

nObjectID
指定对象 ID。

dwUserData
指定用户定义的数据。

备注

该对象使用宽度、高度、对象 ID 和组 ID 的默认值构造，这些值将设置为 0。稍后可在运行时使用 SetDefaultValue 和 SetID 更改这些值。

CAnimationSize::GetAnimationVariableList

将封装的动画变量置于列表中。

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

参数

lst
函数返回时，它包含指向表示宽度和高度的两个 CAnimationVariable 对象的指针。

CAnimationSize::GetCX

提供对表示宽度的 CAnimationVariable 的访问权限。

CAnimationVariable& GetCX();

返回值

对表示宽度的封装 CAnimationVariable 的引用。

注解

可调用此方法来直接访问表示宽度的基础 CAnimationVariable。

CAnimationSize::GetCY

提供对表示高度的 CAnimationVariable 的访问权限。

CAnimationVariable& GetCY();

返回值

对表示高度的封装 CAnimationVariable 的引用。

备注

可调用此方法来直接访问表示高度的基础 CAnimationVariable。

CAnimationSize::GetDefaultValue

返回宽度和高度的默认值。

CSize GetDefaultValue();

返回值

包含默认值的 CSize 对象。

备注

调用此函数来检索先前由构造函数或 SetDefaultValue 设置的默认值。

CAnimationSize::GetValue

返回当前值。

BOOL GetValue(CSize& szValue);

参数

szValue
输出。此方法返回时包含当前值。

返回值

如果已成功检索当前值，则为 TRUE；否则为 FALSE。

注解

调用此函数以检索动画大小的当前值。如果此方法失败，或者尚未初始化宽度和大小对应的基础 COM 对象，则 szValue 包含先前在构造函数中或 SetDefaultValue 中设置的默认值。

CAnimationSize::m_cxValue

表示动画大小的宽度的封装动画变量。

CAnimationVariable m_cxValue;

CAnimationSize::m_cyValue

表示动画大小的高度的封装动画变量。

CAnimationVariable m_cyValue;

CAnimationSize::operator CSize

将 CAnimationSize 转换为 CSize。

operator CSize();

返回值

用作 CSize 的动画大小的当前值。

备注

此函数在内部调用 GetValue。如果 GetValue 由于某种原因失败，则返回的大小将包含宽度和高度的默认值。

CAnimationSize::operator=

将 szSrc 分配至 CAnimationSize。

void operator=(const CSize& szSrc);

参数

szSrc
指 CSize 或 SIZE。

备注

将 szSrc 分配至 CAnimationSize。建议在动画开始之前执行此操作，因为此运算符调用 SetDefaultValue，这会重新创建宽度和高度对应的基础 COM 对象（如果已创建这些对象）。如果将此动画对象订阅到事件（ValueChanged 或 IntegerValueChanged），则需要重新启用这些事件。

CAnimationSize::SetDefaultValue

设置默认值。

void SetDefaultValue(const CSize& szDefault);

参数

szDefault
指定新的默认大小。

注解

使用此函数将默认值设置为动画对象。此方法将默认值分配给动画大小的宽度和高度。如果已创建基础 COM 对象，它还会重新创建这些对象。如果将此动画对象订阅到事件（ValueChanged 或 IntegerValueChanged），则需要重新启用这些事件。

另请参阅

类

通过