// Copyright (c) 2007-2009 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:

 // Declares the internal observer classes used by CDvbhReceiverInfo.

 // 

 //

 /**

  @file

  @internalComponent

  @prototype

 */

 #ifndef DVBHRECEIVERINFOOBSERVER_H

 #define DVBHRECEIVERINFOOBSERVER_H

 #include "dvbhstubcommon.h"

 #include <e32property.h>

 #include <e32cons.h>

 class MDvbhStateObserver;

 class MDvbhSignalQualityObserver;

 class MDvbhPlatformObserver;

 class MDvbhNetworkTimeObserver;

 class MDvbhFrequencyObserver;

 class MDvbhCellIdObserver;

 class MDvbhNetworkIdObserver;

 class MDvbhExtBatteryStateObserver;

 class MDvbhExtConnectionObserver;

 class MDvbhExtAntennaConnectionObserver;

 /**

 * Interface to abstract the callback to be called when an RProperty changes. 

 */

 class MPropertyNotifier

 	{

 public:

 	/**

 	* Callback to be called when an RProperty changes.

 	* Implementations will probably want to call the appropriate callback on an external observer object.

 	* @param aProperty A handle to the RProperty that has just changed.

 	*/

 	virtual void NotifyPropertyChanged(RProperty& aProperty) = 0;

 	/**

 	* Called to get the key of the property of interest.

 	* @return the key value.

 	*/

 	virtual TInt GetPropertyKey() const = 0;

 	};

 /**

 * CDvbhPropertyObserver is the class used to observer changes to an RProperty.

 *

 * To observer changes to a particular RProperty, users must call 

 * CDvbhPropertyObserver::SetObserver() passing in an MPropertyNotifier 

 * implementation corresponding to the RProperty of interest.  

 * When the RProperty changes, CDvbhPropertyObserver::RunL() will call 

 * MPropertyNotifier::NotifyPropertyChanged() of the implementation. 

 */

 NONSHARABLE_CLASS(CDvbhPropertyObserver) : public CActive

 	{

 public:

 	CDvbhPropertyObserver();

 	~CDvbhPropertyObserver();

 	TInt SetObserver(MPropertyNotifier* aPropertyNotifier);

 private: 

 	void RunL();

 	void DoCancel();

 private:

 	MPropertyNotifier* iPropertyNotifier; //Not owned

 	RProperty iProperty;

 	};

 /**

 * Thin template base class for the RProperty notifiers.

 */

 NONSHARABLE_CLASS(TDvbhNotifierBase)

 	{

 protected:

 	TDvbhNotifierBase();

 	void SetExternalObserver(TAny* aObserver);

 protected:

 	TAny* iExternalObserver; //Not owned

 	};

 /**

 * Template on which RProperty Notifiers are based.  Contains all the

 * code common to a Notifier for any RProperty.

 *

 * The template parameter OBSERVER must be one of the observer M-classes declard in dvbhreceiverinfo.h.

 */

 template<class OBSERVER>

 NONSHARABLE_CLASS(TDvbhNotifier) : protected TDvbhNotifierBase

 	{

 public:

 	inline void SetExternalObserver(OBSERVER* aObserver);

 	};

 /**

 * The state notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhStateNotifier) : public TDvbhNotifier<MDvbhStateObserver>,

 										public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The SignalQuality notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhSignalQualityNotifier) : public TDvbhNotifier<MDvbhSignalQualityObserver>,

 												public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The Platform notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhPlatformNotifier) : public TDvbhNotifier<MDvbhPlatformObserver>,

 										   public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The NetworkTime notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhNetworkTimeNotifier) : public TDvbhNotifier<MDvbhNetworkTimeObserver>,

 											  public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The Frequency notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhFrequencyNotifier) : public TDvbhNotifier<MDvbhFrequencyObserver>,

 											public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The CellId notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhCellIdNotifier) : public TDvbhNotifier<MDvbhCellIdObserver>,

 										 public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The NetworkId notifier for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhNetworkIdNotifier) : public TDvbhNotifier<MDvbhNetworkIdObserver>,

 											public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The battery state for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhExtBatteryStateNotifier) : public TDvbhNotifier<MDvbhExtBatteryStateObserver>,

 											     public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The connection state for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TDvbhExtConnectionStateNotifier) : public TDvbhNotifier<MDvbhExtConnectionObserver>,

 											         public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The connection state for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TMtvAccConnectionStateNotifier) : public TDvbhNotifier<MDvbhExtConnectionObserver>,

 											        public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 /**

 * The antenna connection state for CDvbhReceiverInfo::CPrivateData. 

 */	

 NONSHARABLE_CLASS(TMtvAccAntennaConnectionStateNotifier) : public TDvbhNotifier<MDvbhExtAntennaConnectionObserver>,

 											               public MPropertyNotifier

 	{

 public:

 	virtual TInt GetPropertyKey() const;

 	virtual void NotifyPropertyChanged(RProperty& aProperty);

 	};

 #include "dvbhreceiverinfoobserver.inl"

 #endif //DVBHRECEIVERINFOOBSERVER_H