/*

* 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:  Profile change notify handler.

*

*/

#ifndef __CPROFILECHANGENOTIFYHANDLER_H__

#define __CPROFILECHANGENOTIFYHANDLER_H__

//  INCLUDES

#include <e32base.h>

#include <e32property.h>

// FORWARD DECLARATIONS

class CRepository;

class MProfileChangeObserver;

// CLASS DECLARATION

/**

*  Profile change notify handler.

*  How to use:

*  class CMyClass : public CBase, public MProfileChangeObserver

*      {

*      ...

*      virtual void HandleActiveProfileEventL(

*              TProfileEvent aProfileEvent, TInt aProfileId );

*      ...

*      private:    // data

*          CProfileChangeNotifyHandler* iHandler;

*

*      }

*  void CMyClass::ConstructL()

*      {

*      iHandler = CProfileChangeNotifyHandler::NewL( this );

*      }

*

*  void CMyClass::HandleActiveProfileEventL(

*              TProfileEvent aProfileEvent,

*              TInt aProfileId )

*      {

*      // handle event

*      }

*

*  @lib ProfileEng.lib

*  @since 2.0

*/

NONSHARABLE_CLASS(CProfileChangeNotifyHandler) : public CBase

    {

    private: // class definitions

        NONSHARABLE_CLASS(CProfilePSObserver) : public CActive

            {

            public:  // constructor and destructor

                CProfilePSObserver( TUint32 aPSKey );

                ~CProfilePSObserver(); 

            public: // New functions:

                /**

                 * Requests notifications from P&S of KProEngActiveProfile-

                 * Modified value changes.

                 */

                void RequestNotificationL();

            private: // Functions from base classes

                /**

                 * From CActive.

                 */

                void RunL();

                void DoCancel();

            public: // Data:

                // The P&S key to observe

                TUint32 iPSKey;

                // Ref:

                CRepository* iCenRep;

                // Own:

                RProperty iProperty;

                // Ref: Active profile change observer

                MProfileChangeObserver* iProfileChangeObserver;

                TBool iAttached;

            };

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * @param aProfileChangeObserver Profile change observer.

        */

        IMPORT_C static CProfileChangeNotifyHandler* NewL(

            MProfileChangeObserver* aProfileChangeObserver );

        /**

        * Destructor.

        */

        virtual ~CProfileChangeNotifyHandler();

    private:

        /**

        * C++ default constructor.

        * @param aProfileChangeObserver Profile change observer.

        */

        CProfileChangeNotifyHandler(

            MProfileChangeObserver* aProfileChangeObserver );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    private:    // Data

        // Ref: Active profile change observer

        MProfileChangeObserver* iProfileChangeObserver;

        // Own:

        CProfilePSObserver* iActiveProfileObserver;

        // Own:

        CProfilePSObserver* iPSObserver;

        // Own:

        CRepository* iRepository;

    };

#endif      //  __CPROFILECHANGENOTIFYHANDLER_H__

// End of File