/*

* Copyright (c) 2002-2006 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:  Central repository handler for mail

*

*/

#ifndef CMAILCRHANDLER_H

#define CMAILCRHANDLER_H

//  INCLUDES

#include <e32base.h>

#include <cenrepnotifyhandler.h>

#include <s32std.h>

#include "MailVariant.hrh"

// FORWARD DECLARATIONS

class CRepository;

class CMsgMailDocument;

// CLASS DECLARATION

/**

*  Central repository handler for mail

*  Sets and observes central repository keys for mail

*

*  @lib msgeditorutils.lib

*  @since Series 60 3.0

*/

class CMailCRHandler :	public CBase,

						public MCenRepNotifyHandlerCallback

    {

    public:  // Constructors and destructor

    	enum ERepository

			{

			EMailRepository = 0,

			ECommonUiRepository,

			EMuiuVariationKeys,

			ERepositoryOutOfBounds

			};

        /**

        * Two-phased constructor.

        * @param aModel key observer.

        */

        IMPORT_C static CMailCRHandler* NewL(CMsgMailDocument *aModel);

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CMailCRHandler();

    public: // New functions

		/**

		* Fetches the integer from CR with given keys

		* @param aUid Uid to be used

		* @param aKey Which value is to be fetched

		* @param aValue Variable to store fetched value

		* @return KErrNone, when no errors happened

		*/

		IMPORT_C TInt GetCRInt(

			const TUid&     aUid,

			const TUint32   aKey,

			TInt&           aValue ) const;

        /**

        * Sets the integer to CR with given keys

        * @param aUid Uid to be used

        * @param aKey Which value is to be fetched

        * @param aValue Variable that contains value to be stored

        * @return KErrNone, when no errors happened

        */

        IMPORT_C TInt SetCRInt(

            const TUid&     aUid,

            const TUint32   aKey,

            const TInt      aValue ) const;

		/**

		* Fetches the real from CR with given keys

		* @param aUid Uid to be used

		* @param aKey Which value is to be fetched

		* @param aValue Variable to store fetched value

		* @return KErrNone, when no errors happened

		*/

    	IMPORT_C TInt GetCRReal(

	  		const TUid&     aUid,

	  		const TUint32   aKey,

	  		TReal&          aValue ) const;

		/**

        * Sets the real to CR with given keys

        * @param aUid Uid to be used

        * @param aKey Which value is to be fetched

        * @param aValue Variable that contains value to be stored

        * @return KErrNone, when no errors happened

        */

		IMPORT_C TInt SetCRReal(

	       	const TUid&     aUid,

	       	const TUint32   aKey,

    	   	const TReal&    aValue ) const;

		/**

		* Fetches the binary from CR with given keys

		* @param aUid Uid to be used

		* @param aKey Which value is to be fetched

		* @param aValue Variable to store fetched value

		* @return KErrNone, when no errors happened

		*/

       	IMPORT_C TInt GetCRBinary(

	    	const TUid&     aUid,

	    	const TUint32   aKey,

    		TDes8&          aValue ) const;

		/**

        * Sets the integer to CR with given keys

        * @param aUid Uid to be used

        * @param aKey Which value is to be fetched

        * @param aValue Variable that contains value to be stored

        * @return KErrNone, when no errors happened

        */

		IMPORT_C TInt SetCRBinary(

    		const TUid&     aUid,

    		const TUint32   aKey,

    		const TDesC8&   aValue ) const;

		/**

		* Fetches the string from CR with given keys

		* @param aUid Uid to be used

		* @param aKey Which value is to be fetched

		* @param aValue Variable to store fetched value

		* @return KErrNone, when no errors happened

		*/

    	IMPORT_C TInt GetCRString(

		    const TUid&     aUid,

		    const TUint32   aKey,

    		TDes16&         aValue ) const;

		/**

        * Sets the integer to CR with given keys

        * @param aUid Uid to be used

        * @param aKey Which value is to be fetched

        * @param aValue Variable that contains value to be stored

        * @return KErrNone, when no errors happened

        */

    	IMPORT_C TInt SetCRString(

			const TUid&     aUid,

		    const TUint32   aKey,

    		const TDesC16&  aValue ) const;

		/**

        * Sets the notifyhandler on specific key

        * @param aObserver observer

        * @param aRepository repository to be watched. See ERepository

        * @param aKeyType keytype to be watched 

        * @param aKeyValue which uid is watched

        */

		IMPORT_C void SetNotifyHandlerL(

			MCenRepNotifyHandlerCallback* aObserver,

			CMailCRHandler::ERepository aRepository, 

			CCenRepNotifyHandler::TCenRepKeyType aKeyType, 

			TUint32 aKeyValue );

		/**

		* Fetches all parameters from central repository and initializes model

        */

		IMPORT_C void UpdateModelFromCentralRepositoryL();

		/**

		* inline

		* MailAdditionalHeaders

		* @return ETrue if Additional Bcc header field is supported.

		*/

        inline TBool MailAdditionalHeaders() const;	

		/**

		* inline

		* MailAttachmentField

		* @return ETrue if Attachment field is supported.

		*/

        inline TBool MailAttachmentField() const;

		/**

		* inline

		* MailEncodingSetting

		* @return ETrue if EncodingSetting is supported.

		*/

        inline TBool MailEncodingSetting() const;

		/**

		* inline

		* MailCopyMoveSupport

		* @return ETrue if MailCopyMove is supported.

		*/

        inline TBool MailCopyMoveSupport() const; 

		/**

		* inline

		* MailInsertToolBar

		* @return ETrue if Insert toolbar is supported.

		*/

        inline TBool MailInsertToolBar() const;

    public: // Functions from base classes

        /**

        * From MCentRepNotifyHandlerCallback.

	    */

        void HandleNotifyInt(

			TUint32 aId, TInt aNewValue );

        /**

		* From MCentRepNotifyHandlerCallback.

	    */

        void HandleNotifyReal(

			TUint32 aId, TReal aNewValue);

        /**

		* From MCentRepNotifyHandlerCallback.

	    */

        void HandleNotifyString(

			TUint32 aId, const TDesC16& aNewValue);

        /**

		* From MCentRepNotifyHandlerCallback.

	    */

        void HandleNotifyBinary(

			TUint32 aId, const TDesC8& aNewValue);

        /**

		*   From MCentRepNotifyHandlerCallback.

		*/

		void HandleNotifyError(

			TUint32 aId, TInt aError, CCenRepNotifyHandler* aHandler );

		/**

        *   From MCentRepNotifyHandlerCallback.

        */

        void HandleNotifyGeneric( TUint32 aId );

		/**

        * Through this method the Property subscribers notify of 

        * Property changes.

        * @param aCategory The category of the property to be observed

		* @param aKey The subkey of the property to be observed

		*/

        void HandlePropertyChangedL( const TUid& aCategory, TInt aKey );

    private: // private functions

    	/**

		* Gets the CR client according to Uid to be used

		* @param aUid Uid to be used

		* @param aClient Variable to client shall be stored

		* @return KErrNone, when succesful

		*/

		TInt GetClientForUid(

			const TUid&		aUid,

			CRepository*&  	aClient ) const;

    private: //private constructors

        /**

        * C++ default constructor.

        */

        CMailCRHandler(CMsgMailDocument* aModel);

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private:    // Data

    // a pointer to the model (document)

	CMsgMailDocument* iModel;

	// A CR session & notifier for mail

    RPointerArray<CRepository> iSessions;

    RPointerArray<CCenRepNotifyHandler> iSettingsNotifyHandlers;

    // Mail UI local variation flags

    TInt iMailUiLocalVariationFlags;

    // Muiu variation flags

    TInt iMuiuVariationFlags;

    // MMS variation flags

    TInt iMmsVariationFags;    

    };

// Inline functions

#include "CMailCRHandler.inl"

#endif      // CMAILCRHANDLER_H

// End of File