diff -r 000000000000 -r 2f259fa3e83a classicui_plat/signal_pane_api/inc/aknsignal.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/classicui_plat/signal_pane_api/inc/aknsignal.h Tue Feb 02 01:00:49 2010 +0200 @@ -0,0 +1,251 @@ +/* +* Copyright (c) 2002-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: Control to show signal strength indicator on the +* status pane's signal pane. +* +*/ + + +#ifndef AKNSIGNAL_H +#define AKNSIGNAL_H + +#include + +class CEikImage; +class CAknSignalPaneExtension; +class CAknSignalIcon; +class CAknSignalStrength; +class CAknSignalDataObserver; + +/** +* A default control in the status pane's signal pane +* The control draws signal strength indicator graphics. +*/ + +class CAknSignalPane : public CCoeControl + { +public: + /** + * Standard constructor + */ + IMPORT_C CAknSignalPane(); + + /** + * Destructor + */ + IMPORT_C ~CAknSignalPane(); + + /** + * Resource constructor. + * @param aReader Resource reader. + */ + IMPORT_C void ConstructFromResourceL(TResourceReader& aReader); + + /** + * Sets signal strength value to the signal indicator. + * @param aLevel Signal strength value ( 0 - 7 ). + */ + IMPORT_C void SetSignalLevel(TInt aLevel); + + /** + * Gets signal strength value from the signal indicator. + * @return Signal strength value ( 0 - 7 ). + */ + TInt SignalLevel(); + + /** + * Gets signal state value from the signal indicator. + * @return Signal state value. + */ + TInt SignalState(); + + /** + * Disables possible icon animation. + */ + void DisableAnimation(); + + /** + * Set GPRS state. Available GRRS state are: + * EAknSignalGprsIndicatorOff, EAknSignalGprsIndicatorAvailable, + * EAknSignalGprsIndicatorContext, EAknSignalGprsIndicatorSuspended, + * EAknSignalGprsIndicatorMultipdp. + * + * @param aGprsIconState GPRS state. + */ + IMPORT_C void ShowGprsIcon(TInt aGprsIconState); + + /** + * Set common packet data state. Available states are: + * EAknSignalCommonPacketDataIndicatorOff, + * EAknSignalCommonPacketDataIndicatorAvailable, + * EAknSignalCommonPacketDataIndicatorContext, + * EAknSignalCommonPacketDataIndicatorSuspended, + * EAknSignalCommonPacketDataIndicatorMultipdp. + * + * @param aCommonPacketDataIconState Common packet data state. + * @since 2.6 + */ + IMPORT_C void ShowCommonPacketDataIcon(TInt aCommonPacketDataIconState); + + /** + * Set WCDMA state. Available WCDMA states are: + * EAknSignalWcdmaIndicatorOff, + * EAknSignalWcdmaIndicatorAvailable, + * EAknSignalWcdmaIndicatorAttached, + * EAknSignalWcdmaIndicatorEstablishingContext, + * EAknSignalWcdmaIndicatorContext, + * EAknSignalWcdmaIndicatorMultipdp + * + * @param aWcdmaIconState WCDMA state. + * @since 2.6 + */ + IMPORT_C void ShowWcdmaIcon(TInt aWcdmaIconState); + + /** + * Set HSDPA state. Available HSDPA states are: + * EAknSignalHsdpaIndicatorOff, + * EAknSignalHsdpaIndicatorAvailable, + * EAknSignalHsdpaIndicatorAttached, + * EAknSignalHsdpaIndicatorEstablishingContext, + * EAknSignalHsdpaIndicatorContext, + * EAknSignalHsdpaIndicatorMultipdp + * + * @param aHsdpaIconState HSDPA state. + * @since 3.1 + */ + IMPORT_C void ShowHsdpaIcon(TInt aHsdpaIconState); + + /** + * Set CDMA state. Available CDMA states are: + * EAknSignalCdmaIndicatorOff, + * EAknSignalCdmaIndicatorNoService, + * EAknSignalCdmaIndicatorAvailable, + * EAknSignalCdmaIndicatorNotAvailable, + * EAknSignalCdmaIndicatorActive, + * EAknSignalCdmaIndicatorDormant, + * EAknSignalCdmaIndicatorSending, + * EAknSignalCdmaIndicatorReceiving + * + * @param aCdmaIconState CDMA state. + * @since 2.7 + */ + IMPORT_C void ShowCdmaIcon(TInt aCdmaIconState); + + /** + * Set EDGE (egprs) state. Available EDGE states are: + * EAknSignalEdgeIndicatorOff, + * EAknSignalEdgeIndicatorAvailable, + * EAknSignalEdgeIndicatorAttached, + * EAknSignalEdgeIndicatorEstablishingContext, + * EAknSignalEdgeIndicatorContext, + * EAknSignalEdgeIndicatorMultipdp + * + * @param aEdgeIconState EDGE state. + * @since 3.0 + */ + IMPORT_C void ShowEdgeIcon(TInt aEdgeIconState); + + + /** + * @deprecated + * + * Set the background type. This method is used by the UI framework for + * for syncronizing this components background type with navipane + * background type. + * + * Available backgroud types are: + * EAknNaviPaneBackgroundTypeNotDefined + * EAknNaviPaneBackgroundTypeWipe + * EAknNaviPaneBackgroundTypeSolid + * + * @param aType Background type. + * @since 2.1 + */ + IMPORT_C void SetNaviPaneBackgroundType(TInt aType); + +public: + /** + * From CCoeControl. Handles pointer event + * @param aPointerEvent Pointer event to be handled + */ + void HandlePointerEventL( const TPointerEvent& aPointerEvent ); + +private: + /** + * From CAknControl + */ + IMPORT_C void* ExtensionInterface( TUid aInterface ); + +protected: // From CCoeControl + + /** + * From CCoeControl. Handle the size change events. + */ + IMPORT_C void SizeChanged(); + + /** + * From CCoeControl. Handles the position change events. + */ + IMPORT_C void PositionChanged(); + + /** + * Handles a change to the control's resources of type aType + * which are shared across the environment. + * @param aType Event type. + */ + IMPORT_C void HandleResourceChange( TInt aType ); + + /** + * From CCoeControl. Returns number of controls inside the context pane control. + * @return Number of component controls. + */ + IMPORT_C TInt CountComponentControls() const; + + /** + * From CCoeControl. Returns a control determined by control id. + * @param anIndex Index of a control to be returned. + * @return Pointer to control + */ + IMPORT_C CCoeControl* ComponentControl(TInt aIndex) const; + +private: + IMPORT_C void ConstructL(); + +private: // From CCoeControl + IMPORT_C virtual void Draw(const TRect& aRect) const; + +private: + static TInt TickerCallback(TAny* aThis); + TInt DoTick(); + void DrawInNormalStatusPane(const TRect& aRect) const; + void DrawInSmallStatusPane(const TRect& aRect) const; + void DrawInFlatStatusPane(const TRect& aRect) const; + void DrawInStaconPane(const TRect& aRect) const; + CFbsBitmap* SignalIconBitmap() const; + CFbsBitmap* SignalIconBitmapMask() const; + void SetContainerWindowNonFading(TBool aNonFading); + void LoadSignalIconL(TInt aIconState, TInt aColorIndex); + +private: + // Private flags for internal statemachines, iSpare taken into use + TInt iPrivateFlags; + CAknSignalIcon* iSignalIconControl; + CAknSignalStrength* iSignalStrengthControl; + CPeriodic* iTicker; + CAknSignalDataObserver* iDataObserver; + TInt iSignalState; + CAknSignalPaneExtension* iExtension; + }; + +#endif // AKNSIGNAL_H