// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// 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:

//

#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;

/** A factory class for instantiating and restoring an application's door using 

the application's model. 

@publishedAll 

@released */

	{

public:

	IMPORT_C TApaModelDoorFactory(const MApaModelHeaderFactory* aFactory);

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 */

	{

public:

	IMPORT_C static CApaModelDoor* NewL(CApaModelHeader* aHeader);

	IMPORT_C static CApaModelDoor* NewLC(CApaModelHeader* aHeader);

	/** 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();

	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);

	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 */

	{

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. */

	/** Gets the identity of the application associated with the application model.

	@return The application identity. */

	/** 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. */

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 */

	{

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. */

protected:

	IMPORT_C MApaModelHeaderFactory();

private:

	IMPORT_C virtual void MApaModelHeaderFactory_Reserved1();

	IMPORT_C virtual void MApaModelHeaderFactory_Reserved2();

private:

	TInt iMApaModelHeaderFactory_Reserved1;

	};

#endif