Collapse all Symbian^3 Application Developer Library

CCFContextSourcePlugIn Class Reference

class CCFContextSourcePlugIn : public CBase

Context source plug-in API.

All context source plug-ins must define this interface to be able to publish contexts and subscribe contexts. It must be noticed that time consuming actions must not be done in construction phase. Only context definitions are allowed. All other initialization is done when InitializeL is called by Context Framework. Context source plug-in will be initialized in following order:

HandleSettingL
DefineContextsL
InitializeL

CFContextSourceManager.lib

Since: S60 5.0

Inherits from

CCFContextSourcePlugIn
- CBase

Public Member Functions
	~CCFContextSourcePlugIn ()
void	DefineContextsL ()
IMPORT_C TAny *	Extension (const TUid &)
void	HandleSettingL ( CCFContextSourceSettingArray *)
void	InitializeL ()
IMPORT_C CCFContextSourcePlugIn *	NewL (const TUid &, TContextSourceInitParams *)
IMPORT_C CCFContextSourcePlugIn *	NewLC (const TUid &, TContextSourceInitParams *)

Protected Member Functions
	CCFContextSourcePlugIn ( TContextSourceInitParams *)

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()

Protected Attributes
MCFContextInterface &	iCF
TUid	iDtorKey
TAny *	iReserved1
TAny *	iReserved2
TAny *	iReserved3

Constructor & Destructor Documentation

CCFContextSourcePlugIn(TContextSourceInitParams *)

IMPORT_C

CCFContextSourcePlugIn

(

TContextSourceInitParams *

aParams

)

[protected]

Parameters

TContextSourceInitParams * aParams

~CCFContextSourcePlugIn()

IMPORT_C

~CCFContextSourcePlugIn

(

)

[virtual]

Member Functions Documentation

DefineContextsL()

void

DefineContextsL

(

)

[pure virtual]

All contexts by this source must be defined in this stage. Contexts can be defined though MCF interface. Definition must include:

Context source
Context type
Security policy Called after settings are handled.

Since: S60 5.0

Extension(const TUid &)

IMPORT_C TAny *

Extension

(

const TUid &

aExtensionUid

)

const [virtual]

Returns an extension interface. The extension interface is mapped with the extension UID.

The default implemementation returns NULL.

Since: S60 5.0

Parameters

const TUid & aExtensionUid

HandleSettingL(CCFContextSourceSettingArray *)

void

HandleSettingL

(

CCFContextSourceSettingArray *

aSettingList

)

[pure virtual]

Handles settings. All the setting blocks defined with the plug-in name in the XML settings file will be given in an array. Ownership of aSettingList is transferred to the plug-in.

Since: S60 5.0

Parameters

CCFContextSourceSettingArray * aSettingList

List of setting blocks defined in the settings file.

InitializeL()

void

InitializeL

(

)

[pure virtual]

Plug-in is allowed to initialize. E.g. start listening some events or triggers.

Since: S60 5.0

NewL(const TUid &, TContextSourceInitParams *)

IMPORT_C CCFContextSourcePlugIn *	NewL	(	const TUid &	aImplementationUid,
			TContextSourceInitParams *	aParams
		)	[static]

Two phased constructors

Since: S60 5.0

Parameters

const TUid & aImplementationUid	Implementation to create.
TContextSourceInitParams * aParams	Construction parameters.

NewLC(const TUid &, TContextSourceInitParams *)

IMPORT_C CCFContextSourcePlugIn *	NewLC	(	const TUid &	aImplementationUid,
			TContextSourceInitParams *	aParams
		)	[static]

Parameters

const TUid & aImplementationUid
TContextSourceInitParams * aParams

Member Data Documentation

MCFContextInterface & iCF

MCFContextInterface &

iCF

[protected]

Ref: CF interface

TUid iDtorKey

TUid

iDtorKey

[protected]

Own: Descructor key for Ecom

TAny * iReserved1

TAny *

iReserved1

[protected]

Reserved

TAny * iReserved2

TAny *

iReserved2

[protected]

TAny * iReserved3

TAny *

iReserved3

[protected]