/*
* Copyright (c) 2002-2006 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:  An active object class that is used to receive
*  phone call related events from PS API and forward them
*  to an MVRSystemEventObserver instance.
*
*
*/



#ifndef __CVRSYSTEMEVENTHANDLER_H
#define __CVRSYSTEMEVENTHANDLER_H

// INCLUDES
#include <e32base.h>
#include <e32property.h>

// FORWARD DECLARATIONS
class MVRSystemEventObserver;

// CLASS DECLARATION

/**
*  An active object class that is used to receive
*  phone call related events from RSystemAgent and forward them
*  to an MVRSystemEventObserver instance.
*/
NONSHARABLE_CLASS( CVRSystemEventHandler ): public CActive
    {
    public:  // Constructors and destructor

        /**
        * Two-phased constructor.
		* @return A pointer to fully constructed instance of CVRSystemEventHandler
        */
        static CVRSystemEventHandler* NewL();

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

    public: // New functions
		/**
		* Get the current state of any pubsub key
		* @param aUid The UID of the PS category
		* @param aKey The id identifying the PS key
		* @return The value of the state variable
		*/
		TInt StateL( TUid aUid, TUint aKey );

		/**
		* Start listening to system events
		* @param aUid The UID identifying the system agent's state variable
		* @param aObserver The observer who will be notified of events
		*/
		void Listen( TUid aUid, TUint aKey, MVRSystemEventObserver* aObserver );

    public: // from CActive

		/**
		* When this method is called, an event has been received.
		* Notify the observer.
		*/
        void RunL();

		/**
		* Cancel the request for event notifications.
		*/
		void DoCancel();

    private:

		/**
		* Ask system agent to notify us about events
		*/
		void IssueRequest();

        /**
        * Default constructor.
        */
        CVRSystemEventHandler();

        /**
        * 2nd phase constructor.
        */
        void ConstructL();

    private:    // Data

		/**
		* For observing the system events
		*/
		RProperty iProperty;

        /**
        * Pointer to the observer. Not owned.
        */
		MVRSystemEventObserver* iObserver;
    };

#endif      // __CVRSYSTEMEVENTHANDLER_H

// End of File