Collapse all Symbian^3 Application Developer Library

CMtmUiRegistry Class Reference

class CMtmUiRegistry : public CObserverRegistry

Accesses the User Interface MTM registry.

This registry holds details of the all the User Interface MTMs currently available on the system. Message client applications use this class to get a CBaseMtmUi-derived object by which to access User Interface MTM functionality.

Note that the base class CMtmDllRegistry provides functions for discovering what MTMs are present in the registry.

Inherits from

CMtmUiRegistry
- CObserverRegistry
  - CMtmDllRegistry
    - CBase

Public Member Functions
	~CMtmUiRegistry ()
IMPORT_C CMtmUiRegistry *	NewL ( CMsvSession &, TTimeIntervalMicroSeconds32 )
IMPORT_C CBaseMtmUi *	NewMtmUiL ( CBaseMtm &)

Protected Member Functions
	CMtmUiRegistry ( CMsvSession &, TTimeIntervalMicroSeconds32 )

Private Member Functions
CBaseMtmUi *	NewMtmL (const RLibrary &, CBaseMtm &, CRegisteredMtmDll &)

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()
	CMtmDllRegistry::AddRegisteredMtmDll(TUid,TUid,const CMtmDllInfo &,MRegisteredMtmDllObserver &)
	CMtmDllRegistry::CMtmDllRegistry(RFs &,TUid,TTimeIntervalMicroSeconds32)
	CMtmDllRegistry::IsInUse()const
	CMtmDllRegistry::IsInUse(TUid)const
	CMtmDllRegistry::IsPresent(TUid)const
	CMtmDllRegistry::MtmTypeUid(TInt)const
	CMtmDllRegistry::MtmTypeUidToIndex(TUid)const
	CMtmDllRegistry::NumRegisteredMtmDlls()const
	CMtmDllRegistry::RegisteredMtmDllInfo(TUid)const
	CMtmDllRegistry::RemoveAllRegisteredMtmDlls()
	CMtmDllRegistry::RemoveRegisteredMtmDll(TUid)
	CMtmDllRegistry::TechnologyTypeUid(TUid)const
	CMtmDllRegistry::~CMtmDllRegistry()
	CObserverRegistry::CObserverRegistry(CMsvSession &,TUid,TTimeIntervalMicroSeconds32)
	CObserverRegistry::ConstructL()
	CObserverRegistry::HandleSessionEventL(TMsvSessionEvent,TAny ,TAny ,TAny *)
	CObserverRegistry::~CObserverRegistry()

Inherited Attributes
	CMtmDllRegistry::iFs
	CMtmDllRegistry::iMtmDllTypeUid
	CMtmDllRegistry::iRegisteredMtmDllArray
	CMtmDllRegistry::iTimeoutMicroSeconds32
	CObserverRegistry::iIsAdded
	CObserverRegistry::iMsvSession

Constructor & Destructor Documentation

CMtmUiRegistry(CMsvSession &, TTimeIntervalMicroSeconds32)

CMtmUiRegistry	(	CMsvSession &	aMsvSession,
		TTimeIntervalMicroSeconds32	aTimeoutMicroSeconds32
	)	[protected]

Parameters

CMsvSession & aMsvSession
TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32

~CMtmUiRegistry()

~CMtmUiRegistry

(

)

[virtual]

Destructor.

Member Functions Documentation

NewL(CMsvSession &, TTimeIntervalMicroSeconds32)

IMPORT_C CMtmUiRegistry *	NewL	(	CMsvSession &	aMsvSession,
			TTimeIntervalMicroSeconds32	aTimeoutMicroSeconds32 = TTimeIntervalMicroSeconds32 (30000000)
		)	[static]

Constructs and allocates a CMtmUiRegistry object.

The client should delete this object when it is no longer required.

The registry keeps a reference count of the number of instances of each MTM in use. When that reference count falls to zero, the DLL that provides the MTM is unloaded. However, this is not done immediately, but only after the time specified in aTimeoutMicroSeconds32. This increases efficiency in cases where the DLL is required again shortly.

leave: KErrNoMemory A memory allocation failed

Parameters

CMsvSession & aMsvSession	The client's Message Server session
TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32 = TTimeIntervalMicroSeconds32 (30000000)	Time to wait before unloading MTM DLLs

NewMtmL(const RLibrary &, CBaseMtm &, CRegisteredMtmDll &)

CBaseMtmUi *	NewMtmL	(	const RLibrary &	aLib,
			CBaseMtm &	aMtm,
			CRegisteredMtmDll &	aReg
		)	const [private]

Parameters

const RLibrary & aLib
CBaseMtm & aMtm
CRegisteredMtmDll & aReg

NewMtmUiL(CBaseMtm &)

IMPORT_C CBaseMtmUi *

NewMtmUiL

(

CBaseMtm &

aMtm

)

Parameters

CBaseMtm & aMtm