--- /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 <coecntrl.h>
+
+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