位置: bmpancli.h

类 CBitmapAnimClientData

class CBitmapAnimClientData : public CBase;

描述

在一个动画当中封装一个或多个动画帧。

除了指定进行封装的帧动画之外，你还可以指定：

动画是否闪动
动画仅播放一次还是不间断播放
指定动画中用来清屏的背景帧
你可以为一个动画中的所有帧定义一个缺省的帧长度。若各个帧分别设置过长度值，将拥有更高优先级。

定义好动画之后使用RBitmapAnim来播放。

派生自

CBase – 在堆中实例化的所有类的基类
CBitmapAnimClientData – 在一个完整的动画中封装一个或多个动画帧
成员

CBitmapAnimClientData中定义:
AppendFrameL(), BackgroundFrame(), DurationInMilliSeconds(), EBounce, ECycle, EPlay, Flash(), FrameArray(), FrameIntervalInMilliSeconds(), NewL(), PlayMode(), ResetFrameArray(), SetBackgroundFrame(), SetFlash(), SetFrameInterval(), SetPlayMode(), Size(), TPlayMode, ~CBitmapAnimClientData()

继承自CBase:
operator new()

--------------------------------------------------------------------------------

构造子与析构子

--------------------------------------------------------------------------------

NewL()

static IMPORT_C CBitmapAnimClientData *NewL();

描述

分配资源并构造一个新的CBitmapAnimClientData 对象。

返回值

CBitmapAnimClientData *
 New CBitmapAnimClientData object
 

--------------------------------------------------------------------------------

~CBitmapAnimClientData()

IMPORT_C ~CBitmapAnimClientData();

描述

析构子，删除背景帧并销毁帧矩阵中的内容。

返回值

--------------------------------------------------------------------------------

成员函数

--------------------------------------------------------------------------------

AppendFrameL()

IMPORT_C void AppendFrameL(CBitmapFrameData *aFrame);

描述

往帧矩阵中添加一个新的帧。该矩阵作为这个新帧的拥有者。

参数

CBitmapFrameData *aFrame
 指向添加到帧矩阵中的那个帧的指针
 

返回值

void
 
 

--------------------------------------------------------------------------------

ResetFrameArray()

IMPORT_C void ResetFrameArray();

描述

重置并销毁帧矩阵的内容。

返回值

void
 
 

--------------------------------------------------------------------------------

SetBackgroundFrame()

IMPORT_C void SetBackgroundFrame(CBitmapFrameData *aBackgroundFrame);

描述

设置背景帧并拥有控制权。

任何之前的背景帧以及蒙板（假如包含的话）将从内存中被删除。当前帧将被清除并在动画窗口中重画。

参数

CBitmapFrameData *aBackgroundFrame
 作为背景帧的位图。
 

返回值

void
 
 

--------------------------------------------------------------------------------

SetFlash()

IMPORT_C void SetFlash(TBool aFlash);

描述

设置或者取消动画闪动状态的设置

参数

TBool aFlash
 动画闪动时为ETrue，反之为EFalse。
 

返回值

void
 
 

--------------------------------------------------------------------------------

SetFrameInterval()

IMPORT_C void SetFrameInterval(TInt aFrameIntervalInMilliSeconds);

描述

指定动画中各个帧的播放时间。

不用来设定各个动画帧自己的时间长度。

参数

TInt aFrameIntervalInMilliSeconds
 动画中各个帧的显示时间，毫秒为单位。
 

返回值

void
 
 

--------------------------------------------------------------------------------

SetPlayMode()

IMPORT_C void SetPlayMode(TPlayMode aPlayMode);

描述

设置动画播放模式是仅播放一次还是不间断播放。

参数

TPlayMode aPlayMode
 动画播放模式
 

返回值

void
 
 

--------------------------------------------------------------------------------

BackgroundFrame()

IMPORT_C CBitmapFrameData *BackgroundFrame() const;

描述

取得背景帧的位图。

返回值

CBitmapFrameData *
 背景帧位图
 

--------------------------------------------------------------------------------

Flash()

IMPORT_C TBool Flash() const;

描述

取得动画的闪动设置。

返回值

TBool
 如果闪动，返回ETrue；反之，EFalse。
 

--------------------------------------------------------------------------------

FrameArray()

IMPORT_C const CArrayPtrFlat< CBitmapFrameData > &FrameArray() const;

描述

取得动画帧矩阵。

返回值

const CArrayPtrFlat< CBitmapFrameData > &
 动画帧矩阵
 

--------------------------------------------------------------------------------

FrameIntervalInMilliSeconds()

IMPORT_C TInt FrameIntervalInMilliSeconds() const;

描述

以毫秒为单位取得缺省的动画帧长度。

返回值

TInt
 缺省动画帧长度，毫秒为单位。
 

--------------------------------------------------------------------------------

PlayMode()

IMPORT_C TPlayMode PlayMode() const;

描述

取得动画播放模式。

返回值

TPlayMode
 动画播放模式
 

--------------------------------------------------------------------------------

DurationInMilliSeconds()

IMPORT_C TInt DurationInMilliSeconds() const;

描述

取得播放整个组成动画的帧序列需要的时间。以毫秒为单位。

返回值

TInt
 动画持续时间
 

--------------------------------------------------------------------------------

Size()

IMPORT_C TSize Size() const;

描述

取得显示整个动画需要的尺寸。

返回值

TSize
 显示尺寸
 

--------------------------------------------------------------------------------

成员列举

--------------------------------------------------------------------------------

Enum TPlayMode

TPlayMode

描述

动画播放模式标志。

动画可以以下面方式播放。

EPlay
 从第一帧到最后一帧仅播放一次。
 
ECycle
 不间断地从第一帧到最后一帧进行播放。
 
EBounce
 从第一帧播放到最后一帧，再从最后一帧开始播放到第一帧，如此不间断播放下去。