--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/appfw/apparchitecture/inc/APAMDR.H	Tue Feb 02 10:12:00 2010 +0200
@@ -0,0 +1,181 @@
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of "Eclipse Public License v1.0"
+// which accompanies this distribution, and is available
+// at the URL "http://www.eclipse.org/legal/epl-v10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// apamdr.h
+//
+
+#ifndef __APAMDR_H__
+#define __APAMDR_H__
+
+#include <e32std.h>
+#include <e32base.h>
+#include <gdi.h>
+#include <apadbase.h>
+
+class RReadStream;
+class RWriteStream;
+class CStreamStore;
+class CStreamDictionary;
+class CEmbeddedStore;
+class TApaAppIdentifier;
+class MApaModelHeaderFactory;
+class CApaModelHeader;
+
+
+/** A factory class for instantiating and restoring an application's door using 
+the application's model. 
+
+@publishedAll 
+@released */
+class TApaModelDoorFactory : public MPictureFactory
+// Recognizes KUidPictureTypeDoor and creates CApaModelDoor pictures
+	{
+public:
+	IMPORT_C TApaModelDoorFactory(const MApaModelHeaderFactory* aFactory);
+public:	// from MPictureFactory
+	IMPORT_C void NewPictureL(TPictureHeader& aPictureHeader, const CStreamStore& aPictureStore) const; // used to create CApaDoor's during document restore only 
+private:
+	const MApaModelHeaderFactory* iHeaderFactory;
+	TInt iTApaModelDoorFactory_Reserved1;
+	};
+
+
+/** A persistent representation of a door that also acts as a wrapper around an 
+application's model.
+
+The class allows embedded data to be manipulated without requiring the whole 
+associated application. 
+
+@publishedAll 
+@released */
+class CApaModelDoor : public CApaDoorBase
+	{
+public:
+	IMPORT_C static CApaModelDoor* NewL(CApaModelHeader* aHeader);
+	IMPORT_C static CApaModelDoor* NewLC(CApaModelHeader* aHeader);
+	IMPORT_C static CApaModelDoor* NewL(const CStreamStore& aStore, TStreamId aHeadStreamId, const MApaModelHeaderFactory* aFactory);
+
+	/** Gets the application model wrapper object.
+	
+	@return A pointer to the application model wrapper object. */
+	inline CApaModelHeader* ModelHeader() { return iModelHeader; }
+	
+	/** Sets the format of the door.
+	
+	@param aFormat The format for the graphical representation of the embedded 
+	document. */
+	inline void SetFormat(TFormat aFormat) { iFormat = aFormat; }
+	IMPORT_C TStreamId StoreL(CStreamStore& aStore) const;
+	IMPORT_C void RestoreL(const CStreamStore& aStore,TStreamId aHeadStreamId,const MApaModelHeaderFactory* aFactory);
+	IMPORT_C ~CApaModelDoor();
+public:	// from CPicture
+	IMPORT_C void DetachFromStoreL(TDetach /*aDegree*/=EDetachFull); //lint !e1735 Virtual function has default parameter - Inherited from CPicture, must be fixed there
+	IMPORT_C void ExternalizeL(RWriteStream& aStream)const;
+	IMPORT_C void Draw(CGraphicsContext& aGc,const TPoint& aTopLeft,const TRect& aClipRect,MGraphicsDeviceMap* aMap)const; 
+	IMPORT_C void GetOriginalSizeInTwips(TSize& aSize)const;
+	IMPORT_C void SetScaleFactor(TInt aScaleFactorWidth,TInt aScaleFactorHeight); 
+	IMPORT_C TInt ScaleFactorWidth()const; 
+	IMPORT_C TInt ScaleFactorHeight()const;
+private:
+	CApaModelDoor();
+	CApaModelDoor(CApaModelHeader* aHeader);
+	static CStreamDictionary* ReadStreamDictionaryLC(const CStreamStore& aSourceStore,TStreamId aStreamId);
+	static void CopyStoreL(const CEmbeddedStore& aSourceStore,RWriteStream& aTargetStream);
+	void InternalizeModelL(const MApaModelHeaderFactory& aFactory);
+private: // from CApaDoorBase
+	TSize GlassDoorSize()const;
+private:
+	CApaModelHeader* iModelHeader;
+	CEmbeddedStore* iStore;
+	TSize iScaleFactor;
+	CBufSeg* iStoreHost; // the host for the embedded store, if the door has been detached from its originating store
+	};
+
+
+// Abstract wrapper for an applications model - used for file format conversion etc
+/** An interface class that acts as a wrapper for an application model.
+
+This is also known as an application model header.
+
+The class provides the knowledge for internalizing and externalizing an application 
+model's data. An instance of the class is used by CApaModelDoor.
+
+A concrete implementation of the class must be supplied by the application 
+model (not the application UI). An instance of the class is constructed by 
+a factory object that implements the MApaModelHeaderFactory interface; the 
+factory object is also supplied by the application model (not the application 
+UI).
+
+@publishedAll
+@released
+@see CApaModelDoor
+@see TApaModelDoorFactory
+@see MApaModelHeaderFactory */
+class CApaModelHeader : public CBase
+	{
+public:
+	/** Stores the model and its components in the specified store.
+	
+	@param aStore The store in which the model's components are to be stored.
+	@param aDict The stream dictionary into which stream IDs and associated UIDs 
+	are put. */
+	virtual void StoreL(CStreamStore& aStore, CStreamDictionary& aDict) const = 0;
+	/** Gets the identity of the application associated with the application model.
+	
+	@return The application identity. */
+	virtual TApaAppIdentifier AppId() const = 0;
+	/** Restores the model to the specified degree.
+	
+	An implementation of this function should propagate this call to all components 
+	of the model.
+	
+	@param aDegree The degree to which restoration is needed. */
+	virtual void DetachFromStoreL(CPicture::TDetach aDegree) = 0;
+protected:
+	IMPORT_C CApaModelHeader();
+private:
+	IMPORT_C virtual void Reserved_1();
+	IMPORT_C virtual void Reserved_2();
+private:
+	TInt iCApaModelHeader_Reserved1;
+	};
+	
+
+/** An interface class that applications implement to construct an application model 
+wrapper object, also known as the application model header.
+
+@publishedAll
+@released
+@see CApaModelHeader */
+class MApaModelHeaderFactory
+	{
+public:	
+	/** Creates and returns an application model wrapper object.
+	
+	@param aStore The store containing model data.
+	@param aDict The stream dictionary. 
+	@param aAppId The application's identity held as a stream in the application's 
+	store
+	@return A pointer to the new application model wrapper object. */
+	virtual CApaModelHeader* NewHeaderL(const CStreamStore& aStore, const CStreamDictionary& aDict, const TApaAppIdentifier& aAppId) const = 0;
+protected:
+	IMPORT_C MApaModelHeaderFactory();
+private:
+	IMPORT_C virtual void MApaModelHeaderFactory_Reserved1();
+	IMPORT_C virtual void MApaModelHeaderFactory_Reserved2();
+private:
+	TInt iMApaModelHeaderFactory_Reserved1;
+	};
+
+
+#endif