psln/PslnLibraryLoaders/inc/pslnprofilesettingsloader.h
author hgs
Fri, 25 Jun 2010 18:53:58 +0800
changeset 34 6b5204869ed5
parent 0 2f259fa3e83a
permissions -rw-r--r--
201025_1

/*
* Copyright (c) 2006-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:  Loads ProfileSettingsView.dll dynamically.
*
*/


#ifndef C_PSLNPROFILESETTINGSLOADER
#define C_PSLNPROFILESETTINGSLOADER

#include <e32base.h>

class MProfileEngineExtended;
class MProfileExtended;
class CDRMHelper;
/**
*  Interface class for profile settings view.
*  
*  @lib PslnProfileSettingsLoader.lib
*  @since Series 60 3.1
*/
class MPslnProfileSettingsLoader
    {
    public:

        /**
        * Pure virtual method for setting ringing tone for all profiles.
        * @param aType type of tone (actual ringing tone, or message alert tone).
        * @param aFullName full filename (inc. path) of tone.
        */
        virtual void SetToneForProfilesL( TInt aType, TDes& aFullName ) = 0;

        /**
        * Pure virtual method for indicating to the media gallery that 
        * there is new sound file available in the gallery.
        * @param aFullPath path and file of the new sound file..
        */
        virtual void IndicateFileUpdationL( const TDesC& aFullPath ) = 0;
    };

/**
*  This class is for dynamically loading ProfilesSettingsView.dll that 
*  enables setting of ringing tone for all profiles.
*
*  @lib PslnProfileSettingsLoader.lib
*  @since Series 60 3.1
*/
class CPslnProfileSettingsLoader : public CBase, 
                                   public MPslnProfileSettingsLoader
    {
public:
    /**
    * Two-phased constructor.
    * @return new instance of CPslnProfileSettingsLoader.
    */
    static CPslnProfileSettingsLoader* NewL();

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

    /**
    * Sets tone for all profiles.
    * @param aType type of tone (actual ringing tone, or message alert tone).
    * @param aFullName full filename (inc. path) of tone.
    */
    void SetToneForProfilesL( TInt aType, TDes& aFullName );

    /**
    * Indicates to the media gallery that there is new sound file 
    * available in the gallery.
    * @param aFullPath path and file of the new sound file.
    */
    void IndicateFileUpdationL( const TDesC& aFullPath );

private:

    /**
    * C++ default constructor.
    */
    CPslnProfileSettingsLoader();
    
    /**
    * Stores the settings to Profiles Engine and adds the file to automated
    * content list and removes the old file from automated content list.
    * @param aProfileEngine The MProfileEngineExtended.
    * @param aProfileId The ID of the profile (NOT an index).
    * @param aType Identifies the tone which is updated.
    * @param aFileName Full path and filename of the tone to be used
    *                  as the new ringing or alert tone.
    */    
    void DoSetProfileToneL( MProfileEngineExtended* aProfileEngine, TInt aProfileId, 
    		TInt aType, const TDesC& aFileName );
    
    /**
    * Sets the tone to an MProfileExtended instance.
    * @param aProfile The MProfileExtended instance.
    * @param aType Identifies the tone which is updated.
    * @param aFileName The tone file name.
    */
    void SetToneL( MProfileExtended& aProfile,
    		TInt aType, const TDesC& aFileName );
    
    /**
    * Reads a tone setting from an MProfileExtended instance.
    * @param aProfile The MProfileExtended instance.
    * @param aType Identifies the tone which is read.
    * @return Returns the tone file name.
    */
    const TDesC& ToneL( MProfileExtended& aProfile,TInt aType );
    
    /**
    * Set Automated content
    * @param aDrmHelper Pointer to Drm helper.
    * @param aType Identifies the type the content.
    * @param aFileName Filename for the content.
    * @return Returns success/fail.
    */
    TInt SetAutomated( CDRMHelper* aDrmHelper,TInt aType,
    		const TDesC& aFileName );
    /**
    * Remove Automated content
    * @param aDrmHelper Pointer to Drm helper.
    * @param aFileName Filename for the content.
    */
    void RemoveAutomated( CDRMHelper* aDrmHelper,const TDesC& aFileName );

    
private:

#ifdef RD_CONTENTNOTIFICATION
    /**
    * Array of notification events.
    * Own.
    */
    CArrayFixFlat<CContentNotificationEvent*>* iEventArray;
#endif // RD_CONTENTNOTIFICATION
    };

// Environment gate function
IMPORT_C TAny* GateFunction();

#endif // C_PSLNPROFILESETTINGSLOADER

// End of File