/*
* Copyright (c) 2002 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 "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: 
*      Declaration of Scheme handler interface implementation for mailto:// scheme
*      
*
*/


#ifndef MAIL_TO_HANDLER_H
#define MAIL_TO_HANDLER_H

// INCLUDES

#include "BaseHandler.h"
#include "BrowserTelService.h"
#include <e32base.h>
#include <eikdoc.h>
#include <apparc.h>

//#include <bamdesca.h>

// FORWARD DECLARATION

// CLASS DECLARATION


/**
* Scheme Handler IF implementation class for mailto scheme
*/
class CMailToHandler : public CBaseHandler, public MBrowserTelServiceObserver
    {

    public:     // Constructors and destructor

        /**
        * Two phased constructor. Leaves on failure.
        * @param - aUrl
        * @return The created object.
        */      
		static CMailToHandler* NewL( const TDesC& aUrl );

       /**
        * Destructor.
        */      
        virtual ~CMailToHandler();
        
	private: // Constructors

        enum TSchemeMailToFields          ///<Possible MailTo fields
            {
            ESchemeMailTo,                ///< MailTo.
            ESchemeSubject,               ///< Subject.
            ESchemeMsgBody,               ///< Message Body.
            ESchemeCc,                    ///< CC.
            ESchemeTo,                    ///< TO.
            ESchemeBcc,                   ///< Bcc.
			ESchemeNoMore
            };

        /**
        * Constructor.
        */      
		CMailToHandler();

        /**
        * Second phase constructor. Leaves on failure.
		* @param - aUrl
        */      
		void ConstructL( const TDesC& aUrl );

    private: // Functions from base classes

        /**
		* Url Handler with embedding
		* @param -
		*/
		void HandleUrlEmbeddedL();

		/**
		* Url Handler without embedding
		* @param -
		*/
		void HandleUrlStandaloneL();

		/**
		* Get the appropriate filed from the url
		* @param aHeader the name of the field
		*/
		TPtrC GetField(const TDesC& aHeader);

		/**
		* Check if the field is in the url
		* @param aHeader the name of the field
		* @return TBool
		*/
		TBool IsHeader(const TDesC& aHeader);

		/**
		* Starting position of the specific field
		* @param aHeader the name of the field
		* @return TInt Starting position of the specific field
		*/
        TInt FieldStart(const TDesC& aHeader);

		/**
		* Ending position of the specific field
		* @param aHeader the name of the field
		* @return TInt Ending position of the specific field
		*/
		TInt FieldEnd( const TDesC& aHeader );

		/**
		* Get the enumerated position of the specific field
		* @param aHeader the name of the field
		* @return TSchemeMailToFields
		*/
		TSchemeMailToFields GetHeaderPos( const TDesC& aHeader );

		/**
		* Get the next enumerated position of the specific field
		* @param aPos enumerated position of the field
		*/
		//TSchemeMailToFields CMailToHandler::GetNextField(TSchemeMailToFields aPos);
        TInt GetNextField( TInt aStart );

		/**
        * Notification of the state change.
        * @param aEvent The new state.
		* @return TSchemeMailToFields
        */
		void BrowserTelServiceEvent(TBrowserTelServiceState aEvent);

		/**
        * Notification of the error that occurred.
        * @param aError The error.
        */
		void BrowserTelServiceError(TBrowserTelServiceError aError);

		/**
        * Notification when the phonebook dialog has been exited.
        * @param.
        */
		void NotifyClient();

		/**
        * Returns the minimum value of the arguments.
        * @param.
        * @return
        */
        TInt Minimum( TInt aPos1, TInt aPos2, TInt aPos3, TInt aPos4, TInt aPos5 );

        /**
        * Changes ?to= hedear into comma in case of multiple recipients
        * @param aRecipients - email addresses.
        * @return parsed descriptor
        */
        HBufC* ChangeSeparationLC( const TDesC& aRecipients );

	private: // Data
		CBrowserTelService* iTelService; ///< Owned.
	};

#endif /* def MAIL_TO_HANDLER_H */