diff -r ebe688cedc25 -r 7fdbb852d323 messagingappbase/ncnlist/inc/MNcnSignalStrengthHandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/messagingappbase/ncnlist/inc/MNcnSignalStrengthHandler.h Wed Sep 01 12:31:54 2010 +0100 @@ -0,0 +1,94 @@ +/* +* Copyright (c) 2004 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: Interface for signal strength handler. +* +*/ + + + +#ifndef MNCNSIGNALSTRENGTHHANDLER_H +#define MNCNSIGNALSTRENGTHHANDLER_H + +// INCLUDES +#include + +// FORWARD DECLARATIONS +class MNcnSignalStrengthObserver; + +// CLASS DECLARATION + +/** +* Interface for a class which handles changes +* in phone signal strength. +*/ +class MNcnSignalStrengthHandler + { + public: // Constructors and destructor + + /** + * Destructor. + */ + virtual ~MNcnSignalStrengthHandler() {}; + + public: // New functions + + /** + * Returns ETrue if signal observing is supported, EFalse otherwise. + * @return ETrue if signal observing is supported, EFalse otherwise. + */ + virtual TBool ObservingSupported() = 0; + + /** + * Returns ETrue if signal strength requests are supported, EFalse otherwise. + * @return ETrue if signal strength requests are supported, EFalse otherwise. + */ + virtual TBool RequestsSupported() = 0; + + /** + * Sets the signal strength observer. May leave with KErrNotSupported + * if signal strength observing is not supported. + * @param aObserver Observer for signal strength. Ownership is not passed. + */ + virtual void SetSignalStrengthObserverL( MNcnSignalStrengthObserver* aObserver ) = 0; + + /** + * Starts observing the signal strength. May leave with KErrNotSupported + * if signal strength observing is not supported. + */ + virtual void StartObservingL() = 0; + + /** + * Stops the signal strength observing. + */ + virtual void StopObservingL() = 0; + + /** + * Returns the current signal strength. May leave with KErrNotSupported + * if signal strength requests are not supported. + * @return The current signal strength. + */ + virtual TInt SignalStrengthL() = 0; + + /** + * Returns the current bar value. May leave with KErrNotSupported + * if bar value requests are not supported. + * @return The current signal strength. + */ + virtual TInt BarValueL() = 0; + + }; + +#endif // MNCNSIGNALSTRENGTHHANDLER_H + +// End of File