epoc32/include/mw/apselect.h
branchSymbian2
changeset 2 2fe1408b6811
parent 1 666f914201fb
child 4 837f303aceeb
     1.1 --- a/epoc32/include/mw/apselect.h	Tue Nov 24 13:55:44 2009 +0000
     1.2 +++ b/epoc32/include/mw/apselect.h	Tue Mar 16 16:12:26 2010 +0000
     1.3 @@ -1,1 +1,745 @@
     1.4 -apselect.h
     1.5 +/*
     1.6 +* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 
     1.7 +* All rights reserved.
     1.8 +* This component and the accompanying materials are made available
     1.9 +* under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
    1.10 +* which accompanies this distribution, and is available
    1.11 +* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
    1.12 +*
    1.13 +* Initial Contributors:
    1.14 +* Nokia Corporation - initial contribution.
    1.15 +*
    1.16 +* Contributors:
    1.17 +*
    1.18 +* Description:  Declaration of the CApSelect class.
    1.19 +*
    1.20 +*/
    1.21 +
    1.22 +
    1.23 +#ifndef CAPSELECT_H
    1.24 +#define CAPSELECT_H
    1.25 +
    1.26 +// Deprecation warning
    1.27 +#warning This header file has been deprecated. Will be removed in one of the next SDK releases.
    1.28 + 
    1.29 + 
    1.30 +//  INCLUDES
    1.31 +#include <commdb.h>
    1.32 +#include <ApEngineVer.h>
    1.33 +#include <ApEngineConsts.h>
    1.34 +
    1.35 +
    1.36 +// FORWARD DECLARATIONS
    1.37 +class CApListItem;
    1.38 +class CApListItemList;
    1.39 +class CApUtils;
    1.40 +
    1.41 +
    1.42 +
    1.43 +enum TVpnFilterType
    1.44 +    {
    1.45 +    EVpnFilterVpnOnly,          ///< Shows only VPN access points
    1.46 +    EVpnFilterNoVpn,            ///< Shows only non-VPN access points
    1.47 +    EVpnFilterBoth              ///< Shows both normal and VPN access points
    1.48 +    };
    1.49 +
    1.50 +
    1.51 +// CLASS DECLARATION
    1.52 +// Extra data holder
    1.53 +typedef struct
    1.54 +    {
    1.55 +        TInt                iMaxIndex;
    1.56 +        TInt                iReqIpvType;
    1.57 +        TInt                iIsIpv6Supported;
    1.58 +        TInt                iExtra;
    1.59 +        TBool               iIsFeatureManagerInitialised;
    1.60 +        TBool               iCdma;
    1.61 +        TInt                iVpnFilterType; // TVpnFilterType values !!
    1.62 +        TBool               iWlanSupported;
    1.63 +        TBool               iIncludeEasyWlan;
    1.64 +    }TSelectExtra;
    1.65 +
    1.66 +
    1.67 +
    1.68 +typedef struct
    1.69 +    {
    1.70 +    TUint32     iVpnIapId;
    1.71 +    TUint32     iHomeIapId;
    1.72 +    HBufC *     iName;
    1.73 +    }TVpnData;
    1.74 +
    1.75 +
    1.76 +/**
    1.77 +*  This class is used to help client's access point selection.
    1.78 +*  Selection can be tailored with specific filters, rules and sort order.
    1.79 +*  Provides methods for setting and getting filters and sort order.
    1.80 +*
    1.81 +*/
    1.82 +class CApSelect :public CBase
    1.83 +    {
    1.84 +    public:  // Constructors and destructor
    1.85 +
    1.86 +        /**
    1.87 +        * Two-phased constructor. Leaves on failure, places instance
    1.88 +        * on cleanup stack.
    1.89 +        * @param aDb a pointer to a CCommsDataBase.
    1.90 +        * @param aIspTypeFilter Filtering criteria on ISP type
    1.91 +        * Possible values are:
    1.92 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
    1.93 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
    1.94 +        * KEApIspTypeAll and their combinations.
    1.95 +        * @param aBearerFilter Filtering criteria on bearer type
    1.96 +        * Possible values are the TApBearer enums and
    1.97 +        * their combinations (or-ed).
    1.98 +        * @param aSortType Specifies the sort order to use.
    1.99 +        * Possible values are:
   1.100 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.101 +        * KEApSortNameAscending, KEApSortNameDescending
   1.102 +        * @return The constructed CApSelect.
   1.103 +        *
   1.104 +        * @deprecated
   1.105 +        */
   1.106 +        IMPORT_C static CApSelect* NewLC(
   1.107 +                                        CCommsDatabase& aDb,
   1.108 +                                        TInt aIspFilter,
   1.109 +                                        TInt aBearerFilter,
   1.110 +                                        TInt aSortType
   1.111 +                                        );
   1.112 +
   1.113 +
   1.114 +        /**
   1.115 +        * Two-phased constructor. Leaves on failure, places instance
   1.116 +        * on cleanup stack.
   1.117 +        * @param aDb a pointer to a CCommsDataBase.
   1.118 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.119 +        * Possible values are:
   1.120 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.121 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.122 +        * KEApIspTypeAll and their combinations.
   1.123 +        * @param aBearerFilter Filtering criteria on bearer type
   1.124 +        * Possible values are the TApBearer enums and
   1.125 +        * their combinations (or-ed).
   1.126 +        * @param aSortType Specifies the sort order to use.
   1.127 +        * Possible values are:
   1.128 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.129 +        * KEApSortNameAscending, KEApSortNameDescending
   1.130 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.131 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.132 +        * in case of CSD, all CSD access points are 
   1.133 +        * considered to be IPv4 & IPv6 (both)
   1.134 +        * @return The constructed CApSelect.
   1.135 +        *
   1.136 +        * @deprecated
   1.137 +        */
   1.138 +        IMPORT_C static CApSelect* NewLC(
   1.139 +                                        CCommsDatabase& aDb,
   1.140 +                                        TInt aIspFilter,
   1.141 +                                        TInt aBearerFilter,
   1.142 +                                        TInt aSortType,
   1.143 +                                        TInt aReqIpvType
   1.144 +                                        );
   1.145 +
   1.146 +
   1.147 +
   1.148 +        /**
   1.149 +        * Two-phased constructor. Leaves on failure, places instance
   1.150 +        * on cleanup stack.
   1.151 +        * @param aDb a pointer to a CCommsDataBase.
   1.152 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.153 +        * Possible values are:
   1.154 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.155 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.156 +        * KEApIspTypeAll and their combinations.
   1.157 +        * @param aBearerFilter Filtering criteria on bearer type
   1.158 +        * Possible values are the TApBearer enums and
   1.159 +        * their combinations (or-ed).
   1.160 +        * @param aSortType Specifies the sort order to use.
   1.161 +        * Possible values are:
   1.162 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.163 +        * KEApSortNameAscending, KEApSortNameDescending
   1.164 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.165 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.166 +        * in case of CSD, all CSD access points are 
   1.167 +        * considered to be IPv4 & IPv6 (both)
   1.168 +        * @param aVpnFilterType a TVpnFilterType enum specifying the 
   1.169 +        * vpn filtering.
   1.170 +        * @return The constructed CApSelect.
   1.171 +        *
   1.172 +        * @deprecated
   1.173 +        */
   1.174 +        IMPORT_C static CApSelect* NewLC(
   1.175 +                                        CCommsDatabase& aDb,
   1.176 +                                        TInt aIspFilter,
   1.177 +                                        TInt aBearerFilter,
   1.178 +                                        TInt aSortType,
   1.179 +                                        TInt aReqIpvType,
   1.180 +                                        TVpnFilterType aVpnFilterType );
   1.181 +
   1.182 +
   1.183 +        /**
   1.184 +        * Two-phased constructor. Leaves on failure, places instance
   1.185 +        * on cleanup stack.
   1.186 +        * @param aDb a pointer to a CCommsDataBase.
   1.187 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.188 +        * Possible values are:
   1.189 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.190 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.191 +        * KEApIspTypeAll and their combinations.
   1.192 +        * @param aBearerFilter Filtering criteria on bearer type
   1.193 +        * Possible values are the TApBearer enums and
   1.194 +        * their combinations (or-ed).
   1.195 +        * @param aSortType Specifies the sort order to use.
   1.196 +        * Possible values are:
   1.197 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.198 +        * KEApSortNameAscending, KEApSortNameDescending
   1.199 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.200 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.201 +        * in case of CSD, all CSD access points are 
   1.202 +        * considered to be IPv4 & IPv6 (both)
   1.203 +        * @param aVpnFilterType a TVpnFilterType enum specifying the 
   1.204 +        * vpn filtering.
   1.205 +        * @param aIncludeEasyWlan TBool specifying whther to include
   1.206 +        * EasyWlan access point in the list or not...
   1.207 +        * @return The constructed CApSelect.
   1.208 +        *
   1.209 +        * @deprecated
   1.210 +        */
   1.211 +        IMPORT_C static CApSelect* NewLC(
   1.212 +                                        CCommsDatabase& aDb,
   1.213 +                                        TInt aIspFilter,
   1.214 +                                        TInt aBearerFilter,
   1.215 +                                        TInt aSortType,
   1.216 +                                        TInt aReqIpvType,
   1.217 +                                        TVpnFilterType aVpnFilterType,
   1.218 +                                        TBool aIncludeEasyWlan );
   1.219 +
   1.220 +
   1.221 +        /**
   1.222 +        * Destructor.
   1.223 +        *
   1.224 +        * @deprecated
   1.225 +        */
   1.226 +        IMPORT_C virtual ~CApSelect();
   1.227 +
   1.228 +
   1.229 +    protected:      // Constructors
   1.230 +
   1.231 +        /**
   1.232 +        * C++ default constructor.
   1.233 +        *
   1.234 +        * @deprecated
   1.235 +        */
   1.236 +        IMPORT_C CApSelect();
   1.237 +
   1.238 +
   1.239 +        /**
   1.240 +        * Second-phase constructor.
   1.241 +        * @param aDb a pointer to a CCommsDataBase.
   1.242 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.243 +        * Possible values are:
   1.244 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.245 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.246 +        * KEApIspTypeAll and their combinations.
   1.247 +        * @param aBearerFilter Filtering criteria on bearer type
   1.248 +        * Possible values are the TApBearer enums and
   1.249 +        * their combinations (or-ed).
   1.250 +        * @param aSortType Specifies the sort order to use.
   1.251 +        * Possible values are:
   1.252 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.253 +        * KEApSortNameAscending, KEApSortNameDescending
   1.254 +        *
   1.255 +        * @deprecated
   1.256 +        */
   1.257 +        IMPORT_C void ConstructL(
   1.258 +                                CCommsDatabase& aDb,
   1.259 +                                TInt aIspFilter,
   1.260 +                                TInt aBearerFilter,
   1.261 +                                TInt aSortType
   1.262 +                                );
   1.263 +
   1.264 +
   1.265 +        /**
   1.266 +        * Second-phase constructor.
   1.267 +        * @param aDb a pointer to a CCommsDataBase.
   1.268 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.269 +        * Possible values are:
   1.270 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.271 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.272 +        * KEApIspTypeAll and their combinations.
   1.273 +        * @param aBearerFilter Filtering criteria on bearer type
   1.274 +        * Possible values are the TApBearer enums and
   1.275 +        * their combinations (or-ed).
   1.276 +        * @param aSortType Specifies the sort order to use.
   1.277 +        * Possible values are:
   1.278 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.279 +        * KEApSortNameAscending, KEApSortNameDescending
   1.280 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.281 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.282 +        * in case of CSD, all CSD access points are 
   1.283 +        * considered to be IPv4 & IPv6 (both)
   1.284 +        *
   1.285 +        * @deprecated
   1.286 +        */
   1.287 +        IMPORT_C void ConstructL(
   1.288 +                                CCommsDatabase& aDb,
   1.289 +                                TInt aIspFilter,
   1.290 +                                TInt aBearerFilter,
   1.291 +                                TInt aSortType,
   1.292 +                                TInt aReqIpvType
   1.293 +                                );
   1.294 +
   1.295 +
   1.296 +        /**
   1.297 +        * Second-phase constructor.
   1.298 +        * @param aDb a pointer to a CCommsDataBase.
   1.299 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.300 +        * Possible values are:
   1.301 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.302 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.303 +        * KEApIspTypeAll and their combinations.
   1.304 +        * @param aBearerFilter Filtering criteria on bearer type
   1.305 +        * Possible values are the TApBearer enums and
   1.306 +        * their combinations (or-ed).
   1.307 +        * @param aSortType Specifies the sort order to use.
   1.308 +        * Possible values are:
   1.309 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.310 +        * KEApSortNameAscending, KEApSortNameDescending
   1.311 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.312 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.313 +        * in case of CSD, all CSD access points are 
   1.314 +        * considered to be IPv4 & IPv6 (both)
   1.315 +        * @param aVpnFilterType a TVpnFilterType enum specifying the 
   1.316 +        * vpn filtering.
   1.317 +        *
   1.318 +        * @deprecated
   1.319 +        */
   1.320 +        IMPORT_C void ConstructL( CCommsDatabase& aDb,
   1.321 +                                 TInt aIspFilter,
   1.322 +                                 TInt aBearerFilter,
   1.323 +                                 TInt aSortType,
   1.324 +                                 TInt aReqIpvType,
   1.325 +                                 TVpnFilterType aVpnFilterType 
   1.326 +                                 );
   1.327 +                                 
   1.328 +        /**
   1.329 +        * Second-phase constructor.
   1.330 +        * @param aDb a pointer to a CCommsDataBase.
   1.331 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.332 +        * Possible values are:
   1.333 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.334 +        * KEApIspTypeInternetAndWAP, KEApIspTypeWAPMandatory
   1.335 +        * KEApIspTypeAll and their combinations.
   1.336 +        * @param aBearerFilter Filtering criteria on bearer type
   1.337 +        * Possible values are the TApBearer enums and
   1.338 +        * their combinations (or-ed).
   1.339 +        * @param aSortType Specifies the sort order to use.
   1.340 +        * Possible values are:
   1.341 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.342 +        * KEApSortNameAscending, KEApSortNameDescending
   1.343 +        * @param aReqIpvType Filtering criteria on the IPv type of the 
   1.344 +        * access point. In case of GPRS, GPRS_PDP_TYPE holds it, while
   1.345 +        * in case of CSD, all CSD access points are 
   1.346 +        * considered to be IPv4 & IPv6 (both)
   1.347 +        * @param aVpnFilterType a TVpnFilterType enum specifying the 
   1.348 +        * vpn filtering.
   1.349 +        * @param aIncludeEasyWlan TBool specifying whther to include
   1.350 +        * EasyWlan access point in the list or not...
   1.351 +        *
   1.352 +        * @deprecated
   1.353 +        */                                 
   1.354 +        IMPORT_C void ConstructL( CCommsDatabase& aDb,
   1.355 +                                 TInt aIspFilter,
   1.356 +                                 TInt aBearerFilter,
   1.357 +                                 TInt aSortType,
   1.358 +                                 TInt aReqIpvType,
   1.359 +                                 TVpnFilterType aVpnFilterType,
   1.360 +                                 TBool aIncludeEasyWlan );
   1.361 +                                 
   1.362 +    public: // New functions
   1.363 +        /**
   1.364 +        * Sets filters and sorting order for the list of available
   1.365 +        * access points
   1.366 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.367 +        * Possible values are:
   1.368 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.369 +        * KEApIspTypeInternetAndWAP,
   1.370 +        * KEApIspTypeWAPMandatory, KEApIspTypeAll and their combinations.
   1.371 +        * @param aBearerFilter Filtering criteria on bearer type
   1.372 +        * Possible values are the TApBearer enums and
   1.373 +        * their combinations (or-ed).
   1.374 +        * @param aSortType Specifies the sort order to use.
   1.375 +        * Possible values are:
   1.376 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.377 +        * KEApSortNameAscending, KEApSortNameDescending
   1.378 +        *
   1.379 +        * @deprecated
   1.380 +        */
   1.381 +        IMPORT_C void SetFiltersL(
   1.382 +                                 TInt aIspFilter,
   1.383 +                                 TInt aBearerFilter,
   1.384 +                                 TInt aSortType
   1.385 +                                 );
   1.386 +
   1.387 +
   1.388 +
   1.389 +        /**
   1.390 +        * Gets the current ISP-type filter
   1.391 +        * @return The current ISP-type filter
   1.392 +        *
   1.393 +        * @deprecated
   1.394 +        */
   1.395 +        IMPORT_C TInt IspTypeFilter();
   1.396 +
   1.397 +
   1.398 +        /**
   1.399 +        * Gets the current bearer-type filter
   1.400 +        * @return The current bearer-type filter
   1.401 +        *
   1.402 +        * @deprecated
   1.403 +        */
   1.404 +        IMPORT_C TInt BearerFilter();
   1.405 +
   1.406 +
   1.407 +        /**
   1.408 +        * Gets the current sorting order
   1.409 +        * @return The current sorting order
   1.410 +        *
   1.411 +        * @deprecated
   1.412 +        */
   1.413 +        IMPORT_C TInt SortOrder();
   1.414 +
   1.415 +
   1.416 +        /**
   1.417 +        * Navigates to the first access point in the list.
   1.418 +        * @return Boolean indicating the success of the operation.
   1.419 +        *
   1.420 +        * @deprecated
   1.421 +        */
   1.422 +        IMPORT_C TBool  MoveToFirst();
   1.423 +
   1.424 +
   1.425 +        /**
   1.426 +        * Navigates to the next access point in the list.
   1.427 +        * @return Boolean indicating the success of the operation.
   1.428 +        *
   1.429 +        * @deprecated
   1.430 +        */
   1.431 +        IMPORT_C TBool  MoveNext();
   1.432 +
   1.433 +
   1.434 +        /**
   1.435 +        * Navigates to the last access point in the list.
   1.436 +        * @return Boolean indicating the success of the operation.
   1.437 +        *
   1.438 +        * @deprecated
   1.439 +        */
   1.440 +        IMPORT_C TBool  MoveLast();
   1.441 +
   1.442 +
   1.443 +        /**
   1.444 +        * Navigates to the previous access point in the list.
   1.445 +        * @return Boolean indicating the success of the operation.
   1.446 +        *
   1.447 +        * @deprecated
   1.448 +        */
   1.449 +        IMPORT_C TBool  MovePrev();
   1.450 +
   1.451 +
   1.452 +        /**
   1.453 +        * Counts the items in the list
   1.454 +        * @return The number of items in the list.
   1.455 +        *
   1.456 +        * @deprecated
   1.457 +        */
   1.458 +        IMPORT_C TUint32 Count();
   1.459 +
   1.460 +
   1.461 +        /**
   1.462 +        * Gets the name of the 'current' access point
   1.463 +        * Ownership of the returned text is not passed.
   1.464 +        * @return The name of the current access point
   1.465 +        *
   1.466 +        * @deprecated
   1.467 +        */
   1.468 +        IMPORT_C const TDesC& Name();
   1.469 +
   1.470 +
   1.471 +        /**
   1.472 +        * Gets the UID of the current access point
   1.473 +        * @return The UID of the current access point
   1.474 +        *
   1.475 +        * @deprecated
   1.476 +        */
   1.477 +        IMPORT_C TUint32 Uid();
   1.478 +
   1.479 +
   1.480 +        /**
   1.481 +        * Gets the ISP-type of the current access point
   1.482 +        * @return The ISP-type of the current access point.
   1.483 +        *
   1.484 +        * @deprecated
   1.485 +        */
   1.486 +        IMPORT_C TCommsDbIspType Type();
   1.487 +
   1.488 +
   1.489 +        /**
   1.490 +        * Gets the bearer-type of the current access point
   1.491 +        * @return The bearer-type of the current access point.
   1.492 +        *
   1.493 +        * @deprecated
   1.494 +        */
   1.495 +        IMPORT_C TApBearerType BearerType();
   1.496 +
   1.497 +
   1.498 +        /**
   1.499 +        * Provides all data in a CApListItemList array.
   1.500 +        * @param aList A reference to a CApListItemList object
   1.501 +        * to hold the values.
   1.502 +        * @return The number of items in the list.
   1.503 +        * All elements in the aList array and their memory
   1.504 +        * will be freed inside the routine.
   1.505 +        * The routine expands or shrinks the array as necessary
   1.506 +        * to minimize memory consumption.
   1.507 +        *
   1.508 +        * @deprecated
   1.509 +        */
   1.510 +        IMPORT_C TInt AllListItemDataL( CApListItemList& aList );
   1.511 +
   1.512 +        /**
   1.513 +        * Returns whether the current item is read-only or not.
   1.514 +        * @return Returns whether the current item is read-only or not.
   1.515 +        *
   1.516 +        * @deprecated
   1.517 +        */
   1.518 +        IMPORT_C TBool IsReadOnly() const;
   1.519 +
   1.520 +    private:
   1.521 +        /**
   1.522 +        * This function updates the member data according to the
   1.523 +        * current filter settings.
   1.524 +        * @return Error code.
   1.525 +        */
   1.526 +        TInt DoUpdateL();
   1.527 +
   1.528 +
   1.529 +        /**
   1.530 +        * Gets the filtered and sorted wap table
   1.531 +        * and places it on the Cleanupstack
   1.532 +        */
   1.533 +        CCommsDbTableView* GetFilteredSortedWapTableViewLC();
   1.534 +
   1.535 +
   1.536 +        /**
   1.537 +        * Gets the filtered and sorted IP bearer table
   1.538 +        * and places it on the Cleanupstack
   1.539 +        */
   1.540 +        CCommsDbTableView* GetFilteredSortedIpBearerTableViewLC();
   1.541 +
   1.542 +
   1.543 +        /**
   1.544 +        * Gets the filtered and sorted ISP table
   1.545 +        * and places it on the Cleanupstack
   1.546 +        */
   1.547 +        CCommsDbTableView* GetFilteredSortedIspOutTableViewLC();
   1.548 +
   1.549 +
   1.550 +        /**
   1.551 +        * Gets the filtered and sorted GPRS table
   1.552 +        * and places it on the Cleanupstack
   1.553 +        */
   1.554 +        CCommsDbTableView* GetFilteredSortedGprsTableViewLC( TBool aIn );
   1.555 +
   1.556 +
   1.557 +        /**
   1.558 +        * Gets the filtered and sorted CDMA table
   1.559 +        * and places it on the Cleanupstack
   1.560 +        */
   1.561 +        CCommsDbTableView* GetFilteredSortedCdmaTableViewLC();
   1.562 +
   1.563 +
   1.564 +        /**
   1.565 +        * Reads up the specified columns TUint32 values stored
   1.566 +        * in the table and returns it in the passed array
   1.567 +        */
   1.568 +        void GetUintValuesL
   1.569 +                (
   1.570 +                CCommsDbTableView* aTable,
   1.571 +                const TDesC& aField,
   1.572 +                CArrayFixFlat<TUint32>& aArray
   1.573 +                );
   1.574 +
   1.575 +
   1.576 +        /**
   1.577 +        * Reads up the protection values stored
   1.578 +        * in the table and returns it in the passed array
   1.579 +        */
   1.580 +        void GetProtValuesL( CCommsDbTableView* aTable,
   1.581 +                             CArrayFixFlat<TUint32>& aArray );
   1.582 +
   1.583 +        /**
   1.584 +        * Reads up the specified columns text values stored
   1.585 +        * in the table and returns it in the passed array
   1.586 +        */
   1.587 +        void GetTextValuesL
   1.588 +                (
   1.589 +                CCommsDbTableView* aTable,
   1.590 +                const TDesC& aField,
   1.591 +                CArrayPtrFlat<HBufC>& aArray
   1.592 +                );
   1.593 +
   1.594 +
   1.595 +        /**
   1.596 +        * Reads up the specified columns long text values stored
   1.597 +        * in the table and returns it in the passed array
   1.598 +        */
   1.599 +        void GetLongTextValuesL
   1.600 +                (
   1.601 +                CCommsDbTableView* aTable,
   1.602 +                const TDesC& aField,
   1.603 +                CArrayPtrFlat<HBufC>& aArray
   1.604 +                );
   1.605 +
   1.606 +
   1.607 +        /**
   1.608 +        * Returns whether a given value is in the given array or not
   1.609 +        */
   1.610 +        TBool IsInArray( CArrayFixFlat<TUint32>* aArray, TUint32 aValue );
   1.611 +
   1.612 +
   1.613 +        /**
   1.614 +        * Returns the position of a given value in the given array.
   1.615 +        */
   1.616 +        TInt PosInArray( CArrayFixFlat<TUint32>* aArray, TUint32 aValue );
   1.617 +
   1.618 +
   1.619 +        /**
   1.620 +        * Returns the position of an item with a given UID in the given list.
   1.621 +        */
   1.622 +        TInt GetItemPos( CApListItemList* aTmpApList, TUint32 aId );
   1.623 +
   1.624 +
   1.625 +        /**
   1.626 +        * Opens a view on the given table where a given text coloumn has
   1.627 +        * a given value
   1.628 +        * @return the opened view on the table
   1.629 +        */
   1.630 +        CCommsDbTableView* OpenViewMatchingTextL
   1.631 +                                (
   1.632 +                                const TDesC& aTableName,
   1.633 +                                const TDesC& aColumnToMatch,
   1.634 +                                const TDesC16& aValueToMatch
   1.635 +                                );
   1.636 +
   1.637 +        /**
   1.638 +        * Gets the ISP values (ISP UID, ISP type, ISP bearer type)
   1.639 +        * from a given table
   1.640 +        * @param aTable the table to go through (already filtered & ordered)
   1.641 +        * @param aArray An array to hold the readed values
   1.642 +        * @param aColName Column name (different column names are used for
   1.643 +        * CSD/GPRS/CDMA.
   1.644 +        */
   1.645 +        void GetIspValuesL
   1.646 +                (
   1.647 +                CCommsDbTableView* aTable,
   1.648 +                CArrayFixFlat<TUint32[3]>* aArray,
   1.649 +                const TDesC& aColName
   1.650 +                );
   1.651 +
   1.652 +        /**
   1.653 +        * Gets the position of an element with a given IAP UID
   1.654 +        */
   1.655 +        TInt GetIapPos
   1.656 +                (
   1.657 +                CArrayFixFlat<TUint32[3]>* aArray,
   1.658 +                TUint32 aValue
   1.659 +                );
   1.660 +
   1.661 +        /**
   1.662 +        * Sorts the data according to localised sorting on the 
   1.663 +        * access point names, using CompareC
   1.664 +        */
   1.665 +        void SortLocalisedNameL( TBool aAscending = ETrue );
   1.666 +
   1.667 +
   1.668 +        /**
   1.669 +        * Sorts the data according to Uids
   1.670 +        */
   1.671 +        void SortUidL( TBool aAscending = ETrue );
   1.672 +
   1.673 +
   1.674 +
   1.675 +    private:    // New functions
   1.676 +        /**
   1.677 +        * Sets filters and sorting order for the list of available
   1.678 +        * access points
   1.679 +        * @param aIspTypeFilter Filtering criteria on ISP type
   1.680 +        * Possible values are:
   1.681 +        * KEApIspTypeInternetOnly, KEApIspTypeWAPOnly,
   1.682 +        * KEApIspTypeInternetAndWAP,
   1.683 +        * KEApIspTypeWAPMandatory, KEApIspTypeAll and their combinations.
   1.684 +        * @param aBearerFilter Filtering criteria on bearer type
   1.685 +        * Possible values are the TApBearer enums and
   1.686 +        * their combinations (or-ed).
   1.687 +        * @param aSortType Specifies the sort order to use.
   1.688 +        * Possible values are:
   1.689 +        * KEApSortUidAscending, KEApSortUidDescending,
   1.690 +        * KEApSortNameAscending, KEApSortNameDescending
   1.691 +        * @param aReqIpvType The filtering criteria for IPv type
   1.692 +        * @param aVpnFilterType The Vpn filtering type, TVpnFilterType values
   1.693 +        */
   1.694 +        void SetFiltersL( TInt aIspFilter,
   1.695 +                          TInt aBearerFilter,
   1.696 +                          TInt aSortType,
   1.697 +                          TInt aReqIpvType,
   1.698 +                          TInt aVpnFilterType
   1.699 +                         );
   1.700 +
   1.701 +
   1.702 +        /**
   1.703 +        * Returns a pointer to the opened VPN_SERVICE table
   1.704 +        */
   1.705 +        CCommsDbTableView* GetVpnTableViewLC();
   1.706 +
   1.707 +
   1.708 +        /**
   1.709 +        * Gets the VPN values (VPN IAP UID, VPN HOME IAP UID, VPN Name )
   1.710 +        * from the given VPN table
   1.711 +        * @param aTable the table to go through (already filtered & ordered)
   1.712 +        * @param aVpnArray An array to hold the readed vpn data values
   1.713 +        */
   1.714 +        void GetVpnValuesL( CCommsDbTableView* aTable, 
   1.715 +                            CArrayFixFlat<TVpnData>* aVpnArray );
   1.716 +
   1.717 +
   1.718 +        /**
   1.719 +        * Returns the supported bearer set from the passed requested bearer set
   1.720 +        * @param aBearerFilter The requested bearer set
   1.721 +        * return The supported subset of the requested bearers.
   1.722 +        */
   1.723 +        TInt GetSupportedBearerSet( TInt aBearerFilter );
   1.724 +
   1.725 +
   1.726 +        /**
   1.727 +        * Adding WLAN or LAN access points to existing list.
   1.728 +        * aWlan a TBool specifying whether WLAN or LAN
   1.729 +        */
   1.730 +        void AddLanL( TBool aWlan );
   1.731 +
   1.732 +
   1.733 +
   1.734 +
   1.735 +    private:    // Data
   1.736 +        CCommsDatabase*             iDb;    // Does not own it!
   1.737 +        TInt                        iIsp;
   1.738 +        TInt                        iBearer;
   1.739 +        TInt                        iSort;
   1.740 +        CApListItemList*            iApList;
   1.741 +        TInt                        iCursor;
   1.742 +        TInt                        iCount;
   1.743 +        TSelectExtra*               iExt;
   1.744 +
   1.745 +    };
   1.746 +
   1.747 +#endif      // CAPSELECT_H
   1.748 +
   1.749 +// End of File