Symbian^3 Product 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
Public Member Functions
~CCFContextSourcePlugIn()
voidDefineContextsL()
IMPORT_C TAny *Extension(const TUid &)
voidHandleSettingL(CCFContextSourceSettingArray *)
voidInitializeL()
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_CCCFContextSourcePlugIn(TContextSourceInitParams *aParams)[protected]

Parameters

TContextSourceInitParams * aParams

~CCFContextSourcePlugIn()

IMPORT_C~CCFContextSourcePlugIn()[virtual]

Member Functions Documentation

DefineContextsL()

voidDefineContextsL()[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 *)

voidHandleSettingL(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 * aSettingListList of setting blocks defined in the settings file.

InitializeL()

voidInitializeL()[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 & aImplementationUidImplementation to create.
TContextSourceInitParams * aParamsConstruction 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]

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.