epoc32/include/mtuireg.h
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
--- a/epoc32/include/mtuireg.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mtuireg.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,92 @@
-mtuireg.h
+// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// MTM client-side MTMUI registry class 
+// 
+//
+
+#if !defined __MTUIREG_H__
+#define __MTUIREG_H__
+
+
+#if !defined (__E32BASE_H__)
+#include <e32base.h>		// CActive, TFileName etc.
+#endif
+
+#if !defined (__MTCLREG_H__)
+#include <mtclreg.h>
+#endif
+
+class CBaseMtmUi;
+
+/** UI MTM factory function.
+
+A concrete User Interface MTM must implement an exported factory function of 
+this type. It should return an instance of the CBaseMtmUi-derived class that 
+provides the implementation. The factory function is called by the User Interface 
+MTM registry when a client requests this User Interface MTM.
+
+A CBaseMtmUi-derived class typically provides a NewL() function, which the 
+factory function calls.
+
+The factory function is called by ordinal. The ordinal of the function must 
+match that recorded in the MTM's registry information. 
+
+For example, a User Interface MTM whose concrete class was CEgMtmUi could 
+define a suitable factory function as:
+
+@code
+EXPORT_C CBaseMtmUi* NewEgMtmUiL(CBaseMtm& aMtm, CRegisteredMtmDll& aRegisteredDll)
+	{
+	return CEgMtmUi::NewL(aMtm, aRegisteredDll);
+	}@endcode
+
+@param aBaseMtm The CBaseMtm requesting the object.
+@param aRegisteredMtmDll Registration data for the MTM DLL.
+@return A newly-created instance of the CBaseMtmUi-derived class 
+for the User Interface MTM.
+@leave Any The factory function should leave if it cannot create the object. */
+typedef CBaseMtmUi* MtmUiFactoryFunctionL(CBaseMtm&, CRegisteredMtmDll&);
+
+// Client side MTM registry
+
+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. 
+@publishedAll
+@released
+*/
+	{
+public:
+	IMPORT_C static CMtmUiRegistry* NewL(CMsvSession& aMsvSession,
+		TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32=TTimeIntervalMicroSeconds32(30000000));
+	virtual ~CMtmUiRegistry();
+	IMPORT_C CBaseMtmUi* NewMtmUiL(CBaseMtm& aMtm);
+	//
+protected:
+	CMtmUiRegistry(CMsvSession& aMsvSession, TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32);
+	//
+private:
+	CBaseMtmUi* NewMtmL(const RLibrary& aLib, CBaseMtm& aMtm, CRegisteredMtmDll& aReg) const;
+	};
+
+
+
+#endif // __MTUIREG_H__