/*
* Copyright (c) 2006-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 observer and I/F class to observe Publish and Subscribe key changes.  
*
*/



#ifndef CPROPERTYOBSERVER_H
#define CPROPERTYOBSERVER_H

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

// CLASS DECLARATION

/**
 * MPropertyChangeHandler.
 * Abstract interface for handling property change events.
 **/

NONSHARABLE_CLASS( MPropertyChangeHandler )
{
 public:
    /**
     * This is a callback function which is called when a property is changed.
     *
     * @param aCategory  UID of the category.
     * @param aKey       changed key
     * @param aValue     the new value
     *
     * Note! references aKey and aValue are only valid while executing
     * HandlePropertyChange(). After that the data in which they refer can change.
     **/
    virtual void HandlePropertyChange(const TUid aCategory, const TUint aKey, const TInt aValue) = 0;

};

// INCLUDES

// CONSTANTS

// CLASS DECLARATION

/**
 * ?one_line_short_description.
 * ?other_description_lines
 *
 * @lib AknAlarmService
 * @since Series 60 2.8
 **/
NONSHARABLE_CLASS(CPropertyObserver) : public CActive
{
 public:  // Constructors and destructor
    /**
     * Two-phased constructor.
     * @since Series 60 2.8
     * @param ?arg1 ?description
     * @param ?arg2 ?description
     **/
    static CPropertyObserver* NewL(MPropertyChangeHandler& aHandler, TUid aCategory, TUint aKey);

    /**
     * Destructor.
     **/
    ~CPropertyObserver();

 private:
    /**
     * C++ default constructor overload.
     **/
    CPropertyObserver(MPropertyChangeHandler& aHandler, TUid aCategory, TUint aKey);

    /**
     * By default Symbian 2nd phase constructor is private.
     **/
    void ConstructL(void);

 protected:  // Functions from base classes
    /**
     * From CActive ?member_description
     **/
    void RunL(void);

    /**
     * From CActive ?member_description
     **/
    void DoCancel(void);

 private:  // New functions
     /**
      * ?member_description.
      * @since Series 60 2.8
      **/
     void Subscribe(void);

    /**
      * ?member_description.
      * @since Series 60 3.0
      **/
     void NotifyCurrentValue(void);

 private:  // Data
    // ?one_line_short_description_of_data
    RProperty iProperty;

    // ?one_line_short_description_of_data
    TUid iCategory;

    // ?one_line_short_description_of_data
    TUint iKey;

    // ?one_line_short_description_of_data
    MPropertyChangeHandler& iHandler;

};

#endif  // CPROPERTYOBSERVER_H


// End of File