/*

* Copyright (c) 2005-2007 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:  Execute Maps application.

*

*/

#ifndef CPMAPCMD_H

#define CPMAPCMD_H

// INCLUDES

#include <e32base.h>

#include <MPbk2Command.h>

#include <lbsfieldids.h>

#include <mngeocoder.h>

#include <VPbkFieldType.hrh>

#include <Pbk2UIFieldProperty.hrh>

#include <MVPbkContactObserver.h>

// FORWARD DECLARATIONS

class MPbk2CommandObserver;

class MPbk2ContactUiControl;

class MVPbkStoreContact;

class CPosLandmark;

class MPbk2ContactEditorControl;

class MPbk2ContactEditorControlExtension;

class MVPbkStoreContactField;

class TLocality;

class CMnMapView;

enum TCurrentMapLaunchedByState

    {

    EMapNone = 1,

    EMapAssignFromMaps,

    EMapShowOnMaps

    };

// CLASS DECLARATION

/**

 * Phonebook 2 show on map command object.

 */

class CPmapCmd : public CActive,

				 public MPbk2Command,

				 public MVPbkContactObserver

    {

    public: // Constructors and destructor

        /**

         * Creates a new instance of this class.

         * @param iEditorControl    Editor control.

         * @param aContact          Contact store.

         * @param aCommandId        Command.

         * @return  A new instance of this class.

         */

        static CPmapCmd* NewL(

        		MPbk2ContactEditorControl& iEditorControl,

        		MVPbkStoreContact& aContact, 

        		TInt aCommandId );

        /**

         * Creates a new instance of this class.

         *

         * @param aUiControl        UI control.

         * @param aCommandId        Command.

         * @return  A new instance of this class.

         */

        static CPmapCmd* NewL(

        		MPbk2ContactUiControl& aUiControl, 

        		TInt aCommandId );

        /**

         * Destructor.

         */

        ~CPmapCmd();

        // CActive-related methods

       /**

       * RunL method to handle the user selection

       */

       void RunL();

       /**

       * Cancel method to handle the user selection

       */

       void DoCancel();

       /**

       * Function to handle any errors in async request

       * @param aError   Error Code

       */

       TInt RunError( TInt aError );

       /**

       * Disconnects from provider, when operation is completed

       */

       void Reset();

    public: //From MVPbkContactObserver

    	void ContactOperationCompleted( TContactOpResult aResult );

        void ContactOperationFailed(

        		TContactOp aOpCode, 

    	        TInt aErrorCode, 

    	        TBool aErrorNotified);

    public: // From MPbk2Command

        void ExecuteLD();

        void ExecuteL();

        void AddObserver(

                MPbk2CommandObserver& aObserver );

        void ResetUiControl(

                MPbk2ContactUiControl& aUiControl );

    public: // Implementation

    	/**

         * Check if exist Maps Api provider. 

         *

         * @return  True if provider exist.

         */

    	static TBool CheckViewProviderL();

    private: // Members

        CPmapCmd(

        		MPbk2ContactUiControl& aUiControl, 

        		TInt aCommandId );

        CPmapCmd(

        		MPbk2ContactEditorControl& iEditorControl,

        		MVPbkStoreContact& aContact,

                TInt aCommandId );

        void ConstructL();

        void FinishProcess();   

        /**

         * Try to get address from contact editor 

         *

         * @return  Address group ID or EPbk2FieldGroupIdNone.

         */

        TPbk2FieldGroupId GetAddressFromEditorView();

        /**

         * Try to get address from UI control 

         *

         * @return  Address group ID or EPbk2FieldGroupIdNone.

         */

        TPbk2FieldGroupId GetAddressFromUiControl();

        /**

         * Try to get address if there is only one address in contact. 

         *

         * @return  Address group ID or EPbk2FieldGroupIdNone.

         */

        TPbk2FieldGroupId GetAddressIfIsAlone();

        /**

         * Run show on Maps API.

         *

         * @param  aAddressType Address to show.

         */

        void EditorShowOnMapsL( TVPbkFieldTypeParameter aAddressType );

        /**

         * Run assign on Maps API.

         *

         * @param  aAddressType Address to assign.

         */

        void EditorAssignFromMapsL( TVPbkFieldTypeParameter aAddressType );

        /**

         * Updates Contact address fields.

         *

         * @param  aLandmark 		fields returned from Maps API.

         * @param  aPositionField 	Type of CPosLandmark field.

         * @param  aVersitSubField 	Type of Contact field.

         * @param  aAddressType 	Address type.

         */

        void UpdateFieldL(

        		const CPosLandmark& aLandmark,

        		_TPositionFieldId aPositionField,

        		TVPbkSubFieldType aVersitSubField,

        		TVPbkFieldTypeParameter aAddressType );

        /**

         * Updates Contact geocoordinates.

         *

         * @param  aLandmark        fields returned from Maps API.

         * @param  aAddressType 	Address type.

         */

        void UpdateCoordsL(

                const CPosLandmark& aLandmark,

				TVPbkFieldTypeParameter aAddressType );

        /**

         * Fills CPosLandmark object with Contact address fields.

         *

         * @param  aLandmark 		object have geocoordinates.

         * @param  aAddressType 	Address type.

         */

        void FillLandmarkL(

        		CPosLandmark& aLandmark, 

        		TVPbkFieldTypeParameter aAddressType );

        /**

         * Sets CPosLandmark object with land mark name.

         *

         * @param  aLandmark        object have geocoordinates.

         */

        void SetLandmarkNameL(CPosLandmark& aLandmark);

        /**

         * Fills CPosLandmark object with Contact geocoordinates.

         *

         * @param  aLandmark 		object have geocoordinates.

         * @param  aAddressType 	Address type.

         */

        TBool FillGeoLandmarkL(

                CPosLandmark& aLandmark, 

                TVPbkFieldTypeParameter aAddressType );

        /**

         * Fills CPosLandmark object with geocoordinates.

         *

         * @param  aLandmark 		object have geocoordinates.

         * @param  aDataText 		text with geocoordinates.

         */

        TBool DoFillGeoLandmarkL(

                CPosLandmark& aLandmark, 

                const TDesC& aDataText );

        /**

         * Get Control extension. 

         *

         * @return  Contact Editor Extension or NULL.

         */

        MPbk2ContactEditorControlExtension* ControlExtension();

        /**

         * Shows querry for selecting address. 

         *

         * @return  Address group ID or EPbk2FieldGroupIdNone.

         */

        TPbk2FieldGroupId SelectAddressL();

        /**

         * Check if exist address in Contact. 

         *

         * @return  True if any address exist in Contact.

         */

        TBool IsAddressInContact();

        /**

         * Gets group id from Store Field.

         *

         * @param  aField 			Store field.

         * @return   		 		Address group ID or EPbk2FieldGroupIdNone.

         */

        TPbk2FieldGroupId GetFieldGroupL( MVPbkStoreContactField& aField );

        /**

         * Handle the selection of map which was launched from Show On Map option. 

         */

        void HandleSelectiOnShowOnMapsL();

        /**

         * Handle the selection of map which was launched from Assign From Maps option. 

         */

        void HandleSelectiOnAssignFromMapsL();

    private: // Data

    	/// Ref: Contact editor control

        MPbk2ContactEditorControl* iEditorControl;

        /// Ref: Contact UI control

        MPbk2ContactUiControl* iUiControl;

    	/// Ref: The edited contact

    	MVPbkStoreContact* iContact;

        /// Ref: Command observer

        MPbk2CommandObserver* iObserver;

        /// Own: Map View Provider

        CMnProvider* iMapViewProvider;

        /// Own: Map View

        CMnMapView* iMapView;

        /// Own: Is in editor address view?

        TBool iAddressView;

        /// Own: command id

        TInt iCommandId;

        /// Own: Is in editor address view?

		TBool iAddressUpdatePrompt;

		/// Own: Current map launched is by which option

		TCurrentMapLaunchedByState iCurrentMapLaunchedByState;

		/// Own: Current AddressType

		TVPbkFieldTypeParameter iAddressType;

		/// Own: Is already address is there?

		TBool iNoAddress;

    };

#endif // CPMAPCMD_H

// End of File