/*
* Copyright (c) 2005 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:  
*       CPostcardDocument, document class for Postcard application.
*
*/




#ifndef __POSTCARDDOCUMENT_H
#define __POSTCARDDOCUMENT_H

//  INCLUDES
#include <msvapi.h>                     // CMsvEntry
#include <MsgEditorDocument.h>          // CMsgEditorDocument

// CONSTANTS

// This tell how much of the max MMS size is reserved for greeting and recipient
const TInt KPostcardAddressGreetingOverhead = 2000;
// What's the max. size the greeting text can store itself internally
// (the max. size of sent text is read from central repository)
const TInt KPostcardDefaultGreetingSegment = 512; 

// MACROS

// DATA TYPES

enum TPostcardMsgType // Type of the postcard 
    {
    EPostcardNew = 0,
    EPostcardDraft,
    EPostcardForward,
    EPostcardEdit,
    EPostcardSendAs,
    EPostcardSent
    };

enum TPostcardPart // Enumerations for different parts of the postcard
    {
    EPostcardImage = 1,
    EPostcardText = 2,
    EPostcardRecipient = 4,
    EPostcardNone = 8   // Prevents unnecessary icons to be drawn at startup.
    };

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CMmsClientMtm;
class CBaseMtmUi;
class CMsgMediaResolver;
class CMsgTextUtils;

// CLASS DECLARATION

class CPostcardDocument :public CMsgEditorDocument
    {
    public:  // Constructors and destructor

    /**
    * Destructor.
    */
    ~CPostcardDocument();

    /**
    * C++ constructor
    *
    * @param aApp   Reference to application instance
    */
    CPostcardDocument( CEikApplication& aApp );

    /**
    * Factory function to create this object
    *
    * @param aApp   Reference to application instance
    */
    static CPostcardDocument* NewL( CEikApplication& aApp );

    public: // New functions

    /**
    * InitializeL
    * Creates MediaResolver and MmsData
    */ 
    void InitializeL( RFs& aFs );

    public: // Virtuals from CMsgEditorDocument

    /**
    * DefaultMsgFolder
    * Returns default folder for new messages.
    * @return ID of the Drafts folder.
    */
    TMsvId DefaultMsgFolder() const;

    /**
    * DefaultMsgService
    * From CMsgEditorDocument
    * Returns default message service used by application
    * @return TMsvId KMsvLocalServiceIndexEntryId.
    */
    TMsvId DefaultMsgService() const;

    /**
    * CreateNewL
    * From CMsgEditorDocument
    * Creates new message.
    * A new message of type Postcard is created
    * in a destination folder.
    * Calls CreateNewL(TMsvId aServiceType, TMsvId aDestination,
    *                  TInt aTypeList).
    * @param aService service used for message
    * @param aDestFolder folder in which message will be saved eg.
    *                    KMsvDraftEntryIdValue
    * @return ID of mail operation.
    */
    TMsvId CreateNewL(TMsvId aService, TMsvId aDestFolder);

    /**
    * EntryChangedL
    * From CMsgEditorDocument
    * Called after entry is changed by BaseEditor SetEntry Function.
    * From MsgEditorDocument
    */
    void EntryChangedL();

    public: // From CMsgEditorDocument

    /*
    * Mtm
    * Accessor (Overrides baseeditor)
    * Returns CMmsClientMtm reference correctly casted from CBaseMtm
    * @param  None
    * @return Reference to documents CMmsClientMtm
    */
    CMmsClientMtm& Mtm();

    /*
    * MtmUi
    * Accessor (Overrides baseeditor)
    * Returns CMmsMtmUi reference correctly casted from CBaseMtmUi
    * @param  None
    * @return Reference to documents CMmsMtmUi
    */
    CBaseMtmUi& MtmUi();

    public:

    /**
    * Get pointer to MediaResolver
    * @return Pointer to MediaResolver
    */
    inline CMsgMediaResolver* MediaResolver( ) { return iMediaResolver; };

    /**
    * Get pointer to MmsData
    * @return Pointer to MmsData
    */
	inline CMsgTextUtils* TextUtils( ) { return iTextUtils; };
			
    /**
    * Messagetype accessor
    *
    * @return Message type
    */
    inline TPostcardMsgType MessageType() const { return iMsgType; };

    public: // new ones:

    /**
    * Sets aPart as changed
    */
    void SetChanged( TPostcardPart aPart );

    /**
    * Checks if aPart is changed
    */
    TBool Changed( TPostcardPart aPart ) const;

    /**
    * ETrue if any part of the postcard has been changed
    */
    TBool Modified( ) const;

    /**
    * Set whether message is SendAs, Forward, Reply or Open from Draft.
    * Function determines it from launch flags & entry flags.
    */
    void SetMessageType();

    /**
    * Returns the max size of the message
    */
	TInt MaxMessageSize( ) const;

    /**
    * Returns the max size of the image (max message - textrecipientoverhead)
    */
	TInt MaxImageSize( ) const;

    /**
    * Called by Controller so it knows if the app is started from ROM or not
    * Returns full filepath to this application
    */        
    TFileName AppFullName( );

    /**
    * Check if the mimetype is an image
    */
    TBool IsImage( const TDataType& aMimeType );

    /**
    * Tells the maximum width and height of the image.
    * If image is bigger than that -> scaling is needed
    */
	TSize MaxImageDimensions( );
	
    protected:  // New functions

    /**
    * ConstructL
    * 2nd phase constructor.
    */
    void ConstructL();

    private: // New Functions

    /**
    * Creates a new CPostcardAppUi
    */
    CEikAppUi* CreateAppUiL();

    private:  // data

    RFs                 iFs;
    TInt                iMsgChanged;
    TPostcardMsgType    iMsgType;
    CMsgMediaResolver*  iMediaResolver;
    CMsgTextUtils*      iTextUtils;
    TInt 				iMaxMessageSize;
    };


#endif   // __POSTCARDDOCUMENT_H

// End of file