--- a/epoc32/include/mtudreg.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mtudreg.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,87 @@
-mtudreg.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:
+//
+
+#if !defined __MTUDREG_H__
+#define __MTUDREG_H__
+
+#if !defined (__MTCLREG_H__)
+#include <mtclreg.h>
+#endif
+
+class CBaseMtmUiData;
+
+/** UI Data MTM factory function.
+
+A concrete UI Data MTM must implement an exported factory function of this
+type. It should return an instance of the CBaseMtmUiData-derived class that
+provides the implementation. The factory function is called by the UI Data
+MTM registry when a client requests this UI Data MTM.
+
+A CBaseMtmUiData-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.
+
+The CRegisteredMtmDll& argument passes the registration data for the MTM DLL.
+
+The return value is a newly-created instance of the CBaseMtmUi-derived class
+for the User Interface MTM.
+
+The factory function should leave if it cannot create the object.
+
+For example, a UI Data MTM whose concrete class was CEgMtmUiData could define
+a suitable factory function as:
+
+@code
+EXPORT_C CBaseMtmUiData* NewEgMtmL(CRegisteredMtmDll& aRegisteredMtmDll)
+ {
+ return CEgMtmUiData::NewL(aRegisteredMtmDll);
+ }
+@endcode */
+typedef CBaseMtmUiData* MtmUiDataFactoryFunctionL(CRegisteredMtmDll&);
+
+// Client side MTM UI data registry
+
+class CMtmUiDataRegistry : public CObserverRegistry
+/** Accesses the UI Data MTM registry.
+
+This registry holds details of the all the
+UI Data MTMs currently available on the system. Message client applications
+use this class to get a CBaseMtmUiData-derived object by which to access UI
+Data 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 CMtmUiDataRegistry* NewL(CMsvSession& aMsvSession,
+ TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32=TTimeIntervalMicroSeconds32(30000000));
+ virtual ~CMtmUiDataRegistry();
+ IMPORT_C CBaseMtmUiData* NewMtmUiDataLayerL(const TUid& aMtmTypeUid);
+ //
+protected:
+ CMtmUiDataRegistry(CMsvSession& aMsvSession, TTimeIntervalMicroSeconds32 aTimeoutMicroSeconds32);
+ //
+private:
+ CBaseMtmUiData* NewMtmL(const RLibrary& aLib, CRegisteredMtmDll& aReg) const;
+ };
+
+
+
+#endif // __MTUDREG_H__