phonesrv_plat/phone_settings_api/inc/psetnetworkwrapper.h
branchRCL_3
changeset 20 987c9837762f
parent 19 7d48bed6ce0c
child 21 0a6dd2dc9970
equal deleted inserted replaced
19:7d48bed6ce0c 20:987c9837762f
     1 /*
       
     2  * Copyright (c) 2009 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  *
       
    16  */
       
    17 
       
    18 #ifndef PSETNETWORKWRAPPER_H
       
    19 #define PSETNETWORKWRAPPER_H
       
    20 
       
    21 #include <QObject>
       
    22 
       
    23 class PSetNetworkWrapperPrivate;
       
    24 class CPsetContainer;
       
    25 class HbDialog;
       
    26 
       
    27 #ifdef BUILD_PSETWRAPPER
       
    28 #define PSETWRAPPER_EXPORT Q_DECL_EXPORT
       
    29 #else
       
    30 #define PSETWRAPPER_EXPORT Q_DECL_IMPORT
       
    31 #endif
       
    32 
       
    33 class PSETWRAPPER_EXPORT PSetNetworkWrapper : public QObject
       
    34 {
       
    35     Q_OBJECT
       
    36 
       
    37 public:
       
    38     
       
    39     enum ErrorCode {
       
    40         ErrNoError  = 0,
       
    41         ErrGeneral,
       
    42         ErrCauseCallActive,
       
    43         ErrNoNetworkService,
       
    44         ErrOfflineOpNotAllowed,
       
    45         ErrNoNetworkAccess
       
    46     };
       
    47     
       
    48     enum RequestType {
       
    49         RequestNone,
       
    50         RequestEnumerateNetworks,
       
    51         RequestGetNetworkInfo,
       
    52         RequestGetCurrentNetworkInfo,
       
    53         RequestGetNetworkSearchMode,
       
    54         RequestSetNetwork,
       
    55         RequestSetNetworkMode,
       
    56         RequestSetNetworkAutomatic
       
    57     };
       
    58     
       
    59     enum RegistrationStatus {
       
    60         RegisteredOnHomeNetwork,
       
    61         RegisteredRoaming
       
    62     };
       
    63     
       
    64     enum NetworkAccessMode {
       
    65         AccessModeDual,
       
    66         AccessModeUmts,
       
    67         AccessModeGsm
       
    68     };
       
    69     
       
    70     struct NetworkId{
       
    71         /*! Country code. Maximum length is 4. */
       
    72         QString m_countryCode;
       
    73         /*! Network code. Maximum length is 8. */
       
    74         QString m_networkCode;
       
    75     };
       
    76 
       
    77     enum NetworkSelectionMode {
       
    78         SelectionModeManual,
       
    79         SelectionModeAutomatic 
       
    80     };
       
    81 
       
    82     enum NetworkStatus {
       
    83         StatusUnknown,
       
    84         StatusAvailable,
       
    85         StatusCurrent,
       
    86         StatusForbidden
       
    87     };
       
    88     
       
    89     enum NetworkAccessType {
       
    90         AccessTypeGsm, 
       
    91         AccessTypeWcdma,
       
    92         AccessTypeGsmAndWcdma
       
    93     };
       
    94 
       
    95     struct NetworkInfo {
       
    96         NetworkId m_id;
       
    97         NetworkStatus m_status;
       
    98         NetworkSelectionMode m_mode;
       
    99         NetworkAccessType m_access;
       
   100         /*! Short name. Maximum length is 20. */
       
   101         QString m_shortName;
       
   102         /*! Long name. Maximum length is 30. */
       
   103         QString m_longName;
       
   104     };        
       
   105 
       
   106 public:
       
   107 
       
   108     explicit PSetNetworkWrapper(CPsetContainer &psetContainer,
       
   109         QObject *parent = NULL);
       
   110 
       
   111     virtual ~PSetNetworkWrapper();
       
   112 
       
   113 public:
       
   114     
       
   115     void getAvailableNetworks();
       
   116     
       
   117     ErrorCode getNetworkSelectionMode(
       
   118         PSetNetworkWrapper::NetworkSelectionMode& mode) const;
       
   119     
       
   120     void selectNetwork( 
       
   121         const PSetNetworkWrapper::NetworkInfo& info);
       
   122     
       
   123     void cancelRequest();
       
   124 
       
   125 public:
       
   126 
       
   127     void getNetworkAccessMode() const;
       
   128 
       
   129     void setNetworkAccessMode(PSetNetworkWrapper::NetworkAccessMode mode);
       
   130     
       
   131     bool isManualNetworkSelectionSupported() const;
       
   132 
       
   133 signals:
       
   134 
       
   135     // Real type of parameter mode is enum PSetNetworkWrapper::NetworkAccessMode.
       
   136     void networkAccessModeGot(int mode);
       
   137     
       
   138     void availableNetworksGot(QList<PSetNetworkWrapper::NetworkInfo*> &networkInfoList);
       
   139      
       
   140     void networkReqestFailed(
       
   141         PSetNetworkWrapper::ErrorCode error, 
       
   142         PSetNetworkWrapper::RequestType type);
       
   143     
       
   144     void searchingNetworks(PSetNetworkWrapper::RequestType &type);
       
   145     
       
   146     void requestingSelectedNetwork(bool ongoing);
       
   147     
       
   148     void networkChanged(
       
   149         PSetNetworkWrapper::NetworkInfo& currentInfo,
       
   150         PSetNetworkWrapper::RegistrationStatus& status);
       
   151 
       
   152     void chageVisbilityOfManualNetworkSelection(bool visible);
       
   153     
       
   154 private:
       
   155     
       
   156     PSetNetworkWrapper(const PSetNetworkWrapper &);
       
   157     PSetNetworkWrapper &operator=(const PSetNetworkWrapper &);
       
   158     PSetNetworkWrapperPrivate* m_privateImpl;
       
   159     friend class PSetNetworkWrapperPrivate;
       
   160 };
       
   161 
       
   162 #endif // PSETNETWORKWRAPPER_H