CMessageData Class Reference

#include <mw/CMessageData.h>

Link against: sendui

class CMessageData : public CBase

Inherits from

CMessageData

Protected Attributes
TUid	iDataType

Public Member Functions
virtual	~CMessageData()
IMPORT_C void	AppendAttachmentHandleL(const RFile &)
IMPORT_C void	AppendAttachmentL(const TDesC &)
IMPORT_C void	AppendBccAddressL(const TDesC &, const TDesC &)
IMPORT_C void	AppendCcAddressL(const TDesC &, const TDesC &)
IMPORT_C void	AppendToAddressL(const TDesC &, const TDesC &)
IMPORT_C const CDesCArray &	AttachmentArray()
IMPORT_C const RArray< RFile > &	AttachmentHandleArray()
IMPORT_C const CMessageAddressArray &	BccAddressArray()
IMPORT_C const CRichText *	BodyText()
IMPORT_C const CMessageAddressArray &	CcAddressArray()
IMPORT_C void	ClearAddresses()
IMPORT_C void	ClearAttachmentArray()
IMPORT_C TUid	DataType()
IMPORT_C void	ExternalizeL(RWriteStream &)
IMPORT_C void	InternalizeL(RReadStream &)
IMPORT_C CMessageData *	NewL()
IMPORT_C CMessageData *	NewLC()
IMPORT_C const TPtrC8	OpaqueData()
IMPORT_C void	SetBodyTextL(const CRichText *)
IMPORT_C void	SetOpaqueDataL(const TDesC8 *, TUid)
IMPORT_C void	SetSubjectL(const TDesC *)
IMPORT_C const TPtrC	Subject()
IMPORT_C const CMessageAddressArray &	ToAddressArray()

Protected Member Functions
	CMessageData()
IMPORT_C void	ConstructL()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Encapsulates the message data for sending services.

Encapsulates the message data for sending services. Class supports externalazation and internalization, which are used to relay message to SendUI server application.

Since: S60 v3.0

Member Attribute Documentation

iDataType

TUid

iDataType

[protected]

Data type of this message. Normally this is KSenduiMsgDataBase This can be used for interpreting the opaque data.

Constructor & Destructor Documentation

CMessageData ( )

IMPORT_C

CMessageData

(

)

[protected]

C++ default constructor.

~CMessageData ( )

IMPORT_C

~CMessageData

(

)

[virtual]

Destructor.

Member Function Documentation

AppendAttachmentHandleL ( const RFile & )

IMPORT_C void

AppendAttachmentHandleL

(

const RFile &

aFileHandle

)

Appends attachment handle to the array of attachment handles.

NOTE: Attachment handles should be opened using ShareProtected() file session, otherwise handles can not be transfered through client-server interface.

NOTE: When adding a temporary file as an attachment, always use this method,

Since: Series 60 3.0

Parameter	Description
aFileHandle	File handle of the attachment.

Returns: None.

AppendAttachmentL ( const TDesC & )

IMPORT_C void

AppendAttachmentL

(

const TDesC &

aFilePath

)

Appends attachment file path to the array of attachment file paths. Only a link to the attachment is stored and compared to AppendAttachmentHandleL less resources is used during the send operation.

NOTE: Do not add any temporary files as an attachment. Always use AppendAttachmentHandleL for temporary files.

Since: Series 60 3.0

Parameter	Description
aFilePath	File path of the attachment.

Returns: None.

AppendBccAddressL ( const TDesC &, const TDesC & )

IMPORT_C void	AppendBccAddressL	(	const TDesC &	aBccAddress,
			const TDesC &	aBccAlias = KNullDesC
		)

Encapsulates Bcc address and alias to CMessageAddress and adds to array.

Since: Series 60 3.0

Parameter	Description
aBccAddress	Real Bcc-address.
aBccAlias	Alias for the real Bcc-address.

Returns: None.

AppendCcAddressL ( const TDesC &, const TDesC & )

IMPORT_C void	AppendCcAddressL	(	const TDesC &	aCcAddress,
			const TDesC &	aCcAlias = KNullDesC
		)

Encapsulates CC address and alias to CMessageAddress and adds to array.

Since: Series 60 3.0

Parameter	Description
aCcAddress	Real CC-address.
aCcAlias	Alias for the real CC-address.

Returns: None.

AppendToAddressL ( const TDesC &, const TDesC & )

IMPORT_C void	AppendToAddressL	(	const TDesC &	aAddress,
			const TDesC &	aAlias = KNullDesC
		)

Encapsulates address and alias to CMessageAddress and adds to array.

Since: Series 60 3.0

Parameter	Description
aAddress	Real address.
aAlias	Alias for the real address.

Returns: None.

AttachmentArray ( )

IMPORT_C const CDesCArray &

AttachmentArray

(

)

const

Returns the array of attachment file paths.

Since: Series 60 3.0

Returns: Array of attachment file paths.

AttachmentHandleArray ( )

IMPORT_C const RArray< RFile > &

AttachmentHandleArray

(

)

const

Returns the array of attachment handles.

Since: Series 60 3.0

Returns: Array of attachment handles.

BccAddressArray ( )

IMPORT_C const CMessageAddressArray &

BccAddressArray

(

)

const

Returns array of Bcc addresses and aliases.

Since: Series 60 3.0

Returns: Array of Bcc addresses and aliases.

BodyText ( )

IMPORT_C const CRichText *

BodyText

(

)

const

Returns message body text.

Since: Series 60 3.0

Returns: Message body text.

CcAddressArray ( )

IMPORT_C const CMessageAddressArray &

CcAddressArray

(

)

const

Returns array of CC addresses and aliases.

Since: Series 60 3.0

Returns: Array of cc addresses and aliases.

ClearAddresses ( )

IMPORT_C void

ClearAddresses

(

)

Clears all addressee arrays.

Since: Series 60 3.0

Returns: None.

ClearAttachmentArray ( )

IMPORT_C void

ClearAttachmentArray

(

)

Clears the array of attachment file paths.

Since: Series 60 3.0

Returns: Array of attachment file paths.

ConstructL ( )

IMPORT_C void

ConstructL

(

)

[protected]

By default Symbian 2nd phase constructor is private.

DataType ( )

IMPORT_C TUid

DataType

(

)

const

Returns data type id.

This can be used for interpreting the opaque data.

Since: Series 60 3.0

Returns: Data type id.

ExternalizeL ( RWriteStream & )

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Externalizes message data to a stream

Since: Series 60 3.2

Returns: None.

InternalizeL ( RReadStream & )

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

Internalizes message data to from a stream

Since: Series 60 3.2

Returns: None.

NewL ( )

IMPORT_C CMessageData *

NewL

(

)

[static]

Two-phased constructor.

Returns: Pointer to object of CMessageData.

NewLC ( )

IMPORT_C CMessageData *

NewLC

(

)

[static]

Two-phased constructor.

Returns: Pointer to object of CMessageData.

OpaqueData ( )

IMPORT_C const TPtrC8

OpaqueData

(

)

const

Get opaque data

Since: Series 60 3.2

Returns: aData Opaque data.

SetBodyTextL ( const CRichText * )

IMPORT_C void

SetBodyTextL

(

const CRichText *

aBodyText

)

Set message body text.

Since: Series 60 3.0

Parameter	Description
aBodyText	Message body text.

Returns: None.

SetOpaqueDataL ( const TDesC8 *, TUid )

IMPORT_C void	SetOpaqueDataL	(	const TDesC8 *	aData,
			TUid	aDataType
		)

Set opaque data

Since: Series 60 3.2

Parameter	Description
aData	Opaque data.

Returns: None.

SetSubjectL ( const TDesC * )

IMPORT_C void

SetSubjectL

(

const TDesC *

aSubject

)

Set message subject.

Since: Series 60 3.0

Parameter	Description
aSubject	Sets message subject. Does not take ownership.

Returns: None.

Subject ( )

IMPORT_C const TPtrC

Subject

(

)

const

Returns message subject.

Since: Series 60 3.0

Returns: Message subject.

ToAddressArray ( )

IMPORT_C const CMessageAddressArray &

ToAddressArray

(

)

const

Returns array of addresses and aliases.

Since: Series 60 3.0

Returns: Array of addresses and aliases.