/*

* Copyright (c) 2002 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:  Interface for locally variated features of Profiles.

*

*/

#ifndef __MPROFILESLOCALFEATURES_H__

#define __MPROFILESLOCALFEATURES_H__

// CLASS DECLARATION

/**

*  Profiles local feature variation interface.

*  MProfilesLocalFeatures offers simple interface to get locally variated

*  features of Profiles.

*  How to use:

*  Get local features object with MProfileEngineExtended::LocalFeaturesL().

*     MProfilesLocalFeatures& features = iProfileEngine->LocalFeatures();

*  Check whether a feature is supported (use the ID:s defined in

*  ProfilesVariant.hrh):

*     if( features.IsFeatureSupported( KFeatureIdSomeFeature ) )

*         {

*         // do stuff

*         }

*

*  @lib N/A

*  @since 2.6

*/

class MProfilesLocalFeatures

    {

    protected:  // Destructor

        virtual ~MProfilesLocalFeatures() {};

    public: // New functions

        /**

        * Checks if the given feature is supported or not.

        * @since 2.6

        * @return ETrue if the feature is supported, EFalse otherwise.

        */

        virtual TBool IsFeatureSupported( TInt aFeatureId ) const = 0;

        /**

         * Checks if the given MIME-type is explicitly blocked from using as

         * an alert tone.

         * @since 3.1

         * @param aMimeType the MIME-type to be checked.

         * @return ETrue if the MIME-type is blocked, EFalse otherwise.

         */

        virtual TBool IsBlockedType( const TDesC& aMimeType ) = 0;

        /**

         * Checks if the given MIME-type is explicitly blocked from using as

         * an alert tone if the alert tone file of the type is unprotected.

         * @since 3.1

         * @param aMimeType the MIME-type to be checked.

         * @return ETrue if the MIME-type is blocked if the alert tone file is

         *         unprotected, EFalse otherwise.

         */

        virtual TBool IsBlockedUnprotectedType( const TDesC& aMimeType ) = 0;

        /**

         * Checks if the given MIME-type is explicitly blocked from using as

         * an alert tone if the alert tone file of the type is protected.

         * @since 3.1

         * @param aMimeType the MIME-type to be checked.

         * @return ETrue if the MIME-type is blocked if the alert tone file is

         *         protected, EFalse otherwise.

         */

        virtual TBool IsBlockedProtectedType( const TDesC& aMimeType ) = 0;

        /**

         * Checks if the given MIME-type is explicitly blocked from demo

         * playing.

         * @since 3.1

         * @param aMimeType the MIME-type to be checked.

         * @return ETrue if the MIME-type is blocked from demo-playing,

         *         EFalse otherwise.

         */

        virtual TBool IsBlockedDemoPlayType( const TDesC& aMimeType ) = 0;

        /**

         * Checks if the given MIME-type is explicitly excluded from the tone

         * selection list. Also when tried to be set as alert tones through

         * other means, should behave as the tone would be in blocked type list.

         * @since 3.1

         * @param aMimeType the MIME-type to be checked.

         * @return ETrue if the MIME-type is excluded from the tone selection

         *         list, EFalse otherwise.

         */

        virtual TBool IsExcludedType( const TDesC& aMimeType ) = 0;

    };

#endif      //  __MPROFILESLOCALFEATURES_H__

// End of File