/*

* Copyright (c) 2007-2009 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:  Utility to access MRUI feature settings repository.

*

*/

#ifndef CESMRFEATURESETTINGS_H

#define CESMRFEATURESETTINGS_H

#include <e32base.h>

//#include "?include_file"

//class ?forward_classname;

/**

 *  CESMRFeatureSettings is utility to access MRUI Features repository.

 *  Usage:

 *

 *  @code

 *   // instantiate settings

 *   CESMRFeatureSettings* setting = CESMRFeatureSettings::NewL()

 *   // query feature

 *   TBool locationFeatures = setting->FeatureSupported( EESMRUILocationFeatures );

 *   if ( locationFeatures )

 *      {

 *      // Do something feature specific

 *      }

 *   // free resources

 *   delete settings;

 *  @endcode

 *

 *  @lib esmrcommon.lib

 */

NONSHARABLE_CLASS( CESMRFeatureSettings ) : public CBase

    {

public:

    /**  Feature setting flags. */

    enum TFeature

        {

        /** Map and Navigation Fw support */

        EESMRUIMnFwIntegration = 0x1,

        /** Contacts support */

        EESMRUIContactsIntegration = 0x2,

        /** Landmarks application support */

        EESMRUILandmarksIntegration = 0x4,

        /** Previous locations list */

        EESMRUIPreviousLocationsList = 0x8,

        /** Any of the previous location features */

        // Must be last member in enumeration

        EESMRUILocationFeatures               

        };

    IMPORT_C static CESMRFeatureSettings* NewL();

    IMPORT_C static CESMRFeatureSettings* NewLC();

    /**

    * Destructor.

    */

    virtual ~CESMRFeatureSettings();

    /**

     * Gets feature setting. The setting must be enumerated in

     * CESMRFeatureSettings::TFeature enumeration.

     * Multiple features can be queried at the same time by

     * bitwise-oring the corresponding feature flags.

     *

     * @param aFeatures the features.

     * @return ETrue if feature is enabled

     */

    IMPORT_C TBool FeatureSupported( TUint aFeatures ) const;

private:

    CESMRFeatureSettings();

    void ConstructL();

    TInt MapFeature( TUint aFeature ) const;

private: // data

    /**

     * Feature index array for mapping features

     */

    enum TFeatureIndex

        {

        EESMRUIMnFwIntegrationIndex = 0,

        EESMRUIContactsIntegrationIndex,

        EESMRUILandmarksIntegrationIndex,

        EESMRUIPreviousLocationsListIndex,

        // Last item. Number of features

        EESMRUINumLocationFeatures

        };

    /**

     * Feature status array

     */

    TInt iLocationFeatures[ EESMRUINumLocationFeatures ];

    };

#endif // CESMRFEATURESETTINGS_H