phonesrv_plat/phone_settings_observer_api/inc/MPsetNetworkInfoObs.h
changeset 0 ff3b6d0fd310
child 19 7d48bed6ce0c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonesrv_plat/phone_settings_observer_api/inc/MPsetNetworkInfoObs.h	Tue Feb 02 01:11:09 2010 +0200
@@ -0,0 +1,122 @@
+/*
+* Copyright (c) 2002 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: 
+*      Observes completions of network info and change requests.
+*
+*
+*/
+
+
+#ifndef     MPSETNETWORKINFOOBS_H
+#define     MPSETNETWORKINFOOBS_H
+
+//  INCLUDES
+#include "MPsetNetworkSelect.h"
+#include <etelmm.h>
+
+//  DATA TYPES  
+typedef CArrayFixFlat<MPsetNetworkSelect::TNetworkInfo> CNetworkInfoArray;
+
+//  CLASS DEFINITIONS 
+/**
+*  MPsetNetworkInfoObserver class is virtual class for network information
+*  observers.
+*  @lib phonesettings.lib
+*  @since 1.0
+*/
+class   MPsetNetworkInfoObserver
+    {
+    public:            
+        /**
+        * Shows notes when network information received.
+        *
+        * @param aInfoArray Network information. Receiver owns the array.
+        * @param aResult Result of action.
+        */
+        virtual void HandleNetworkInfoReceivedL( 
+            const CNetworkInfoArray* aInfoArray, const TInt aResult ) = 0;
+        
+        /**
+        * Shows notes when requested for current network information.
+        *
+        * @param aCurrentInfo Current network information.
+        * @param aResult Result of action.
+        */
+        virtual void HandleCurrentNetworkInfoL( 
+            const MPsetNetworkSelect::TCurrentNetworkInfo& aCurrentInfo, 
+            const TInt aResult ) = 0;
+        
+        /**
+        *  DEPRECATED.
+        */
+        virtual void HandleNetworkChangedL( 
+            const MPsetNetworkSelect::TNetworkInfo& aCurrentInfo,
+            const MPsetNetworkSelect::TCurrentNetworkStatus aStatus, 
+            const TInt aResult ) = 0;    
+
+        /**
+        * Shows notes when network change has been approved.
+        *
+        * @param aCurrentInfo Current network information.
+        * @param aStatus Current network status.
+        * @param aResult Result of action.
+        */
+        virtual void HandleNetworkChangedL( 
+            const MPsetNetworkSelect::TNetworkInfo& aCurrentInfo,
+            const RMobilePhone::TMobilePhoneRegistrationStatus& aStatus, 
+            const TInt aResult ) = 0;    
+
+        //Service requests for MPsetNetworkInfoObserver
+        enum TServiceRequest {
+            EServiceRequestNone,
+            EServiceRequestEnumerateNetworks,
+            EServiceRequestGetNetworkInfo,
+            EServiceRequestGetCurrentNetworkInfo,
+            EServiceRequestGetNetworkSearchMode,
+            EServiceRequestSetNetwork,
+            EServiceRequestSetNetworkMode,
+            EServiceRequestSetNetworkAutomatic
+            };
+
+        /**
+        * Searches for networks that have coverage.
+        *
+        * @param aRequest Type of request that is being handled.
+        */
+        virtual void HandleSearchingNetworksL( TServiceRequest aRequest ) = 0;
+
+        /**
+        * Handles user request to register to specific network.
+        *
+        * @param aOngoing Is there an ongoing request.
+        */
+        virtual void HandleRequestingSelectedNetworkL( TBool aOngoing ) = 0;
+
+        /**
+        * Handles notes when call is active.
+        */
+        virtual void HandleCallActivatedL() = 0;
+
+        /**
+        * Handles errors.
+        * 
+        * @param aRequest current request.
+        * @param aError error code.
+        */
+        virtual void HandleNetworkErrorL( const MPsetNetworkInfoObserver::TServiceRequest aRequest,
+            const TInt aError ) = 0;
+    };
+
+#endif // MPSETNETWORKINFOOBS_H
+// end of file