CSendUi Class Reference

#include <mw/sendui.h>

Link against: SendUi.lib

class CSendUi : public CBase

Inherits from

CSendUi

Public Member Enumerations
enum	TSendUiMenuType { ESendMenu, EWriteMenu }

Public Member Functions
virtual	~CSendUi()
IMPORT_C void	AddSendMenuItemL(CEikMenuPane &, TInt, TInt, TSendingCapabilities)
IMPORT_C void	AddTypedMenuItemL(TSendUiMenuType, CEikMenuPane &, TInt, TInt, TSendingCapabilities)
IMPORT_C void	AvailableServicesL(RPointerArray< CSendingServiceInfo > &, TUid)
IMPORT_C TBool	CanSendBioMessage(TUid)
IMPORT_C void	CreateAndSendMessageL(TUid, const CMessageData *, TUid, TBool)
IMPORT_C CSendUi *	NewL()
IMPORT_C CSendUi *	NewLC()
IMPORT_C TInt	ServiceCapabilitiesL(TUid, TSendingCapabilities &)
IMPORT_C void	ShowQueryAndSendL(const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC &)
IMPORT_C TUid	ShowSendQueryL(const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC &)
IMPORT_C void	ShowTypedQueryAndSendL(TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC &)
IMPORT_C TUid	ShowTypedQueryL(TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC &)
IMPORT_C TUid	TechnologyType(TUid)
IMPORT_C TBool	ValidateServiceL(TUid, TSendingCapabilities)

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

Offers "Send" pop-up list and message creation and sending services.

Can be used to display "Send" list query and to create and send messages via available services. Sending services can be based on the MTM or ECom architecture. Created messages are sent directly or message editor is opened for editing, depending on the type of selected service.

Since: Series 60 3.0

Member Enumeration Documentation

Enum TSendUiMenuType

Enumerator	Value	Description
ESendMenu
EWriteMenu

Constructor & Destructor Documentation

~CSendUi ( )

IMPORT_C

~CSendUi

(

)

[virtual]

Destructor.

Member Function Documentation

AddSendMenuItemL ( CEikMenuPane &, TInt, TInt, TSendingCapabilities )

IMPORT_C void	AddSendMenuItemL	(	CEikMenuPane &	aMenuPane,
			TInt	aIndex,
			TInt	aCommandId,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices
		)

Adds "Send" menu item to menupane.

Since: Series 60 3.0

Parameter	Description
aMenuPane	Menupane where the "Send" menu item should be added.
aIndex	The place of the "Send" menu item in menupane.
aCommandId	Command id for the "Send" menu item.
aRequiredCapabilities	Capabilities required by services to be shown in "Send" list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in "Send" list query.

Returns: None.

AddTypedMenuItemL ( TSendUiMenuType, CEikMenuPane &, TInt, TInt, TSendingCapabilities )

IMPORT_C void	AddTypedMenuItemL	(	TSendUiMenuType	aMenuType,
			CEikMenuPane &	aMenuPane,
			TInt	aIndex,
			TInt	aCommandId,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices
		)

Adds menu item of given type to menupane.

Since: Series 60 3.0

Parameter	Description
aMenuType	Type of the menu, "ESendMenu" or "EWriteMenu"
aMenuPane	Menupane where the menu item should be added.
aIndex	The place of the menu item in menupane.
aCommandId	Command id for the menu item.
aRequiredCapabilities	Capabilities required from services to be shown in list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in list query.

Returns: None.

AvailableServicesL ( RPointerArray< CSendingServiceInfo > &, TUid )

IMPORT_C void	AvailableServicesL	(	RPointerArray< CSendingServiceInfo > &	aServiceList,
			TUid	aServiceProvider = KNullUid
		)

Populates given list with the information about services provided by specified ECom service provider. Each service provider can provide 1..n services. Ownership of the pointed objects are transfered to caller.

Can be used for ex. when creating own "Send" menu, which needs to include ECom based services.

NOTE: Can be used only for ECom based services, also for MTMs

Since: Series 60 2.8

Parameter	Description
aServiceList	Service list to be populated.
aServiceProvider	Id of the specified service provider. KNullId means all service providers. Service providers are defined in SendUiConsts.h

Returns: none

CanSendBioMessage ( TUid )

IMPORT_C TBool

CanSendBioMessage

(

TUid

aBioMessageUid

)

const

Can be used to check if sending of bio message is supported. Deprecated.

Since: Series 60 3.0

Parameter	Description
aBioMessageUid	Uid of the bio message.

Returns: : Returns always EFalse

CreateAndSendMessageL ( TUid, const CMessageData *, TUid, TBool )

IMPORT_C void	CreateAndSendMessageL	(	TUid	aServiceUid,
			const CMessageData *	aMessageData,
			TUid	aBioTypeUid = KNullUid,
			TBool	aLaunchEditorEmbedded = ETrue
		)

Creates the message and launches the editor for editing the message or sends the message directly without opening the editor. Functionality depends on the type of selected service.

Since: Series 60 3.0

Parameter	Description
aServiceUid	Uid of the sending service (MTM or ECom).
aMessageData	Data for the message.
aBioTypeUid	BIO message type uid. Deprecated.
aLaunchEditorEmbedded	ETrue if the editor should be launched embedded. Otherwise the editor is launched stand-alone. Note: some sending services sends the messages without launching the editor at all.

Returns: None.

NewL ( )

IMPORT_C CSendUi *

NewL

(

)

[static]

Two-phased constructor.

NewLC ( )

IMPORT_C CSendUi *

NewLC

(

)

[static]

Two-phased constructor.

ServiceCapabilitiesL ( TUid, TSendingCapabilities & )

IMPORT_C TInt	ServiceCapabilitiesL	(	TUid	aServiceUid,
			TSendingCapabilities &	aServiceCapabilities
		)

Returns sending capabilities of the sending service.

Since: Series 60 3.0

Parameter	Description
aServiceUid	Uid of the sending service (MTM or ECom).
aServiceCapabilities	TSendingCapabilities of the sending service as a return value.

Returns: Return KErrNone if successful, or one of the system wide errors if unsuccessful.

ShowQueryAndSendL ( const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC & )

IMPORT_C void	ShowQueryAndSendL	(	const CMessageData *	aMessageData,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices,
			CArrayFix< TUid > *	aServicesToDim = NULL,
			TUid	aBioTypeUid = KNullUid,
			TBool	aLaunchEditorEmbedded = ETrue,
			const TDesC &	aTitleText = KNullDesC
		)

First displays "Send" pop-up list query and then creates the message. Editor is launched for editing the message or the message is sent directly without opening the editor. Functionality depends on the type of selected service.

"Send" pop-up list query can be manipulated in three ways. All three methods can be used or just some of those.

The first option is to set the required capabilities for services. Eg. attachments supported. Sending services not matching to required capabilities are filtered away. Capabilities are defined in TSendingCapabilities.h.

The second option is content based filtering. Filtering is based on the files intended to send. Those files can be set as part of message data. Filtering is done according the predefined rules. Eg. If oversized file is intended to send, MMS is filtered away from "Send" pop-up list.

The third option is to set the array of service uids not wanted to be shown in list query. These sending services are filtered away even if those match to required capabilities.

Since: Series 60 3.0

Parameter	Description
aMessageData	Data for the message.
aRequiredCapabilities	Capabilities required by sending services to be shown in "Send" pop-up list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in "Send" pop-up list query.
aServicesToDim	Array of service uids (service uid, service provider's uid or service's TechnologyType) _NOT_ wanted to "Send" list query. See predefined sending service uids in SendUiConsts.h .
aBioTypeUid	BIO message type uid. Deprecated.
aLaunchEditorEmbedded	ETrue if the editor should be launched embedded. Otherwise the editor is launched stand-alone. Note: some services sends the messages without launching the editor at all.
aTitleText	Title of the "Send" pop-up list query. If no title is defined, then the localised default title "Send:" is used.

Returns: None.

ShowSendQueryL ( const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC & )

IMPORT_C TUid	ShowSendQueryL	(	const CMessageData *	aMessageData = NULL,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices,
			CArrayFix< TUid > *	aServicesToDim = NULL,
			const TDesC &	aTitleText = KNullDesC
		)

Displays "Send" pop-up list query and returns the user selection.

"Send" pop-up list query can be manipulated in three ways. All three methods can be used or just some of those.

The third option is to set the array of service uids not wanted to be shown in list query. These sending services are filtered away even if those match to required capabilities.

Since: Series 60 3.0

Parameter	Description
aMessageData	Data for the message. Attachments are used for content based filtering.
aRequiredCapabilities	Capabilities required by sending services to be shown in "Send" pop-up list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in "Send" pop-up list query.
aServicesToDim	Array of service uids (service uid, service provider's uid or service's TechnologyType) _NOT_ wanted to "Send" list query. See predefined sending service uids in SendUiConsts.h .
aTitleText	Title of the "Send" pop-up list query. If no title is defined, then the localised default title "Send:" is used.

Returns: Uid of the selected service (MTM or ECom). KNullId is returned if user selects cancel.

ShowTypedQueryAndSendL ( TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC & )

IMPORT_C void	ShowTypedQueryAndSendL	(	TSendUiMenuType	aMenuType,
			const CMessageData *	aMessageData,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices,
			CArrayFix< TUid > *	aServicesToDim = NULL,
			TUid	aBioTypeUid = KNullUid,
			TBool	aLaunchEditorEmbedded = ETrue,
			const TDesC &	aTitleText = KNullDesC
		)

Displays list query and creates message. See ShowQueryAndSendL.

Since: Series 60 3.0

Parameter	Description
aMenuType	Type of the menu, e.g. "ESendMenu" or "EWriteMenu"
aMessageData	Data for the message.
aRequiredCapabilities	Capabilities required by sending services to be shown in "Send" pop-up list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in "Send" pop-up list query.
aServicesToDim	Array of service uids (service uid, service provider's uid or service's TechnologyType) _NOT_ wanted to "Send" list query. See predefined sending service uids in SendUiConsts.h .
aBioTypeUid	BIO message type uid. Deprecated.
aLaunchEditorEmbedded	ETrue if the editor should be launched embedded. Otherwise the editor is launched stand-alone. Note: some services sends the messages without launching the editor at all.
aTitleText	Title of the list query. If no title is defined, then the localised default title is used, e.g. "Send" or "Write".

Returns: None.

ShowTypedQueryL ( TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC & )

IMPORT_C TUid	ShowTypedQueryL	(	TSendUiMenuType	aMenuType,
			const CMessageData *	aMessageData = NULL,
			TSendingCapabilities	aRequiredCapabilities = KCapabilitiesForAllServices,
			CArrayFix< TUid > *	aServicesToDim = NULL,
			const TDesC &	aTitleText = KNullDesC
		)

Displays list query and returns the user selection. See ShowSendQueryL.

Since: Series 60 3.0

Parameter	Description
aMenuType	Type of the menu, e.g. "ESendMenu" or "EWriteMenu"
aMessageData	Data for the message. Attachments are used for content based filtering.
aRequiredCapabilities	Capabilities required by sending services to be shown in list query. If no capabilities are required (KCapabilitiesForAllServices), all available services are shown in list query.
aServicesToDim	Array of service uids (service uid, service provider's uid or service's TechnologyType) _NOT_ wanted to "Send" list query. See predefined sending service uids in SendUiConsts.h .
aTitleText	Title of the list query. If no title is defined, then the localised default title is used, e.g. "Send" or "Write"

Returns: Uid of the selected service (MTM or ECom). KNullId is returned if user selects cancel.

TechnologyType ( TUid )

IMPORT_C TUid

TechnologyType

(

TUid

aServiceUid

)

const

Returns the technology type of a service

Since: Series 60 3.0

Returns: Technology type of the provided service. NULL if Mtm service doesn't exist or service is ECOM based.

ValidateServiceL ( TUid, TSendingCapabilities )

IMPORT_C TBool	ValidateServiceL	(	TUid	aServiceUid,
			TSendingCapabilities	aRequiredCapabilities
		)

Validates that service is available and has required capabilities. For ex. can be used when calling application creates its own "Send" menu.

Since: Series 60 3.0

Parameter	Description
aServiceUid	Uid of the sending service (MTM or ECom).
aRequiredCapabilities	Capabilities required for the sending service.

Returns: ETrue if service is available and it has required capabilities,otherwise EFalse.

CSendUi Class Reference

Inherits from

Detailed Description

Member Enumeration Documentation

Enum TSendUiMenuType

Constructor & Destructor Documentation

~CSendUi ( )

Member Function Documentation

AddSendMenuItemL ( CEikMenuPane &, TInt, TInt, TSendingCapabilities )

AddTypedMenuItemL ( TSendUiMenuType, CEikMenuPane &, TInt, TInt, TSendingCapabilities )

AvailableServicesL ( RPointerArray< CSendingServiceInfo > &, TUid )

CanSendBioMessage ( TUid )

CreateAndSendMessageL ( TUid, const CMessageData *, TUid, TBool )

NewL ( )

NewLC ( )

ServiceCapabilitiesL ( TUid, TSendingCapabilities & )

ShowQueryAndSendL ( const CMessageData *, TSendingCapabilities, CArrayFix< TUid > *, TUid, TBool, const TDesC & )

ShowSendQueryL ( const CMessageData *, TSendingCapabilities, CArrayFix< TUid > *, const TDesC & )

ShowTypedQueryAndSendL ( TSendUiMenuType, const CMessageData *, TSendingCapabilities, CArrayFix< TUid > *, TUid, TBool, const TDesC & )

ShowTypedQueryL ( TSendUiMenuType, const CMessageData *, TSendingCapabilities, CArrayFix< TUid > *, const TDesC & )

TechnologyType ( TUid )

ValidateServiceL ( TUid, TSendingCapabilities )

ShowQueryAndSendL ( const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC & )

ShowSendQueryL ( const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC & )

ShowTypedQueryAndSendL ( TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , TUid, TBool, const TDesC & )

ShowTypedQueryL ( TSendUiMenuType, const CMessageData , TSendingCapabilities, CArrayFix< TUid > , const TDesC & )