/*
* Copyright (c) 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:    LandmarksUi Content File -    CLmkSaveLandmarkUtils contains methods in aiding saving landmarks
*              : from the received landmarks package via Landmarks messaging
*
*/







#ifndef CLMKSAVELANDMARKUTILS_H
#define CLMKSAVELANDMARKUTILS_H

#include <e32std.h>
#include <e32base.h>
#include <EPos_CPosLandmarkDatabase.h>
#include "CLmkLandMarkCategoriesName.h"
#include "CLmkAOOperation.h"

// FORWARD DECLARATIONS
class CLmkParser;
class CEikonEnv;


/**
*  CLmkSaveLandmarkUtils class.
* This class contains the methods for saving landmarks from
* received landmarks package via Landmarks messaging
* These methods are currently used by CLmkPackageEditor and
* CLmkPackageSelector
*/
class  CLmkSaveLandmarkUtils : public CBase, public MLmkAOOperationObserver
    {
    public:  // Constructors and destructor

        /**
        * Creates  CLmkSaveLandmarkUtils
        * @return newly instantiated object
        */
        IMPORT_C static  CLmkSaveLandmarkUtils* NewL(CPosLandmarkDatabase& aDb,CLmkParser& aParser);

        /**
        * Destructor.
        */
        virtual ~ CLmkSaveLandmarkUtils();

    protected:  // Constructors and destructor
        /**
        * C++ constructor.
        * @return newly instantiated object
        */
         CLmkSaveLandmarkUtils(CPosLandmarkDatabase& aDb,CLmkParser& aParser);

        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();
    public://from MLmkAOOperationObserver

        void HandleOperationL(TOperationTypes aType, TReal32 aProgress, TInt aStatus );

    public :

        /*
         * Check for new received categories
         */
        TInt CheckForNewCategoriesL(RArray<TUint> & aSelectedIndices,
                                    TDes& aNewFoundCategory,
                                    RArray<TCategoryName>& aNewcategories);
         /**
        * Checks the new received categories, this function is used by the
        * category search operation.
        * @param aNewFoundCategory
        * @param aNewcategories
        */
        TInt CheckForNewCategories2L(
                                     TDes& aNewFoundCategory,
                                     RArray<TCategoryName>& aNewcategories);
         /*
         * Display confirmation query
         */
        TInt CategoryAddConfirmationQueryL( TInt aAmount, const TDesC& aNewCategoryName );
         /*
         * Display confirmation note
         */
        void LmsSavedConfirmationNoteL(RArray<TUint> & aImportIndexes,
                                           			  TInt aEditedItemIndex = 0);

    public://New Functions
        /**
        * Sets the observer for searching new categories operations
        * from a landmarks pacakge.
        * @param aObserver
        */
        void SetObserver(MLmkAOOperationObserver* aObserver);
        /**
        * Cancels operations for searching new categories from the landmarks
        * pacakge
        */
        void CancelSearchNewCat();
        /**
        * Starts the search operations to find out new categories in landmarks
        * package
        * @param aNoOfNewCategories
        * @param aNewCategories
        * @param aNewCategoryFound
        */
        void StartSearchNewCatL(TInt& aNoOfNewCategories,
                                RArray<TCategoryName>& aNewCategories,
                                TCategoryName& aNewCategoryFound);
 	private :
 		void CheckCategoryInDatabaseL(RArray<TCategoryName>& aNewcategories,
                                      const TDesC& aCategoryTobeAdded);

        private:    // Data

        /// Reference to database
        CPosLandmarkDatabase& iDb;

        ///Ref: landmark parser
        CLmkParser& iParser;

        // Ref :Eikon Env
        CEikonEnv*      iEnv;
        //Ref
        MLmkAOOperationObserver* iObserver;

        //Owns
        CLmkAOOperation* iAOOperation;
    };

#endif      // CLMKSAVELANDMARKUTILS_H