resourceinterfaces/fmtransmittercontrol/inc/HWRMFmTxFrequencyObserver.h
changeset 0 4e1aa6a622a0
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/resourceinterfaces/fmtransmittercontrol/inc/HWRMFmTxFrequencyObserver.h	Tue Feb 02 00:53:00 2010 +0200
@@ -0,0 +1,129 @@
+/*
+* Copyright (c) 2006-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:
+*
+*/
+
+
+
+#ifndef HWRMFMTXFREQUENCYOBSERVER_H
+#define HWRMFMTXFREQUENCYOBSERVER_H
+
+//  INCLUDES
+#include <e32base.h>
+#include <cenrepnotifyhandler.h>
+#include <centralrepository.h>
+
+// FORWARD DECLARATIONS
+class MHWRMFmTxObserver;
+
+// CLASS DECLARATION
+
+/**
+*  This class observes the FM Tx frequency
+*
+*/
+NONSHARABLE_CLASS(CHWRMFmTxFrequencyObserver): public CBase,
+                                   public MCenRepNotifyHandlerCallback
+    {
+    public: // Constructors and Destructor
+    
+        /**
+        * Two-phased constructor.
+        */
+        static CHWRMFmTxFrequencyObserver* NewL(MHWRMFmTxObserver* aCallback);
+        
+        /**
+        * Destructor.
+        */
+        virtual ~CHWRMFmTxFrequencyObserver();
+        
+    public: // New functions
+    
+        /**
+        * This method retrieves the current FM Tx state. 
+        *
+        * @return TInt indicating the current FM Tx frequency.
+        */
+        TInt Frequency() const;    
+    
+        /**
+        * This method retrieves the minimum FM Tx frequency
+        *
+        * @return TInt The lower boundary of the FM range (kHz)
+        */
+        TInt MinFrequency() const; 
+
+        /**
+        * This method retrieves the maximum FM Tx frequency
+        *
+        * @return TInt The upper boundary of the FM range (kHz)
+        */
+        TInt MaxFrequency() const; 
+
+        /**
+        * This method retrieves the FM Tx frequency step size
+        *
+        * @return TInt The step size (kHz) 
+        */
+        TInt StepSize() const; 
+        
+        /**
+        * This method queries whether the frequency range has been updated.
+        * Initially CenRep does not contain valid frequency range settings.
+        *
+        * @return TBool ETrue if frequency range has been updated.
+        */
+        TBool FrequencyRangeUpdated() const;
+
+    public: // Functions from base classes
+
+        // From MCenRepNotifyHandlerCallback
+        void HandleNotifyInt(TUint32 aId, TInt aNewValue);
+        void HandleNotifyError(TUint32 aId, TInt error, CCenRepNotifyHandler* aHandler);
+
+    private:
+    
+        /**
+        * C++ default constructor.
+        */
+        CHWRMFmTxFrequencyObserver();
+
+        /**
+        * By default Symbian 2nd phase constructor is private.
+        */
+        void ConstructL(MHWRMFmTxObserver*  aCallback);        
+
+    private:
+    
+        CRepository*          iRepository;          // Cenrep client
+
+        // Cenrep notifications
+        CCenRepNotifyHandler* iFreqNotify;
+        CCenRepNotifyHandler* iMinFreqNotify;       
+        CCenRepNotifyHandler* iMaxFreqNotify;
+        CCenRepNotifyHandler* iStepSizeNotify;
+        
+        MHWRMFmTxObserver*    iCallback;            // Callback object for passing FM Tx frequency changes. Not owned
+        TInt                  iFrequency;           // Current FM Tx frequency
+        
+        // FM frequency range
+        TInt iMinFrequency;
+        TInt iMaxFrequency;
+        TInt iStepSize;
+    };
+
+#endif  // HWRMFMTXFREQUENCYOBSERVER_H
+            
+// End of File