Class RWsSprite

RWsSprite

Support

Supported from 5.0

Description

Sprite.

This class defines functions to create and initialise a sprite, and to set its position. It also inherits the functions of RWsSpriteBase.

Derivation

MWsClientClass Base class for all classes whose objects are clients of the window server engine RWsSprite Sprite RWsSpriteBase Sprite base class

Defined in RWsSprite:
Construct(), RWsSprite(), SetPosition()

Inherited from MWsClientClass:
WsHandle()

Inherited from RWsSpriteBase:
Activate(), AppendMember(), Close(), UpdateMember()

RWsSprite();

Description

Default C++ constructor.

This allows classes that contain an RWsSprite to be constructed before an RWsSession exists.

Note:

• Do not use this version of the constructor on its own. Before an RWsSprite object can be used it must be constructed using the RWsSprite(RWsSession) constructor described next. An example of this might be as follows:

RWsSprite iSprite;
iSprite=RWsSprite(iWsSession);

RWsSprite(RWsSession &aWs);

Description

Constructs a sprite with a window server session.

Initialisation must be completed using the Construct() function before the sprite can be activated using RWsSpriteBase::Activate().

Parameters

RWsSession &aWs The window server session owning the sprite.

TInt Construct(RWindowTreeNode& aWindow, const TPoint& aPos, TInt aFlags);

Description

Completes the construction of a sprite.

This function must be called before a sprite is activated using RWsSpriteBase::Activate().

Parameters

RWindowTreeNode& aWindow The window in which the sprite is displayed const TPoint& aPos The position of the sprite's origin relative to aWindow's origin. The origin is the top left corner of the window. TInt aFlags Any one of the TSpriteFlags values, or a combination of the flags — using a bit-wise OR operation.

Return value

TInt KErrNone if successful, otherwise one of the system-wide error codes.

See also:

• TSpriteFlags

void SetPosition(const TPoint &aPos);

Description

Sets the sprite position.

This function can be called before and after the sprite has been activated.

Note:

• The sprite's initial position is set when the sprite is constructed (see Construct()).

Parameters

const TPoint& aPos Position of the sprite's origin relative to the origin of the window that owns it. The origin is the top left corner of the window.