/*

* Copyright (c) 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:  Application's adapter class to Map and Navigation use cases

*

*/

#ifndef CEVTMGMTUIMAPNAVIGATIONADAPTER_H

#define CEVTMGMTUIMAPNAVIGATIONADAPTER_H

// INCLUDES

#include <AiwCommon.h>

#include <e32std.h>

class CAiwServiceHandler;

class CPosLandmark;

class MEvtMgmtUiMapAndNavigationObserver

    {

public:

    /**

     * It will be used to notify observer that map operation

     * has been completed.

     * @param aPlace place retrieved from map

     * @param aErrorCode It will contain the status of the operation

     *                KErrNone if successful otherwise error status code          

     */

    virtual void HandleMapAndNavigationResponseL(TInt aErrorCode, const TPtrC aPlace, TCoordinate aTriggerLocation )=0;  

    };

/**

* The class CEvtMgmtUiMapNavigationAdapter contains the implemenation 

* for all the uses cases of Map and Navigation.

* Functionality:

*   To check map service providers

*   To show location on map

*   To navigate to the location

*   To retrieve location from map

*/

class CEvtMgmtUiMapNavigationAdapter : public CBase, 

								       public MAiwNotifyCallback

	{

	public: // Constructors and destructor

		/**

        * Symbian 1st phase static constructor. 

        *       

        */        

        static CEvtMgmtUiMapNavigationAdapter* NewL();

		/**

        * Symbian 1st phase static constructor. 

        * Leaves the constructed object on Cleanup Stack.     

        */        

        static CEvtMgmtUiMapNavigationAdapter* NewLC();

        /**

        * Destructor.

        */

        ~CEvtMgmtUiMapNavigationAdapter();		

    public: // New methods     	

    	/**

    	* This method is called for the get landmarks from map use case.

    	* 

    	* @since S60 v9.1

    	*/

    	void PlaceFromMapL();

    	/**

    	 * It will return place value recieved from map.

    	 * 

    	 * @since S60 v9.1

    	 * 

    	 * @ret selected place

    	 */

    	TPtrC Place() const;

    	/**

    	 * It will return total map service providers.

    	 * 

    	 * @since S60 v9.1

    	 * 

    	 * @ret total number of map service providers

    	 */

    	TInt MapServiceProvidersL();

    	/**

         * It will show location on map

         * 

         * @since S60 v9.1

         */

    	void ShowOnMapL();

    	/**

         * It will navigate to location

         * 

         * @since S60 v9.1

         */

    	void NavigateToPlaceL();

    	/**

         * It will set observer to notify completion of map operation

         * 

         * @since S60 v9.1

         * 

         *  @param [in] aObserver - observer to notify completion of map operation

         */

    	void SetObserver( MEvtMgmtUiMapAndNavigationObserver* aObserver );

    	/**

         * It will set place

         * 

         * @since S60 v9.1

         * 

         * @param [in] aPlace - place of existing event

         *                    - empty for newly created event

         */

    	void SetPlaceL( const TPtrC& aPlace );

    	/**

         * It will set location

         *  

         * @since S60 v9.1

         * 

         * param[in] aTriggerLocation - location of trigger of existing event

         *                            - NaN for newly created event

         */

    	void SetLocation( TCoordinate  aTriggerLocation );

    public: // from MAiwNotifyCallback

        /**

        * The callback function for the get landmark from map use case

        * This function gets a callback once the user selects a location

        * from map to save as a landmark.

        */

        TInt HandleNotifyL( TInt aCmdId, 

                            TInt aEventId, 

                            CAiwGenericParamList &aEventParamList, 

                            const CAiwGenericParamList &aInParamList );

    private:

    	/**

        * C++ default constructor.                 

        */

        CEvtMgmtUiMapNavigationAdapter(); 

        /**

        * Symbian 2nd phase constructor. 

        */

        void ConstructL();

    private: // Private functions

        /**

         * It will set place details from landmark recieved from map

         *  

         * @since S60 v9.1

         * 

         * @param[in] aLandmark - landmark selected on map      

         */

        void SetPlaceFromLandmarkL( CPosLandmark& aLandmark );

    private: // Data    	

    	// Owns : Pointer to AIW service handler to send service commands     	

    	CAiwServiceHandler*     iAiwServiceHandler;

    	// Owns : Generic parameter input list     

    	CAiwGenericParamList*   iInList;

    	// Owns : Generic parameter output list    	     	

        CAiwGenericParamList*   iOutList;    

        // Owns : place details     

        HBufC*                  iPlace;       

        // Does not own : observer to notify completion of map operation            

        MEvtMgmtUiMapAndNavigationObserver* iObserver;

        // trigger location of the event

        TCoordinate            iTriggerLocation ;        

	};

#endif //CEVTMGMTUIMAPNAVIGATIONADAPTER_H

// End of file