Collapse all Symbian^3 Product Developer Library

MsgEditorLauncher Class Reference

class MsgEditorLauncher

Static class which launches editor application (provided editor conforms to architecture).

The returned operation completes either when the launched application closes down, or after the launch has been initiated depending on the values in the TEditorParameters.

Public Member Functions
IMPORT_C CMsvOperation *	LaunchEditorApplicationL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 *)
IMPORT_C CMsvOperation *	LaunchEditorApplicationL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &, const TDesC8 *)

Private Member Functions
TUid	DiscoverL(const TEditorParameters)
CMsvOperation *	LaunchEditorApplicationEmbeddedL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &)
CMsvOperation *	LaunchEditorApplicationStandAloneL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &, const TDesC8 *, TBool)
TBool	TryMatchL(const TEditorParameters, const TApaAppServiceInfo, TUid &)

Member Functions Documentation

DiscoverL(const TEditorParameters)

TUid

DiscoverL

(

const TEditorParameters

aParams

)

[private, static]

DiscoverL (Internal) Finds the right application id to be started and returns it. First checks if TEditorParameters.iSpecialAppId is set. If it is, returns that. Then connects RApaLsSession and initializes it with GetServerApps command. Then gets all the services that implement the service by using GetServiceImplementationsLC. Calls TryMatchL for each service and if there's a match, the appId is returned. If no implementation is found, 0 is returned.

Parameters

const TEditorParameters aParams

LaunchEditorApplicationEmbeddedL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &)

CMsvOperation *	LaunchEditorApplicationEmbeddedL	(	CMsvSession &	aSession,
			TUid	aMtmType,
			TRequestStatus &	aStatus,
			const TEditorParameters &	aParams,
			const TDesC &	aAppName,
			const TDesC8 &	aProgressPack
		)	[private, static]

Launch editor application embedded.

Parameters

CMsvSession & aSession
TUid aMtmType
TRequestStatus & aStatus
const TEditorParameters & aParams
const TDesC & aAppName
const TDesC8 & aProgressPack

LaunchEditorApplicationL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 *)

IMPORT_C CMsvOperation *	LaunchEditorApplicationL	(	CMsvSession &	aSession,
			TUid	aMtmType,
			TRequestStatus &	aStatus,
			const TEditorParameters &	aParams,
			const TDesC &	aAppName,
			const TDesC8 *	aAddtionalParams = NULL
		)	[static]

Launch message editor

Parameters

CMsvSession & aSession
TUid aMtmType
TRequestStatus & aStatus
const TEditorParameters & aParams
const TDesC & aAppName
const TDesC8 * aAddtionalParams = NULL

LaunchEditorApplicationL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &, const TDesC8 *)

IMPORT_C CMsvOperation *	LaunchEditorApplicationL	(	CMsvSession &	aSession,
			TUid	aMtmType,
			TRequestStatus &	aStatus,
			const TEditorParameters &	aParams,
			const TDesC &	aAppName,
			const TDesC8 &	aProgressPack,
			const TDesC8 *	aAddtionalParams = NULL
		)	[static]

Launch message editor

Parameters

CMsvSession & aSession
TUid aMtmType
TRequestStatus & aStatus
const TEditorParameters & aParams
const TDesC & aAppName
const TDesC8 & aProgressPack
const TDesC8 * aAddtionalParams = NULL

LaunchEditorApplicationStandAloneL(CMsvSession &, TUid, TRequestStatus &, const TEditorParameters &, const TDesC &, const TDesC8 &, const TDesC8 *, TBool)

CMsvOperation *	LaunchEditorApplicationStandAloneL	(	CMsvSession &	aSession,
			TUid	aMtmType,
			TRequestStatus &	aStatus,
			const TEditorParameters &	aParams,
			const TDesC &	aAppName,
			const TDesC8 &	aProgressPack,
			const TDesC8 *	aAddtionalParams,
			TBool	aLaunchThenWait
		)	[private, static]

Launch editor application stand alone.

Parameters

CMsvSession & aSession
TUid aMtmType
TRequestStatus & aStatus
const TEditorParameters & aParams
const TDesC & aAppName
const TDesC8 & aProgressPack
const TDesC8 * aAddtionalParams
TBool aLaunchThenWait

TryMatchL(const TEditorParameters, const TApaAppServiceInfo, TUid &)

TBool	TryMatchL	(	const TEditorParameters	aParams,
			const TApaAppServiceInfo	aInfo,
			TUid &	aAppUid
		)	[private, static]

TryMatchL (Internal) If TEditorParameters.iFlags has either EMsgReadOnly or EMsgPreviewMessage bit set, this function looks for a service that implements the KMsgServiceView part of the service. Otherwise looks for KMsgServiceEdit part. Reads the parameters ( service type (View/Edit), MtmType) from the opaque data. If type and mtm match, sets aAppUi as the application id and returns ETrue. If not found, returns EFalse.

Parameters

const TEditorParameters aParams
const TApaAppServiceInfo aInfo
TUid & aAppUid