Client-side handle to a server-side animation class. More...

#include <w32std.h>

Public Member Functions
virtual IMPORT_C	~RAnim ()
	Empty virtual destructor.

virtual IMPORT_C void	Close ()
	Sends the close command.

IMPORT_C void	Destroy ()
	Closes and deletes the server-side animation object.

Protected Member Functions
IMPORT_C	RAnim ()
	Default constructor.

IMPORT_C	RAnim (RAnimDll &aDll)
	Protected C++ constructor.

IMPORT_C TInt	Construct (const RWindowBase &aDevice, TInt aType, const TDesC8 &aParams)
	Completes construction of the object based on a window device, and creates the server-side animation system.

IMPORT_C TInt	Construct (const RWindowBase &aDevice, TInt aType, const TDesC8 &aParams, const TIpcArgs &aIpcArgs)
	Completes construction of the object based on a window device, and creates the server-side animation system.

IMPORT_C TInt	Construct (const RWsSprite &aDevice, TInt aType, const TDesC8 &aParams)
	Completes construction of the Anim DLL based on a sprite.

IMPORT_C TInt	Construct (const RWsSprite &aDevice, TInt aType, const TDesC8 &aParams, const TIpcArgs &aIpcArgs)
	Completes construction of the Anim DLL based on a sprite.

IMPORT_C TInt	CommandReply (TInt aOpcode)
	Sends a command to the server-side CAnim instance, and waits for a response.

IMPORT_C TInt	CommandReply (TInt aOpcode, const TPtrC8 &aArgs)
	Sends a command and its arguments to the server-side CAnim instance, and waits for a response.

IMPORT_C TInt	CommandReply (TInt aOpcode, const TDesC8 &aArgs, const TIpcArgs &aIpcArgs)
	Sends a command and its arguments to the server-side CAnim instance, and waits for a response.

IMPORT_C void	Command (TInt aOpcode, const TPtrC8 &aArgs)
	Sends a command and its arguments to the server-side CAnim instance, and returns immediately.

IMPORT_C void	Command (TInt aOpcode)
	Sends a command to the server-side CAnim instance, and returns immediately.

IMPORT_C void	AsyncCommandReply (TRequestStatus &aRequestStatus, TInt aOpcode, const TIpcArgs &aIpcArgs)
	Sends a command and its arguments to the server-side CAnim instance asynchronously.

Detailed Description

Client-side handle to a server-side animation class.

This class should be sub-classed to provide a client side interface to the server side animation DLL. The server side animation DLL is derived from CAnim.

API status: Published to all clients. Released API.

Definition at line 2560 of file w32std.h.

Constructor & Destructor Documentation

◆ ~RAnim()

IMPORT_C RAnim::~RAnim ( )

virtual

Empty virtual destructor.

(generated from Symbian Developer Library)

◆ RAnim() [1/2]

IMPORT_C RAnim::RAnim ( )

protected

Default constructor.

Developers should use the other constructor overload.

(generated from Symbian Developer Library)

◆ RAnim() [2/2]

IMPORT_C RAnim::RAnim ( RAnimDll & aDll )

protected

Protected C++ constructor.

This constructor should be used to construct an animation object from a given animation DLL. The DLL must be loaded first, see the discussion of RAnimDll.

Parameters

aDll	The animation DLL.

(generated from Symbian Developer Library)

Member Function Documentation

◆ AsyncCommandReply()

IMPORT_C void RAnim::AsyncCommandReply	(	TRequestStatus &	aRequestStatus,
		TInt	aOpcode,
		const TIpcArgs &	aIpcArgs
	)

protected

Sends a command and its arguments to the server-side CAnim instance asynchronously.

The IPC (inter-process communication) arguments are passed to the CAnim-derived class' CommandReplyL function, where the behaviour should be implemented. The request is not buffered - rather the function executes asynchronously. The first and second slots of the TIpcArgs parameter are reserved for internal use.

If the code calling this function is itself an API that is asynchronous (i.e. if the TRequestStatus passed into this function is simply a parameter to a higher-level API), then that higher-level API should typically provide a corresponding "Cancel" function that its own clients can use to cancel their asynchronous request - this would typically be implemented by the higher-level API by using RAnim::CommandReply.

CommandReply() Command() CAnim::CommandReplyL()

Parameters

aRequestStatus	Set initially by the function to KRequestPending. Then when this asynchronous function at some potentially later point in time "completes", aRequestStatus is set to the completion code which is a value defined by the animation writer (i.e. the value that the server-side CAnim-derived class' CommandReplyL returns or leaves with). The value may, in some cases, be defined to be an error code.
aOpcode	An opcode meaningful to the server-side CAnim-derived class.
aIpcArgs	Inter-process communication arguments which will be passed to the server side object. Panics if either the first or second "slot" is set to anything other than TIpcArgs::ENothing.

(generated from Symbian Developer Library)

◆ Close()

IMPORT_C void RAnim::Close ( )

virtual

Sends the close command.

This frees resources belonging to an animation object. It would be called to release resources when the RAnim is owned in-line by another object (so that destruction is automatic).

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

◆ Command() [1/2]

IMPORT_C void RAnim::Command ( TInt aOpcode )

protected

Sends a command to the server-side CAnim instance, and returns immediately.

Commands issued by this function may be buffered before being passed to the server.

Server-side errors cannot be detected, so Command() should not be used for operations which could fail or which may leave. Use CommandReply() for those. Although the window server will not fail due to errors not being returned to the client side, client side behaviour will almost certainly not be correct if errors have been generated but not received.

Use of this function results in a server-side call to the equivalent CAnim::Command().

CommandReply() AsyncCommandReply() CAnim::Command()

Parameters

aOpcode An operation meaningful to the server-side CAnim object.

(generated from Symbian Developer Library)

◆ Command() [2/2]

IMPORT_C void RAnim::Command	(	TInt	aOpcode,
		const TPtrC8 &	aArgs
	)

protected

Sends a command and its arguments to the server-side CAnim instance, and returns immediately.

Commands issued by this function may be buffered before being passed to the server.

Server-side errors cannot be detected, so Command() should not be used for operations which could fail or which may leave. Use CommandReply() for those. Although the window server will not fail due to errors not being returned to the client side, client side behaviour will almost certainly not be correct if errors have been generated but not received.

Use of this function results in a server-side call to the equivalent CAnim::Command().

CommandReply() AsyncCommandReply() CAnim::Command()

Parameters

aOpcode	An operation meaningful to the server-side CAnim object.
aArgs	Packaged arguments which will be passed to the server side object.

(generated from Symbian Developer Library)

◆ CommandReply() [1/3]

IMPORT_C TInt RAnim::CommandReply ( TInt aOpcode )

protected

Sends a command to the server-side CAnim instance, and waits for a response.

This function executes synchronously and returns the code returned by the server-side method CAnim::CommandReplyL(). The request is not buffered.

This function always causes a flush of the window server buffer.

Command() AsyncCommandReply() CAnim::CommandReplyL()

Parameters

aOpcode An opcode meaningful to the server-side CAnim-derived class.

(generated from Symbian Developer Library)

◆ CommandReply() [2/3]

IMPORT_C TInt RAnim::CommandReply	(	TInt	aOpcode,
		const TDesC8 &	aArgs,
		const TIpcArgs &	aIpcArgs
	)

protected

Sends a command and its arguments to the server-side CAnim instance, and waits for a response.

The IPC (inter-process communication) arguments are passed to the matching server side function, where the behaviour should be implemented. The request is not buffered. The function executes synchronously and returns the code returned by the server-side method CAnim::CommandReplyL(). The first slot of the TIpcArgs parameter is reserved for internal use.

This function always causes a flush of the window server buffer.

Command() AsyncCommandReply() CAnim::CommandReplyL()

Parameters

aOpcode	An opcode meaningful to the server-side CAnim-derived class.
aArgs	Packaged arguments which will be passed to the server side object.
aIpcArgs	Inter-process communication arguments which will be passed to the server side object. Panics if the first "slot" is set to anything other than TIpcArgs::ENothing.

(generated from Symbian Developer Library)

◆ CommandReply() [3/3]

IMPORT_C TInt RAnim::CommandReply	(	TInt	aOpcode,
		const TPtrC8 &	aArgs
	)

protected

Sends a command and its arguments to the server-side CAnim instance, and waits for a response.

The packaged command arguments are passed to the matching server side function, where the behaviour should be implemented. The request is not buffered. The function executes synchronously and returns the code returned by the server-side method CAnim::CommandReplyL().

This function always causes a flush of the window server buffer.

Command() AsyncCommandReply() CAnim::CommandReplyL()

Parameters

aOpcode	An opcode meaningful to the server-side CAnim-derived class.
aArgs	Packaged arguments which will be passed to the server side object.

(generated from Symbian Developer Library)

◆ Construct() [1/4]

IMPORT_C TInt RAnim::Construct	(	const RWindowBase &	aDevice,
		TInt	aType,
		const TDesC8 &	aParams
	)

protected

Completes construction of the object based on a window device, and creates the server-side animation system.

Construction information is passed to the server side via aType and aParams. The server then passes the information to the function CreateInstanceL() inside the Anim DLL.

This function always causes a flush of the window server buffer.

CAnim::ConstructL() CAnimDll::CreateInstanceL()

Parameters

aDevice	A window device.
aType	The type of this animation object, as understood by CAnimDll::CreateInstanceL().
aParams	Packaged arguments which will be passed to the server side object to tell it how to construct itself or initialise itself.

(generated from Symbian Developer Library)

◆ Construct() [2/4]

IMPORT_C TInt RAnim::Construct	(	const RWindowBase &	aDevice,
		TInt	aType,
		const TDesC8 &	aParams,
		const TIpcArgs &	aIpcArgs
	)

protected

Completes construction of the object based on a window device, and creates the server-side animation system.

Construction information is passed to the server side via aType and aParams. The server then passes the information to the function CreateInstanceL() inside the Anim DLL.

This function always causes a flush of the window server buffer.

CAnim::ConstructL() CAnimDll::CreateInstanceL()

Parameters

aDevice	A window device.
aType	The type of this animation object, as understood by CAnimDll::CreateInstanceL().
aParams	Packaged arguments which will be passed to the server side object to tell it how to construct itself or initialise itself.
aIpcArgs	Inter-process communication arguments which will be passed to the server side object. Panics if the first "slot" is set to anything other than TIpcArgs::ENothing.

(generated from Symbian Developer Library)

◆ Construct() [3/4]

IMPORT_C TInt RAnim::Construct	(	const RWsSprite &	aDevice,
		TInt	aType,
		const TDesC8 &	aParams
	)

protected

Completes construction of the Anim DLL based on a sprite.

Construction information is passed to the server side via aType and aParams. The server then passes the information to the function CreateInstanceL() inside the Anim DLL.

This function always causes a flush of the window server buffer.

CAnim::ConstructL() CAnimDll::CreateInstanceL()

Parameters

aDevice	A sprite.
aType	The type of this animation object, as understood by CAnimDll::CreateInstanceL().
aParams	Packaged arguments which will be passed to the server side object to tell it how to construct itself or initialise itself.

(generated from Symbian Developer Library)

◆ Construct() [4/4]

IMPORT_C TInt RAnim::Construct	(	const RWsSprite &	aDevice,
		TInt	aType,
		const TDesC8 &	aParams,
		const TIpcArgs &	aIpcArgs
	)

protected

Completes construction of the Anim DLL based on a sprite.

Construction information is passed to the server side via aType and aParams. The server then passes the information to the function CreateInstanceL() inside the Anim DLL.

This function always causes a flush of the window server buffer.

CAnim::ConstructL() CAnimDll::CreateInstanceL()

Parameters

aDevice	A sprite.
aType	The type of this animation object, as understood by CAnimDll::CreateInstanceL().
aParams	Packaged arguments which will be passed to the server side object to tell it how to construct itself or initialise itself.
aIpcArgs	Inter-process communication arguments which will be passed to the server side object. Panics if the first "slot" is set to anything other than TIpcArgs::ENothing.

(generated from Symbian Developer Library)

◆ Destroy()

IMPORT_C void RAnim::Destroy ( )

Closes and deletes the server-side animation object.

This should be called on heap allocated objects.

This function always causes a flush of the window server buffer.

(generated from Symbian Developer Library)

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~RAnim()

◆ RAnim() [1/2]

◆ RAnim() [2/2]

Member Function Documentation

◆ AsyncCommandReply()

◆ Close()

◆ Command() [1/2]

◆ Command() [2/2]

◆ CommandReply() [1/3]

◆ CommandReply() [2/3]

◆ CommandReply() [3/3]

◆ Construct() [1/4]

◆ Construct() [2/4]

◆ Construct() [3/4]

◆ Construct() [4/4]

◆ Destroy()