Collapse all Symbian^3 Product Developer Library

MsvUiServiceUtilitiesInternal Class Reference

class MsvUiServiceUtilitiesInternal

Static class to help service handling.

Public Member Functions
IMPORT_C TBool	CallServiceL(const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)
IMPORT_C TBool	CallToSenderQueryL(const TDesC &, const TDesC &, TBool)
IMPORT_C void	ChangeMessageStoreToPhoneL(CMsvSession &)
IMPORT_C TBool	ComparePhoneNumberL(const TDesC &, const TDesC &, TInt)
IMPORT_C void	ConvertUtcToLocalTime(TTime &)
IMPORT_C TMsvId	DefaultServiceForMTML(CMsvSession &, TUid, TBool)
IMPORT_C TBool	InternetCallServiceL(const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)
IMPORT_C TBool	InternetCallToSenderQueryL(const TDesC &, const TDesC &, TBool)
IMPORT_C TBool	InternetOrVoiceCallServiceL(const CMsgVoIPExtension &, const TDesC &, const TDesC &, const TDesC &, TBool, CEikonEnv *)
IMPORT_C TBool	InternetOrVoiceCallServiceL(CEikonEnv &, const CMsgVoIPExtension &, const TDesC &, const TDesC &, TMuiuAddressType, const TDesC &, TMuiuAddressType, TBool)
IMPORT_C TBool	IsPhoneOfflineL()
IMPORT_C TBool	MmcDriveInfoL(CMsvSession &)
IMPORT_C TBool	OtherEmailMTMExistL(CMsvSession &, TInt)
IMPORT_C TMuiuAddressType	ResolveAddressTypeL(const TDesC &, CommonPhoneParser::TPhoneNumberType)
IMPORT_C void	SetDefaultServiceForMTML(CMsvSession &, TUid, TMsvId)

Private Member Functions
TInt	LaunchDialogL(const TPtr, TInt *)

Member Functions Documentation

CallServiceL(const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)

IMPORT_C TBool	CallServiceL	(	const TDesC &	aSenderNumber,
			const TDesC &	aSenderName,
			const TDesC &	aNumberInFocus = KNullDesC ,
			CEikonEnv *	aEnv = NULL
		)	[static]

When SMS viewer or MMS viewer is open it is possible to call back to sender or phone number which is currently highlighted in message. If user select Send-key then CAknListQueryDialog is opened with items "Back to sender" and currently highlighted phone number and with soft keys "Call" and "Cancel". If item "Back to sender" is selected and user select "Call" then function call "CallToSenderQueryL" function with parameters "aSenderNumber" and "aSenderName". If currently highlighted item is selected and user select "Call" then function call "CallToSenderQueryL" function with parameters "aSenderNumber" and KNullDesC. If no phone number is highlighted in message and user select Send-key then function launch the normal call query.

Parameters

const TDesC & aSenderNumber
const TDesC & aSenderName
const TDesC & aNumberInFocus = KNullDesC
CEikonEnv * aEnv = NULL

CallToSenderQueryL(const TDesC &, const TDesC &, TBool)

IMPORT_C TBool	CallToSenderQueryL	(	const TDesC &	aNumber,
			const TDesC &	aName,
			TBool	aDialWithoutQueries = ETrue
		)	[static]

Used when asking from user if calling to sender of the message and dial to sender if user select "Yes". Check immediately if phone number is valid. If phone number is not valid then return EFalse and doesn't do nothing.If parameter "aDialWithoutQueries" is true then call immediately to sender of the message and doesn't ask nothing from user before it.

Parameters

const TDesC & aNumber
const TDesC & aName
TBool aDialWithoutQueries = ETrue

ChangeMessageStoreToPhoneL(CMsvSession &)

IMPORT_C void

ChangeMessageStoreToPhoneL

(

CMsvSession &

aSession

)

[static]

Sets message store to phone's internal memory. This function is possible to use for example in situation where current drive is memory card and memory card is not in use.

Parameters

CMsvSession & aSession

ComparePhoneNumberL(const TDesC &, const TDesC &, TInt)

IMPORT_C TBool	ComparePhoneNumberL	(	const TDesC &	aNumber1,
			const TDesC &	aNumber2,
			TInt	aCompareLength = -1
		)	[static]

Compares two phone numbers.

Parameters

const TDesC & aNumber1
const TDesC & aNumber2
TInt aCompareLength = -1

ConvertUtcToLocalTime(TTime &)

IMPORT_C void

ConvertUtcToLocalTime

(

TTime &

aTime

)

[static]

Converts UTC time to local time

Parameters

TTime & aTime

Utc time that is converted to local time on return.

DefaultServiceForMTML(CMsvSession &, TUid, TBool)

IMPORT_C TMsvId	DefaultServiceForMTML	(	CMsvSession &	aSession,
			TUid	aMtm,
			TBool	aFindFirstServiceIfNoDefault
		)	[static]

Returns id of the default service of certain mtm type.

Parameters

CMsvSession & aSession
TUid aMtm
TBool aFindFirstServiceIfNoDefault

InternetCallServiceL(const TDesC &, const TDesC &, const TDesC &, CEikonEnv *)

IMPORT_C TBool	InternetCallServiceL	(	const TDesC &	aSenderNumber,
			const TDesC &	aSenderName,
			const TDesC &	aNumberInFocus = KNullDesC ,
			CEikonEnv *	aEnv = NULL
		)	[static]

Since: 3.0

Parameters

const TDesC & aSenderNumber
const TDesC & aSenderName
const TDesC & aNumberInFocus = KNullDesC
CEikonEnv * aEnv = NULL

InternetCallToSenderQueryL(const TDesC &, const TDesC &, TBool)

IMPORT_C TBool	InternetCallToSenderQueryL	(	const TDesC &	aNumber,
			const TDesC &	aName,
			TBool	aDialWithoutQueries = ETrue
		)	[static]

Used when asking from user if calling to sender of the message and dial to sender if user select "Yes". Assumes allways that Internet call number is valid and ETrue returned. If parameter "aDialWithoutQueries" is true then call immediately to sender of the message and doesn't ask nothing from user before it.

Since: 3.0

Parameters

const TDesC & aNumber
const TDesC & aName
TBool aDialWithoutQueries = ETrue

InternetOrVoiceCallServiceL(const CMsgVoIPExtension &, const TDesC &, const TDesC &, const TDesC &, TBool, CEikonEnv *)

IMPORT_C TBool	InternetOrVoiceCallServiceL	(	const CMsgVoIPExtension &	aVoIPExtension,
			const TDesC &	aSenderAddress,
			const TDesC &	aSenderName,
			const TDesC &	aAddressInFocus = KNullDesC ,
			TBool	aDialWithoutQueries = ETrue,
			CEikonEnv *	aEnv = NULL
		)	[static]

Messaging application viewer or other application may call to sender or higlighted address when send key is pressed or in other situation. This function makes the decision whether voice or VoIP call is done. For more information about usage see CallToSenderQueryL(), CallServiceL(), InternetCallToSenderQueryL() and InternetCallServiceL().

Parameters

const CMsgVoIPExtension & aVoIPExtension
const TDesC & aSenderAddress
const TDesC & aSenderName
const TDesC & aAddressInFocus = KNullDesC
TBool aDialWithoutQueries = ETrue
CEikonEnv * aEnv = NULL

InternetOrVoiceCallServiceL(CEikonEnv &, const CMsgVoIPExtension &, const TDesC &, const TDesC &, TMuiuAddressType, const TDesC &, TMuiuAddressType, TBool)

IMPORT_C TBool	InternetOrVoiceCallServiceL	(	CEikonEnv &	aEnv,
			const CMsgVoIPExtension &	aVoIPExtension,
			const TDesC &	aSenderAddress,
			const TDesC &	aSenderName,
			TMuiuAddressType	aSenderAddressType,
			const TDesC &	aAddressInFocus = KNullDesC ,
			TMuiuAddressType	aAddressInFocusType = EMuiuAddressTypeNone,
			TBool	aDialWithoutQueries = ETrue
		)	[static]

Parameters

CEikonEnv & aEnv
const CMsgVoIPExtension & aVoIPExtension
const TDesC & aSenderAddress
const TDesC & aSenderName
TMuiuAddressType aSenderAddressType	address type of sender
const TDesC & aAddressInFocus = KNullDesC
TMuiuAddressType aAddressInFocusType = EMuiuAddressTypeNone	address type of focused address
TBool aDialWithoutQueries = ETrue

IsPhoneOfflineL()

IMPORT_C TBool

IsPhoneOfflineL

(

)

[static]

Checks if phone is in offline mode or not Make sure that offline feature has been checked using feature manager

LaunchDialogL(const TPtr, TInt *)

TInt	LaunchDialogL	(	const TPtr	aGroupedNumberPtr,
			TInt *	aIndex
		)	[private, static]

Launch CMuiuListQueryDialog

Parameters

const TPtr aGroupedNumberPtr	Phone number which is groupped before it goes to dialog
TInt * aIndex	tell which item is selected when dialog is closed

MmcDriveInfoL(CMsvSession &)

IMPORT_C TBool

MmcDriveInfoL

(

CMsvSession &

aSession

)

[static]

Check if iUnicueID of memory card is same than uniqueid of memory card in message server.

Parameters

CMsvSession & aSession

OtherEmailMTMExistL(CMsvSession &, TInt)

IMPORT_C TBool	OtherEmailMTMExistL	(	CMsvSession &	aSession,
			TInt	aMailbox = 0
		)	[static]

Parameters

CMsvSession & aSession
TInt aMailbox = 0

ResolveAddressTypeL(const TDesC &, CommonPhoneParser::TPhoneNumberType)

IMPORT_C TMuiuAddressType	ResolveAddressTypeL	(	const TDesC &	aAddress,
			CommonPhoneParser::TPhoneNumberType	aDefaultPhoneNumberType = CommonPhoneParser::EPhoneClientNumber
		)	[static]

Resolves type of given address Phone number is checked by CommonPhoneParser. Email address is checked by MsvUiServiceUtilities

Parameters

const TDesC & aAddress	address to check
CommonPhoneParser::TPhoneNumberType aDefaultPhoneNumberType = CommonPhoneParser::EPhoneClientNumber	subtype of phone number check

SetDefaultServiceForMTML(CMsvSession &, TUid, TMsvId)

IMPORT_C void	SetDefaultServiceForMTML	(	CMsvSession &	aSession,
			TUid	aMtm,
			TMsvId	aServiceId
		)	[static]

Sets default service for the certain mtm type.

Parameters

CMsvSession & aSession
TUid aMtm
TMsvId aServiceId