/*

* Copyright (c) 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:  Active object for watching P&S changes

*

*/

#ifndef CSVPPROPERTYWATCH_H

#define CSVPPROPERTYWATCH_H

#include <e32base.h>

#include <e32property.h>

#include "svppropertywatchobserver.h"

#include "svputdefs.h"

 /**

 *  Attaches itself to the specified P&S property and notifies clients when 

 *  property was changed.

 *

 *

 *  @lib svp.dll

 *  @since S60 3.2

 */

class CSVPPropertyWatch : public CActive

    {

public:

    /**

    * Two-phased constructor.

    */

    static CSVPPropertyWatch* NewL( MSVPPropertyWatchObserver& aClient,

                                    const TUid& aCategory,

                                    TInt aKey );

    /**

    * Destructor.

    */

    virtual ~CSVPPropertyWatch();

protected:  // Functions from base classes 

    /**

    * From CActive. Handles an active object's request completion event.

    */

    void RunL();

    /**

    * From CActive. Implements cancellation of an outstanding request.

    */

    void DoCancel();

    /**

    * From CActive. Handles a leave occurring in the request completion

    * event handler RunL().

    */

    TInt RunError( TInt aError );

private:

    /**

    * C++ default constructor.

    */

    CSVPPropertyWatch( MSVPPropertyWatchObserver& aClient, TInt aKey );

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL( const TUid& aCategory );

private:  // Data

    /**

    * The client interested being notified about property changes

    */

    MSVPPropertyWatchObserver& iClient;

    /**

    * The key defining property where watcher attaches to

    */

    TInt iKey;

    /**

    * The property to attach to

    */

    RProperty iProperty;

private:

    // For testing

    SVP_UT_DEFS

    };

#endif //  C_SVPPROPERTYWATCH_H