/*
* Copyright (c) 2002-2004 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:   Centralised handling of various meeting request views
*
*/




#ifndef CMRHANDLER_H
#define CMRHANDLER_H

//  INCLUDES
#include <MAgnEntryUi.h>
#include <e32base.h>

// FORWARD DECLARATIONS
class CCalEntry;
class TCoeHelpContext;
class MMRModelInterface;
class CMRDialogBase;
class CCalenEditorsPlugin;
class CMRCmdHandler;
class CMRUtilsInternal;
class CMRMailboxUtils;


// CLASS DECLARATION

/**
*  Meeting request handler for dialog showing and command handling

*  @since Series S60 3.0
*/
class CMRHandler :	public CBase,
					public MAgnEntryUiCallback
    {
    public:

    	enum TMRViewStatus
			{
			EInitialView,
			ELaunchMeetingRequestView,
			ELaunchMeetingDescriptionView,
			ELaunchAttendeeView,
			ELaunchMeetingEditorView,
			ECloseMeetingRequestViews
			};

    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
        */
        static CMRHandler* NewL(RPointerArray<CCalEntry>& aEntries,
    							const MAgnEntryUi::TAgnEntryUiInParams& aParams,
    							MAgnEntryUi::TAgnEntryUiOutParams& aOutParams,   
    							MAgnEntryUiCallback& aCallback );
        /**
        * Destructor.
        */
        virtual ~CMRHandler();

     public: // new methods

		/**
		* Set help text for all views
		* @param aContext Help context
		*/
    	void SetHelpContext( const TCoeHelpContext& aContext );

    	/**
		* Execute the meeting request views
		* Has a state machine for different views
		*/
    	TInt ExecuteViewL();
    	
    	/**
    	* Indicate engine ready for reading data    	
    	*/
    	void HandleEngReadyL( const TDesC8& aMtmUid,
    	                      CMRUtilsInternal& aMRUtils,
    	                      CMRMailboxUtils& aMRMailboxUtils );

    protected: // Functions from MAgnEntryUICallback

        TBool IsCommandAvailable( TInt aCommandId );

        TInt ProcessCommandWithResultL( TInt aCommandId ); 
 
        void ProcessCommandL( TInt aCommandId);

    private:

        /**
        * C++ default constructor.
        */
        CMRHandler(	RPointerArray<CCalEntry>& aEntries,
                    const MAgnEntryUi::TAgnEntryUiInParams& aParams,
        			MAgnEntryUi::TAgnEntryUiOutParams& aOutParams,
    				MAgnEntryUiCallback& aCallback );

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();
	
	private: 	// private methods	
		        
        TInt ProcessTrappedModifCmdL( TInt aCommandId ); 
		
		TInt ExecuteEditorViewL();
		
		TInt ExecuteAttendeeViewL();
		
		void ShowOpeningNoteL();
		
		void RefreshViewL();
		
		void QueryAndSetEditingModeL();
		
		// for testing purposes only
        void LogAvailableFunctionsL() const;

    private:    // Data

		// parameters from the launching application
		const MAgnEntryUi::TAgnEntryUiInParams iInParams;
		
		// parameters for the launching application
		MAgnEntryUi::TAgnEntryUiOutParams& iOutParams;
			
		// callback for command handling
		MAgnEntryUiCallback& iCallback;
		
		// next view status
        TMRViewStatus iStatus;                

		// helpcontext id
        TCoeHelpContext* iContext;
        
        // entries not own
        RPointerArray<CCalEntry>& iEntries;        
		
		//calendar editors plugin, owned
		MAgnEntryUi* iCalendarEditorsPlugin;

		// Dialog that is currently displayed, owned
		CMRDialogBase* iCurrentDialog;
		
		// Meeting request model, owned
		MMRModelInterface* iModel;
        
        // own
        CMRCmdHandler* iCmdHandler;
    };

#endif      // CMRHANDLER_H

// End of File