1 /*

     2 * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: 

    15 *      Observes completions of network info and change requests.

    16 *

    17 *

    18 */

    19 

    20 

    21 #ifndef     MPSETNETWORKINFOOBS_H

    22 #define     MPSETNETWORKINFOOBS_H

    23 

    24 //  INCLUDES

    25 #include "MPsetNetworkSelect.h"

    26 #include <etelmm.h>

    27 

    28 //  DATA TYPES  

    29 typedef CArrayFixFlat<MPsetNetworkSelect::TNetworkInfo> CNetworkInfoArray;

    30 

    31 //  CLASS DEFINITIONS 

    32 /**

    33 *  MPsetNetworkInfoObserver class is virtual class for network information

    34 *  observers.

    35 *  @lib phonesettings.lib

    36 *  @since 1.0

    37 */

    38 class   MPsetNetworkInfoObserver

    39     {

    40     public:            

    41         /**

    42         * Shows notes when network information received.

    43         *

    44         * @param aInfoArray Network information. Receiver owns the array.

    45         * @param aResult Result of action.

    46         */

    47         virtual void HandleNetworkInfoReceivedL( 

    48             const CNetworkInfoArray* aInfoArray, const TInt aResult ) = 0;

    49         

    50         /**

    51         * Shows notes when requested for current network information.

    52         *

    53         * @param aCurrentInfo Current network information.

    54         * @param aResult Result of action.

    55         */

    56         virtual void HandleCurrentNetworkInfoL( 

    57             const MPsetNetworkSelect::TCurrentNetworkInfo& aCurrentInfo, 

    58             const TInt aResult ) = 0;

    59         

    60         /**

    61         *  DEPRECATED.

    62         */

    63         virtual void HandleNetworkChangedL( 

    64             const MPsetNetworkSelect::TNetworkInfo& aCurrentInfo,

    65             const MPsetNetworkSelect::TCurrentNetworkStatus aStatus, 

    66             const TInt aResult ) = 0;    

    67 

    68         /**

    69         * Shows notes when network change has been approved.

    70         *

    71         * @param aCurrentInfo Current network information.

    72         * @param aStatus Current network status.

    73         * @param aResult Result of action.

    74         */

    75         virtual void HandleNetworkChangedL( 

    76             const MPsetNetworkSelect::TNetworkInfo& aCurrentInfo,

    77             const RMobilePhone::TMobilePhoneRegistrationStatus& aStatus, 

    78             const TInt aResult ) = 0;    

    79 

    80         //Service requests for MPsetNetworkInfoObserver

    81         enum TServiceRequest {

    82             EServiceRequestNone,

    83             EServiceRequestEnumerateNetworks,

    84             EServiceRequestGetNetworkInfo,

    85             EServiceRequestGetCurrentNetworkInfo,

    86             EServiceRequestGetNetworkSearchMode,

    87             EServiceRequestSetNetwork,

    88             EServiceRequestSetNetworkMode,

    89             EServiceRequestSetNetworkAutomatic

    90             };

    91 

    92         /**

    93         * Searches for networks that have coverage.

    94         *

    95         * @param aRequest Type of request that is being handled.

    96         */

    97         virtual void HandleSearchingNetworksL( TServiceRequest aRequest ) = 0;

    98 

    99         /**

   100         * Handles user request to register to specific network.

   101         *

   102         * @param aOngoing Is there an ongoing request.

   103         */

   104         virtual void HandleRequestingSelectedNetworkL( TBool aOngoing ) = 0;

   105 

   106         /**

   107         * Handles notes when call is active.

   108         */

   109         virtual void HandleCallActivatedL() = 0;

   110 

   111         /**

   112         * Handles errors.

   113         * 

   114         * @param aRequest current request.

   115         * @param aError error code.

   116         */

   117         virtual void HandleNetworkErrorL( const MPsetNetworkInfoObserver::TServiceRequest aRequest,

   118             const TInt aError ) = 0;

   119     };

   120 

   121 #endif // MPSETNETWORKINFOOBS_H

   122 // end of file