1.1 --- a/epoc32/include/mw/apsettingshandlerui.h Tue Nov 24 13:55:44 2009 +0000
1.2 +++ b/epoc32/include/mw/apsettingshandlerui.h Tue Mar 16 16:12:26 2010 +0000
1.3 @@ -1,1 +1,1365 @@
1.4 -apsettingshandlerui.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:
1.19 +* Declares the main handler, CApSettingsHandler and public API for the
1.20 +* Access Point settings.
1.21 +*
1.22 +*/
1.23 +
1.24 +
1.25 +#ifndef APSETTINGS_HANDLER_H
1.26 +#define APSETTINGS_HANDLER_H
1.27 +
1.28 +// Deprecation warning
1.29 +#warning This header file has been deprecated. Will be removed in one of the next SDK releases.
1.30 +
1.31 +
1.32 +// INCLUDES
1.33 +#include <ApSettingsHandlerCommons.h>
1.34 +#include <ApEngineConsts.h>
1.35 +#include <ApSelect.h>
1.36 +
1.37 +// CONSTANTS
1.38 +const TUid KUidApSettingsHandler = { 0x10008d3B };
1.39 +
1.40 +typedef struct ///< Extra data holder
1.41 + {
1.42 + TInt iResOffset;
1.43 + TBool iIsIpv6Supported; // Default is NO
1.44 + TBool iIsFeatureManagerInitialised;
1.45 + TInt iExtra;
1.46 + TInt iSortType;
1.47 + TVpnFilterType iVpnFilterType;
1.48 + TInt iVariant; /// Local variant value
1.49 + TBool iIncludeEasyWlan;
1.50 + }TApSetHandlerExtra;
1.51 +
1.52 +// FORWARD DECLARATIONS
1.53 +class CActiveApDb;
1.54 +class CApSelector;
1.55 +class CApSettingsModel;
1.56 +class CApSettings;
1.57 +class CTextOverrides;
1.58 +class CApAccessPointItem;
1.59 +
1.60 +class CApSettingsHandlerImpl;
1.61 +
1.62 +// CLASS DECLARATION
1.63 +/**
1.64 +* CApSettingsHandler class: It is the main handler for the Access Point
1.65 +* settings. It contains the only public API for other (sub)systems.
1.66 +*
1.67 +*/
1.68 +class CApSettingsHandler : public CBase
1.69 + {
1.70 +
1.71 + public: // Constructors and destructor
1.72 +
1.73 +
1.74 + /**
1.75 + * Two-phased constructor. Leaves on failure.
1.76 + * This function shall be used to create the access point
1.77 + * settings/selection handling UI object. It is customizable through
1.78 + * the parameters. This object is a small layer above the UI part and
1.79 + * it provides a standard interface to select, edit, create access
1.80 + * points. It has two main parts, Select and Edit. The first parameter,
1.81 + * aStartWithSelection gives whether we would like to select or edit.
1.82 + * In case of selection, there is the possibility to use this module in
1.83 + * many applications. For this, two layouts are implemented,
1.84 + * one is list pane used by General Settings which provides the list in
1.85 + * a list-pane. The other layout is for the other applications
1.86 + * requiring access point selection, a popup-list style as the decision
1.87 + * I know about was that General Settings will use list-pane and all
1.88 + * other apps. popup-list style. It is the caller who selects the style
1.89 + * so if spec. says otherwise, this module still can be used.
1.90 + * It is also possible to start the UI without selection, so if any
1.91 + * module has a 'linked/default/etc.' access point and stored it's UID,
1.92 + * the module can simply call the editor part of the UI without having
1.93 + * to select the AP once more. In case of editing only,
1.94 + * (aStartWithSelection is EFalse), all other construction parameters
1.95 + * are ignored and after construction caller can simply call
1.96 + * RunSettingsL(..). In case of selection, a lot of other parameters
1.97 + * can be specified to fulfil all requirements. There are three types
1.98 + * of Options menu available:
1.99 + * EApSettingsSelMenuNormal,
1.100 + * EApSettingsSelMenuSelectOnly,
1.101 + * EApSettingsSelMenuSelectNormal.
1.102 + * <br>
1.103 + *-EApSettingsSelMenuSelectOnly: Only Select is visible,
1.104 + * no way to edit, delete, create, etc.
1.105 + * <br>
1.106 + * -EApSettingsSelMenuNormal: Options menu specified in General
1.107 + * Settings, contains Edit, Delete,
1.108 + * Create new, etc. menu items.
1.109 + * <br>
1.110 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.111 + * BUT the first item is Select.
1.112 + * This one makes it possible to select
1.113 + * an access point and also possible to
1.114 + * edit, create, delete, etc.
1.115 + * <br>
1.116 + * The following three parameters specify the filtering and ordering
1.117 + * criteria for the selection list creation. First, it is possible to
1.118 + * specify which ISP-type we are looking for. The possible values are:
1.119 + * <br>
1.120 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.121 + * capable of only internet access.
1.122 + * <br>
1.123 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.124 + * capable of only WAP access.
1.125 + * <br>
1.126 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.127 + * capable of internet AND WAP access.
1.128 + * <br>
1.129 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.130 + * capable of WAP access AND contain
1.131 + * mandatory WAP settings.
1.132 + * <br>
1.133 + * KEApIspTypeAll: No filtering is done for the isp-type,
1.134 + * all types of access points are shown.
1.135 + * <br>
1.136 + * It is possible to combine them by simply adding/or-ing together
1.137 + * the values, filtering will be done in such a way that only access
1.138 + * points with the listed ISP-types will be shown. Second filtering
1.139 + * possibility (aBearerFilter) is the desired bearer type. The possible
1.140 + * values are the values of the TApBearerType enum type and their
1.141 + * combinations, as in case of the ISP type. The ordering of the list
1.142 + * can be specified with the aSortType parameter. It can have the
1.143 + * following values:
1.144 + * KEApSortUidAscending: The sorting is done according to the ID
1.145 + * of the access points in ascending order.
1.146 + * KEApSortUidDescending: The sorting is done according to the ID
1.147 + * of the access points in descending order.
1.148 + * KEApSortNameAscending: The sorting is done according to the name
1.149 + * of the access points in ascending order.
1.150 + * KEApSortNameDescending: The sorting is done according to the name
1.151 + * of the access points in descending order.
1.152 + * Caution! The ordering values can not be combined!
1.153 + * @param aStartWithSelection A boolean value indicating whether to
1.154 + * select or edit an ap.
1.155 + * @param aListType A TSelectionListType enum indicating the
1.156 + * desired list type.
1.157 + * @param aSelMenuType A TSelectionMenuType enum indicating the
1.158 + * desired menu type.
1.159 + * @param aIspTypeFilter Filtering criteria on ISP type
1.160 + * @param aBearerFilter Filtering criteria on bearer type
1.161 + * @param aSortType Specifies the sort order to use.
1.162 + * @return The constructed CApSettingsHandler object.
1.163 + *
1.164 + * @deprecated
1.165 + */
1.166 + IMPORT_C static CApSettingsHandler* NewLC(
1.167 + TBool aStartWithSelection,
1.168 + TSelectionListType aListType,
1.169 + TSelectionMenuType aSelMenuType,
1.170 + TInt aIspFilter,
1.171 + TInt aBearerFilter,
1.172 + TInt aSortType
1.173 + );
1.174 +
1.175 +
1.176 +
1.177 + /**
1.178 + * Two-phased constructor. Leaves on failure.
1.179 + * This function shall be used to create the access point
1.180 + * settings/selection handling UI object. It is customizable through
1.181 + * the parameters. This object is a small layer above the UI part and
1.182 + * it provides a standard interface to select, edit, create
1.183 + * access points. It has two main parts, Select and Edit. The first
1.184 + * parameter, aStartWithSelection gives whether we would like to select
1.185 + * or edit. In case of selection, there is the possibility to use this
1.186 + * module in many applications. For this, two layouts are implemented,
1.187 + * one is list pane used by General Settings which provides the list
1.188 + * in a list-pane. The other layout is for the other applications
1.189 + * requiring access point selection, a popup-list style as the
1.190 + * decision I know about was that General Settings will use list-pane
1.191 + * and all other apps. popup-list style. It is the caller who selects
1.192 + * the style so if spec. says otherwise, this module still can be used.
1.193 + * It is also possible to start the UI without selection, so if any
1.194 + * module has a 'linked/default/etc.' access point and stored it's UID,
1.195 + * the module can simply call the editor part of the UI without having
1.196 + * to select the AP once more.
1.197 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.198 + * construction parameters are ignored and after construction caller
1.199 + * can simply call RunSettingsL(..).
1.200 + * In case of selection, a lot of other parameters can be specified
1.201 + * to fulfil all requirements. There are three types of Options menu
1.202 + * available:
1.203 + * EApSettingsSelMenuNormal,
1.204 + * EApSettingsSelMenuSelectOnly,
1.205 + * EApSettingsSelMenuSelectNormal.
1.206 + * <br>
1.207 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to
1.208 + * edit, delete, create, etc.
1.209 + * <br>
1.210 + * -EApSettingsSelMenuNormal: Options menu specified in General
1.211 + * Settings, contains Edit, Delete,
1.212 + * Create new, etc. menu items.
1.213 + * <br>
1.214 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.215 + * BUT the first item is Select.
1.216 + * This one makes it possible to
1.217 + * select an access point and also
1.218 + * possible to edit, create,
1.219 + * delete, etc.
1.220 + * <br>
1.221 + * The following three parameters specify the filtering and ordering
1.222 + * criteria for the selection list creation. First, it is possible to
1.223 + * specify which ISP-type we are looking for. The possible values are:
1.224 + * <br>
1.225 + * KEApIspTypeInternetOnly: Filter allows only access points that
1.226 + * are capable of only internet access.
1.227 + * <br>
1.228 + * KEApIspTypeWAPOnly: Filter allows only access points that
1.229 + * are capable of only WAP access.
1.230 + * <br>
1.231 + * KEApIspTypeInternetAndWAP: Filter allows only access points that
1.232 + * are capable of internet AND WAP access.
1.233 + * <br>
1.234 + * KEApIspTypeWAPMandatory: Filter allows only access points that
1.235 + * are capable of WAP access AND contain
1.236 + * mandatory WAP settings.
1.237 + * <br>
1.238 + * KEApIspTypeAll: No filtering is done for the isp-type,
1.239 + * all types of access points are shown.
1.240 + * <br>
1.241 + * It is possible to combine them by simply adding/or-ing together the
1.242 + * values, filtering will be done in such a way that only access points
1.243 + * with the listed ISP-types will be shown.
1.244 + * Second filtering possibility (aBearerFilter) is the desired bearer
1.245 + * type. The possible values are the values of the TApBearerType enum
1.246 + * type and their combinations, as in case of the ISP type.
1.247 + * The ordering of the list can be specified with the aSortType
1.248 + * parameter. It can have the following values:
1.249 + * KEApSortUidAscending: The sorting is done according to the ID
1.250 + * of the access points in ascending order.
1.251 + * KEApSortUidDescending: The sorting is done according to the ID
1.252 + * of the access points in descending order.
1.253 + * KEApSortNameAscending: The sorting is done according to the name
1.254 + * of the access points in ascending order.
1.255 + * KEApSortNameDescending: The sorting is done according to the name
1.256 + * of the access points in descending order.
1.257 + * Caution! The ordering values can not be combined!
1.258 + * @param aDb A database to work on
1.259 + * @param aStartWithSelection A boolean value indicating whether to
1.260 + * select or edit an ap.
1.261 + * @param aListType A TSelectionListType enum indicating the desired
1.262 + * list type.
1.263 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.264 + * menu type.
1.265 + * @param aIspTypeFilter Filtering criteria on ISP type
1.266 + * @param aBearerFilter Filtering criteria on bearer type
1.267 + * @param aSortType Specifies the sort order to use.
1.268 + * @return The constructed CApSettingsHandler object.
1.269 + *
1.270 + * @deprecated
1.271 + */
1.272 + IMPORT_C static CApSettingsHandler* NewLC(
1.273 + CActiveApDb& aDb,
1.274 + TBool aStartWithSelection,
1.275 + TSelectionListType aListType,
1.276 + TSelectionMenuType aSelMenuType,
1.277 + TInt aIspFilter,
1.278 + TInt aBearerFilter,
1.279 + TInt aSortType
1.280 + );
1.281 +
1.282 +
1.283 +
1.284 +
1.285 +
1.286 +
1.287 +
1.288 +
1.289 + /**
1.290 + * Two-phased constructor. Leaves on failure.
1.291 + * This function shall be used to create the access point
1.292 + * settings/selection handling UI object.It is customizable through the
1.293 + * parameters. This object is a small layer above the UI part and
1.294 + * it provides a standard interface to select, edit, create access
1.295 + * points. It has two main parts, Select and Edit. The first parameter,
1.296 + * aStartWithSelection gives whether we would like to select or edit.
1.297 + * In case of selection, there is the possibility to use this module in
1.298 + * many applications. For this, two layouts are implemented, one is
1.299 + * list pane used by General Settings which provides the list in a
1.300 + * list-pane. The other layout is for the other applications requiring
1.301 + * access point selection, a popup-list style as the decision was that
1.302 + * General Settings will use list-pane and all other apps. popup-list
1.303 + * style. It is the caller who selects the style so if spec. says
1.304 + * otherwise, this module still can be used.
1.305 + * It is also possible to start the UI without selection, so if any
1.306 + * module has a 'linked/default/etc.' access point and stored it's UID,
1.307 + * the module can simply call the editor part of the UI without having
1.308 + * to select the AP once more.
1.309 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.310 + * construction parameters are ignored and after construction caller
1.311 + * can simply call RunSettingsL(..).
1.312 + * In case of selection, a lot of other parameters can be specified to
1.313 + * fulfil all requirements. There are three types of Options menu
1.314 + * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly,
1.315 + * EApSettingsSelMenuSelectNormal.
1.316 + * <br>
1.317 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,
1.318 + * delete, create, etc.
1.319 + * <br>
1.320 + * -EApSettingsSelMenuNormal:Options menu specified in General Settings,
1.321 + * contains Edit, Delete, Create new, etc. menu items.
1.322 + * <br>
1.323 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.324 + * BUT the first item is Select. This one makes it possible to select
1.325 + * an access point and also possible to edit, create, delete, etc.
1.326 + * <br>
1.327 + * The following three parameters specify the filtering and ordering
1.328 + * criteria for the selection list creation. First, it is possible to
1.329 + * specify which ISP-type we are looking for. The possible values are:
1.330 + * <br>
1.331 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.332 + * capable of only internet access.
1.333 + * <br>
1.334 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.335 + * capable of only WAP access.
1.336 + * <br>
1.337 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.338 + * capable of internet AND WAP access.
1.339 + * <br>
1.340 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.341 + * capable of WAP access AND contain mandatory WAP settings.
1.342 + * <br>
1.343 + * KEApIspTypeAll: No filtering is done for the isp-type, all types of
1.344 + * access points are shown.
1.345 + * <br>
1.346 + * It is possible to combine them by simply adding/or-ing together the
1.347 + * values, filtering will be done in such a way that only access points
1.348 + * with the listed ISP-types will be shown.
1.349 + * Second filtering possibility (aBearerFilter) is the desired bearer
1.350 + * type. The possible values are the values of the TApBearerType enum
1.351 + * type and their combinations, as in case of the ISP type.
1.352 + * The ordering of the list can be specified with the aSortType
1.353 + * parameter. It can have the following values:
1.354 + * KEApSortUidAscending: The sorting is done according to the ID of
1.355 + * the access points in ascending order.
1.356 + * KEApSortUidDescending: The sorting is done according to the ID of
1.357 + * the access points in descending order.
1.358 + * KEApSortNameAscending: The sorting is done according to the name of
1.359 + * the access points in ascending order.
1.360 + * KEApSortNameDescending: The sorting is done according to the name of
1.361 + * the access points in descending order.
1.362 + * Caution! The ordering values can not be combined!
1.363 + * @param aStartWithSelection A boolean value indicating whether to
1.364 + * select or edit an ap.
1.365 + * @param aListType A TSelectionListType enum indicating the desired
1.366 + * list type.
1.367 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.368 + * menu type.
1.369 + * @param aIspTypeFilter Filtering criteria on ISP type
1.370 + * @param aBearerFilter Filtering criteria on bearer type
1.371 + * @param aSortType Specifies the sort order to use.
1.372 + * @param aReqIpvType Specifies whether the caller would like to
1.373 + * have IPv4, IPv6 or both access points. If it is IPv6 or Both,
1.374 + * in case of IPv6 support is available as a feature, it will be
1.375 + * supported. If IPv6 feature is not supported by the phone, it
1.376 + * simply defaults to the normal IPv4 version.
1.377 + * If it is IPv4, it uses the default IPv4 version independently
1.378 + * from IPv6 feature beeing available or not.
1.379 + * @return The constructed CApSettingsHandler object.
1.380 + *
1.381 + * @deprecated
1.382 + */
1.383 + IMPORT_C static CApSettingsHandler* NewLC(
1.384 + TBool aStartWithSelection,
1.385 + TSelectionListType aListType,
1.386 + TSelectionMenuType aSelMenuType,
1.387 + TInt aIspFilter,
1.388 + TInt aBearerFilter,
1.389 + TInt aSortType,
1.390 + TInt aReqIpvType
1.391 + );
1.392 +
1.393 +
1.394 +
1.395 + /**
1.396 + * Two-phased constructor. Leaves on failure.
1.397 + * This function shall be used to create the access point
1.398 + * settings/selection handling UI object. It is customizable through
1.399 + * the parameters. This object is a small layer above the UI part and
1.400 + * it provides a standard interface to select, edit, create access
1.401 + * points. It has two main parts, Select and Edit. The first parameter,
1.402 + * aStartWithSelection gives whether we would like to select or edit.
1.403 + * In case of selection, there is the possibility to use this module in
1.404 + * many applications. For this, two layouts are implemented, one is list
1.405 + * pane used by General Settings which provides the list in a list-pane.
1.406 + * The other layout is for the other applications requiring access point
1.407 + * selection, a popup-list style as the decision was that General
1.408 + * Settings will use list-pane and all other apps. popup-list style.
1.409 + * It is the caller who selects the style so if spec. says otherwise,
1.410 + * this module still can be used. It is also possible to start the UI
1.411 + * without selection, so if any module has a 'linked/default/etc.'
1.412 + * access point and stored it's UID, the module can simply call the
1.413 + * editor part of the UI without having to select the AP once more.
1.414 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.415 + * construction parameters are ignored and after construction caller can
1.416 + * simply call RunSettingsL(..). In case of selection, a lot of other
1.417 + * parameters can be specified to fulfil all requirements. There are
1.418 + * three types of Options menu available: EApSettingsSelMenuNormal,
1.419 + * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.
1.420 + * <br>
1.421 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,
1.422 + * delete, create, etc.
1.423 + * <br>
1.424 + * -EApSettingsSelMenuNormal:Options menu specified in General Settings,
1.425 + * contains Edit, Delete, Create new, etc. menu items.
1.426 + * <br>
1.427 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.428 + * BUT the first item is Select. This one makes it possible to select
1.429 + * an access point and also possible to edit, create, delete, etc.
1.430 + * <br>
1.431 + * The following three parameters specify the filtering and ordering
1.432 + * criteria for the selection list creation. First, it is possible to
1.433 + * specify which ISP-type we are looking for. The possible values are:
1.434 + * <br>
1.435 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.436 + * capable of only internet access.
1.437 + * <br>
1.438 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.439 + * capable of only WAP access.
1.440 + * <br>
1.441 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.442 + * capable of internet AND WAP access.
1.443 + * <br>
1.444 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.445 + * capable of WAP access AND contain mandatory WAP settings.
1.446 + * <br>
1.447 + * KEApIspTypeAll: No filtering is done for the isp-type, all types of
1.448 + * access points are shown.
1.449 + * <br>
1.450 + * It is possible to combine them by simply adding/or-ing together the
1.451 + * values, filtering will be done in such a way that only access points
1.452 + * with the listed ISP-types will be shown. Second filtering possibility
1.453 + * (aBearerFilter) is the desired bearer type. The possible values are
1.454 + * the values of the TApBearerType enum type and their combinations, as
1.455 + * in case of the ISP type. The ordering of the list can be specified
1.456 + * with the aSortType parameter. It can have the following values:
1.457 + * KEApSortUidAscending: The sorting is done according to the ID of
1.458 + * the access points in ascending order.
1.459 + * KEApSortUidDescending: The sorting is done according to the ID of
1.460 + * the access points in descending order.
1.461 + * KEApSortNameAscending: The sorting is done according to the name of
1.462 + * the access points in ascending order.
1.463 + * KEApSortNameDescending: The sorting is done according to the name of
1.464 + * the access points in descending order.
1.465 + * Caution! The ordering values can not be combined!
1.466 + * @param aDb A database to work on
1.467 + * @param aStartWithSelection A boolean value indicating whether to
1.468 + * select or edit an ap.
1.469 + * @param aListType A TSelectionListType enum indicating the desired
1.470 + * list type.
1.471 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.472 + * menu type.
1.473 + * @param aIspTypeFilter Filtering criteria on ISP type
1.474 + * @param aBearerFilter Filtering criteria on bearer type
1.475 + * @param aSortType Specifies the sort order to use.
1.476 + * @param aReqIpvType Specifies whether the caller would like to
1.477 + * have IPv4, IPv6 or both access points. If it is IPv6 or Both,
1.478 + * in case of IPv6 support is available as a feature, it will be
1.479 + * supported. If IPv6 feature is not supported by the phone, it
1.480 + * simply defaults to the normal IPv4 version.
1.481 + * If it is IPv4, it uses the default IPv4 version independently
1.482 + * from IPv6 feature beeing available or not.
1.483 + * @return The constructed CApSettingsHandler object.
1.484 + *
1.485 + * @deprecated
1.486 + */
1.487 + IMPORT_C static CApSettingsHandler* NewLC(
1.488 + CActiveApDb& aDb,
1.489 + TBool aStartWithSelection,
1.490 + TSelectionListType aListType,
1.491 + TSelectionMenuType aSelMenuType,
1.492 + TInt aIspFilter,
1.493 + TInt aBearerFilter,
1.494 + TInt aSortType,
1.495 + TInt aReqIpvType
1.496 + );
1.497 +
1.498 +
1.499 +
1.500 +
1.501 + /**
1.502 + * Two-phased constructor. Leaves on failure.
1.503 + * This function shall be used to create the access point
1.504 + * settings/selection handling UI object.It is customizable through the
1.505 + * parameters. This object is a small layer above the UI part and
1.506 + * it provides a standard interface to select, edit, create access
1.507 + * points. It has two main parts, Select and Edit. The first parameter,
1.508 + * aStartWithSelection gives whether we would like to select or edit.
1.509 + * In case of selection, there is the possibility to use this module in
1.510 + * many applications. For this, two layouts are implemented, one is
1.511 + * list pane used by General Settings which provides the list in a
1.512 + * list-pane. The other layout is for the other applications requiring
1.513 + * access point selection, a popup-list style as the decision was that
1.514 + * General Settings will use list-pane and all other apps. popup-list
1.515 + * style. It is the caller who selects the style so if spec. says
1.516 + * otherwise, this module still can be used.
1.517 + * It is also possible to start the UI without selection, so if any
1.518 + * module has a 'linked/default/etc.' access point and stored it's UID,
1.519 + * the module can simply call the editor part of the UI without having
1.520 + * to select the AP once more.
1.521 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.522 + * construction parameters are ignored and after construction caller
1.523 + * can simply call RunSettingsL(..).
1.524 + * In case of selection, a lot of other parameters can be specified to
1.525 + * fulfil all requirements. There are three types of Options menu
1.526 + * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly,
1.527 + * EApSettingsSelMenuSelectNormal.
1.528 + * <br>
1.529 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,
1.530 + * delete, create, etc.
1.531 + * <br>
1.532 + * -EApSettingsSelMenuNormal:Options menu specified in General Settings,
1.533 + * contains Edit, Delete, Create new, etc. menu items.
1.534 + * <br>
1.535 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.536 + * BUT the first item is Select. This one makes it possible to select
1.537 + * an access point and also possible to edit, create, delete, etc.
1.538 + * <br>
1.539 + * The following three parameters specify the filtering and ordering
1.540 + * criteria for the selection list creation. First, it is possible to
1.541 + * specify which ISP-type we are looking for. The possible values are:
1.542 + * <br>
1.543 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.544 + * capable of only internet access.
1.545 + * <br>
1.546 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.547 + * capable of only WAP access.
1.548 + * <br>
1.549 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.550 + * capable of internet AND WAP access.
1.551 + * <br>
1.552 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.553 + * capable of WAP access AND contain mandatory WAP settings.
1.554 + * <br>
1.555 + * KEApIspTypeAll: No filtering is done for the isp-type, all types of
1.556 + * access points are shown.
1.557 + * <br>
1.558 + * It is possible to combine them by simply adding/or-ing together the
1.559 + * values, filtering will be done in such a way that only access points
1.560 + * with the listed ISP-types will be shown.
1.561 + * Second filtering possibility (aBearerFilter) is the desired bearer
1.562 + * type. The possible values are the values of the TApBearerType enum
1.563 + * type and their combinations, as in case of the ISP type.
1.564 + * The ordering of the list can be specified with the aSortType
1.565 + * parameter. It can have the following values:
1.566 + * KEApSortUidAscending: The sorting is done according to the ID of
1.567 + * the access points in ascending order.
1.568 + * KEApSortUidDescending: The sorting is done according to the ID of
1.569 + * the access points in descending order.
1.570 + * KEApSortNameAscending: The sorting is done according to the name of
1.571 + * the access points in ascending order.
1.572 + * KEApSortNameDescending: The sorting is done according to the name of
1.573 + * the access points in descending order.
1.574 + * Caution! The ordering values can not be combined!
1.575 + * @param aStartWithSelection A boolean value indicating whether to
1.576 + * select or edit an ap.
1.577 + * @param aListType A TSelectionListType enum indicating the desired
1.578 + * list type.
1.579 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.580 + * menu type.
1.581 + * @param aIspTypeFilter Filtering criteria on ISP type
1.582 + * @param aBearerFilter Filtering criteria on bearer type
1.583 + * @param aSortType Specifies the sort order to use.
1.584 + * @param aReqIpvType Specifies whether the caller would like to
1.585 + * have IPv4, IPv6 or both access points. If it is IPv6 or Both,
1.586 + * in case of IPv6 support is available as a feature, it will be
1.587 + * supported. If IPv6 feature is not supported by the phone, it
1.588 + * simply defaults to the normal IPv4 version.
1.589 + * If it is IPv4, it uses the default IPv4 version independently
1.590 + * from IPv6 feature beeing available or not.
1.591 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.592 + * additional VPN filtering.
1.593 + * @return The constructed CApSettingsHandler object.
1.594 + *
1.595 + * @deprecated
1.596 + */
1.597 + IMPORT_C static CApSettingsHandler* NewLC(
1.598 + TBool aStartWithSelection,
1.599 + TSelectionListType aListType,
1.600 + TSelectionMenuType aSelMenuType,
1.601 + TInt aIspFilter,
1.602 + TInt aBearerFilter,
1.603 + TInt aSortType,
1.604 + TInt aReqIpvType,
1.605 + TVpnFilterType aVpnFilterType
1.606 + );
1.607 +
1.608 +
1.609 +
1.610 + /**
1.611 + * Two-phased constructor. Leaves on failure.
1.612 + * This function shall be used to create the access point
1.613 + * settings/selection handling UI object. It is customizable through
1.614 + * the parameters. This object is a small layer above the UI part and
1.615 + * it provides a standard interface to select, edit, create access
1.616 + * points. It has two main parts, Select and Edit. The first parameter,
1.617 + * aStartWithSelection gives whether we would like to select or edit.
1.618 + * In case of selection, there is the possibility to use this module in
1.619 + * many applications. For this, two layouts are implemented, one is list
1.620 + * pane used by General Settings which provides the list in a list-pane.
1.621 + * The other layout is for the other applications requiring access point
1.622 + * selection, a popup-list style as the decision was that General
1.623 + * Settings will use list-pane and all other apps. popup-list style.
1.624 + * It is the caller who selects the style so if spec. says otherwise,
1.625 + * this module still can be used. It is also possible to start the UI
1.626 + * without selection, so if any module has a 'linked/default/etc.'
1.627 + * access point and stored it's UID, the module can simply call the
1.628 + * editor part of the UI without having to select the AP once more.
1.629 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.630 + * construction parameters are ignored and after construction caller can
1.631 + * simply call RunSettingsL(..). In case of selection, a lot of other
1.632 + * parameters can be specified to fulfil all requirements. There are
1.633 + * three types of Options menu available: EApSettingsSelMenuNormal,
1.634 + * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.
1.635 + * <br>
1.636 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,
1.637 + * delete, create, etc.
1.638 + * <br>
1.639 + * -EApSettingsSelMenuNormal:Options menu specified in General Settings,
1.640 + * contains Edit, Delete, Create new, etc. menu items.
1.641 + * <br>
1.642 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.643 + * BUT the first item is Select. This one makes it possible to select
1.644 + * an access point and also possible to edit, create, delete, etc.
1.645 + * <br>
1.646 + * The following three parameters specify the filtering and ordering
1.647 + * criteria for the selection list creation. First, it is possible to
1.648 + * specify which ISP-type we are looking for. The possible values are:
1.649 + * <br>
1.650 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.651 + * capable of only internet access.
1.652 + * <br>
1.653 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.654 + * capable of only WAP access.
1.655 + * <br>
1.656 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.657 + * capable of internet AND WAP access.
1.658 + * <br>
1.659 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.660 + * capable of WAP access AND contain mandatory WAP settings.
1.661 + * <br>
1.662 + * KEApIspTypeAll: No filtering is done for the isp-type, all types of
1.663 + * access points are shown.
1.664 + * <br>
1.665 + * It is possible to combine them by simply adding/or-ing together the
1.666 + * values, filtering will be done in such a way that only access points
1.667 + * with the listed ISP-types will be shown. Second filtering possibility
1.668 + * (aBearerFilter) is the desired bearer type. The possible values are
1.669 + * the values of the TApBearerType enum type and their combinations, as
1.670 + * in case of the ISP type. The ordering of the list can be specified
1.671 + * with the aSortType parameter. It can have the following values:
1.672 + * KEApSortUidAscending: The sorting is done according to the ID of
1.673 + * the access points in ascending order.
1.674 + * KEApSortUidDescending: The sorting is done according to the ID of
1.675 + * the access points in descending order.
1.676 + * KEApSortNameAscending: The sorting is done according to the name of
1.677 + * the access points in ascending order.
1.678 + * KEApSortNameDescending: The sorting is done according to the name of
1.679 + * the access points in descending order.
1.680 + * Caution! The ordering values can not be combined!
1.681 + * @param aDb A database to work on
1.682 + * @param aStartWithSelection A boolean value indicating whether to
1.683 + * select or edit an ap.
1.684 + * @param aListType A TSelectionListType enum indicating the desired
1.685 + * list type.
1.686 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.687 + * menu type.
1.688 + * @param aIspTypeFilter Filtering criteria on ISP type
1.689 + * @param aBearerFilter Filtering criteria on bearer type
1.690 + * @param aSortType Specifies the sort order to use.
1.691 + * @param aReqIpvType Specifies whether the caller would like to
1.692 + * have IPv4, IPv6 or both access points. If it is IPv6 or Both,
1.693 + * in case of IPv6 support is available as a feature, it will be
1.694 + * supported. If IPv6 feature is not supported by the phone, it
1.695 + * simply defaults to the normal IPv4 version.
1.696 + * If it is IPv4, it uses the default IPv4 version independently
1.697 + * from IPv6 feature beeing available or not.
1.698 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.699 + * additional VPN filtering.
1.700 + * @return The constructed CApSettingsHandler object.
1.701 + *
1.702 + * @deprecated
1.703 + */
1.704 + IMPORT_C static CApSettingsHandler* NewLC(
1.705 + CActiveApDb& aDb,
1.706 + TBool aStartWithSelection,
1.707 + TSelectionListType aListType,
1.708 + TSelectionMenuType aSelMenuType,
1.709 + TInt aIspFilter,
1.710 + TInt aBearerFilter,
1.711 + TInt aSortType,
1.712 + TInt aReqIpvType,
1.713 + TVpnFilterType aVpnFilterType
1.714 + );
1.715 +
1.716 +
1.717 +
1.718 +
1.719 +
1.720 + /**
1.721 + * Two-phased constructor. Leaves on failure.
1.722 + * This function shall be used to create the access point
1.723 + * settings/selection handling UI object. It is customizable through
1.724 + * the parameters. This object is a small layer above the UI part and
1.725 + * it provides a standard interface to select, edit, create access
1.726 + * points. It has two main parts, Select and Edit. The first parameter,
1.727 + * aStartWithSelection gives whether we would like to select or edit.
1.728 + * In case of selection, there is the possibility to use this module in
1.729 + * many applications. For this, two layouts are implemented, one is list
1.730 + * pane used by General Settings which provides the list in a list-pane.
1.731 + * The other layout is for the other applications requiring access point
1.732 + * selection, a popup-list style as the decision was that General
1.733 + * Settings will use list-pane and all other apps. popup-list style.
1.734 + * It is the caller who selects the style so if spec. says otherwise,
1.735 + * this module still can be used. It is also possible to start the UI
1.736 + * without selection, so if any module has a 'linked/default/etc.'
1.737 + * access point and stored it's UID, the module can simply call the
1.738 + * editor part of the UI without having to select the AP once more.
1.739 + * In case of editing only, (aStartWithSelection is EFalse), all other
1.740 + * construction parameters are ignored and after construction caller can
1.741 + * simply call RunSettingsL(..). In case of selection, a lot of other
1.742 + * parameters can be specified to fulfil all requirements. There are
1.743 + * three types of Options menu available: EApSettingsSelMenuNormal,
1.744 + * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.
1.745 + * <br>
1.746 + *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,
1.747 + * delete, create, etc.
1.748 + * <br>
1.749 + * -EApSettingsSelMenuNormal:Options menu specified in General Settings,
1.750 + * contains Edit, Delete, Create new, etc. menu items.
1.751 + * <br>
1.752 + * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal
1.753 + * BUT the first item is Select. This one makes it possible to select
1.754 + * an access point and also possible to edit, create, delete, etc.
1.755 + * <br>
1.756 + * The following three parameters specify the filtering and ordering
1.757 + * criteria for the selection list creation. First, it is possible to
1.758 + * specify which ISP-type we are looking for. The possible values are:
1.759 + * <br>
1.760 + * KEApIspTypeInternetOnly: Filter allows only access points that are
1.761 + * capable of only internet access.
1.762 + * <br>
1.763 + * KEApIspTypeWAPOnly: Filter allows only access points that are
1.764 + * capable of only WAP access.
1.765 + * <br>
1.766 + * KEApIspTypeInternetAndWAP: Filter allows only access points that are
1.767 + * capable of internet AND WAP access.
1.768 + * <br>
1.769 + * KEApIspTypeWAPMandatory: Filter allows only access points that are
1.770 + * capable of WAP access AND contain mandatory WAP settings.
1.771 + * <br>
1.772 + * KEApIspTypeAll: No filtering is done for the isp-type, all types of
1.773 + * access points are shown.
1.774 + * <br>
1.775 + * It is possible to combine them by simply adding/or-ing together the
1.776 + * values, filtering will be done in such a way that only access points
1.777 + * with the listed ISP-types will be shown. Second filtering possibility
1.778 + * (aBearerFilter) is the desired bearer type. The possible values are
1.779 + * the values of the TApBearerType enum type and their combinations, as
1.780 + * in case of the ISP type. The ordering of the list can be specified
1.781 + * with the aSortType parameter. It can have the following values:
1.782 + * KEApSortUidAscending: The sorting is done according to the ID of
1.783 + * the access points in ascending order.
1.784 + * KEApSortUidDescending: The sorting is done according to the ID of
1.785 + * the access points in descending order.
1.786 + * KEApSortNameAscending: The sorting is done according to the name of
1.787 + * the access points in ascending order.
1.788 + * KEApSortNameDescending: The sorting is done according to the name of
1.789 + * the access points in descending order.
1.790 + * Caution! The ordering values can not be combined!
1.791 + * @param aDb A database to work on
1.792 + * @param aStartWithSelection A boolean value indicating whether to
1.793 + * select or edit an ap.
1.794 + * @param aListType A TSelectionListType enum indicating the desired
1.795 + * list type.
1.796 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.797 + * menu type.
1.798 + * @param aIspTypeFilter Filtering criteria on ISP type
1.799 + * @param aBearerFilter Filtering criteria on bearer type
1.800 + * @param aSortType Specifies the sort order to use.
1.801 + * @param aReqIpvType Specifies whether the caller would like to
1.802 + * have IPv4, IPv6 or both access points. If it is IPv6 or Both,
1.803 + * in case of IPv6 support is available as a feature, it will be
1.804 + * supported. If IPv6 feature is not supported by the phone, it
1.805 + * simply defaults to the normal IPv4 version.
1.806 + * If it is IPv4, it uses the default IPv4 version independently
1.807 + * from IPv6 feature beeing available or not.
1.808 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.809 + * additional VPN filtering.
1.810 + * @param aIncludeEasyWlan a TBool indicating whether it should
1.811 + * include the easy wlan AP in the list or not.
1.812 + * @return The constructed CApSettingsHandler object.
1.813 + *
1.814 + * @deprecated
1.815 + */
1.816 + IMPORT_C static CApSettingsHandler* NewLC(
1.817 + CActiveApDb& aDb,
1.818 + TBool aStartWithSelection,
1.819 + TSelectionListType aListType,
1.820 + TSelectionMenuType aSelMenuType,
1.821 + TInt aIspFilter,
1.822 + TInt aBearerFilter,
1.823 + TInt aSortType,
1.824 + TInt aReqIpvType,
1.825 + TVpnFilterType aVpnFilterType,
1.826 + TBool aIncludeEasyWlan
1.827 + );
1.828 +
1.829 +
1.830 +
1.831 +
1.832 + /**
1.833 + * Destructor.
1.834 + *
1.835 + * @deprecated
1.836 + */
1.837 + IMPORT_C ~CApSettingsHandler();
1.838 +
1.839 +
1.840 + protected:
1.841 + /**
1.842 + * Constructor.
1.843 + * @param aStartWithSelection A boolean value indicating whether to
1.844 + * select or edit an ap.
1.845 + * @param aListType A TSelectionListType enum indicating the desired
1.846 + * list type.
1.847 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.848 + * menu type.
1.849 + *
1.850 + * @deprecated
1.851 + */
1.852 + IMPORT_C CApSettingsHandler(
1.853 + TBool aStartWithSelection,
1.854 + TSelectionListType aListType,
1.855 + TSelectionMenuType aSelMenuType
1.856 + );
1.857 +
1.858 + /**
1.859 + * Constructor.
1.860 + * @param aStartWithSelection A boolean value indicating whether to
1.861 + * select or edit an ap.
1.862 + * @param aListType A TSelectionListType enum indicating the desired
1.863 + * list type.
1.864 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.865 + * menu type.
1.866 + * @param aHelpMajor Major help ID
1.867 + *
1.868 + * @deprecated
1.869 + */
1.870 + IMPORT_C CApSettingsHandler(
1.871 + TBool aStartWithSelection,
1.872 + TSelectionListType aListType,
1.873 + TSelectionMenuType aSelMenuType,
1.874 + TUid aHelpMajor
1.875 + );
1.876 +
1.877 +
1.878 + /**
1.879 + * Constructor.
1.880 + * @param aStartWithSelection A boolean value indicating whether to
1.881 + * select or edit an ap.
1.882 + * @param aListType A TSelectionListType enum indicating the desired
1.883 + * list type.
1.884 + * @param aSelMenuType A TSelectionMenuType enum indicating the desired
1.885 + * menu type.
1.886 + * @param aNeedIpv6Support Whether IPv6 is supported or not
1.887 + */
1.888 + CApSettingsHandler(
1.889 + TBool aStartWithSelection,
1.890 + TSelectionListType aListType,
1.891 + TSelectionMenuType aSelMenuType,
1.892 + TBool aNeedIpv6Support
1.893 + );
1.894 +
1.895 +
1.896 +
1.897 + /**
1.898 + * Second-phase constructor.
1.899 + * @param aIspTypeFilter Filtering criteria on ISP type
1.900 + * @param aBearerFilter Filtering criteria on bearer type
1.901 + * @param aSortType Specifies the sort order to use.
1.902 + *
1.903 + * @deprecated
1.904 + */
1.905 + IMPORT_C void ConstructL(
1.906 + TInt aIspFilter,
1.907 + TInt aBearerFilter,
1.908 + TInt aSortType
1.909 + );
1.910 +
1.911 +
1.912 + /**
1.913 + * Second-phase constructor.
1.914 + * @param aDb A database to work on
1.915 + * @param aIspTypeFilter Filtering criteria on ISP type
1.916 + * @param aBearerFilter Filtering criteria on bearer type
1.917 + * @param aSortType Specifies the sort order to use.
1.918 + *
1.919 + * @deprecated
1.920 + */
1.921 + IMPORT_C void ConstructL(
1.922 + CActiveApDb& aDb,
1.923 + TInt aIspFilter,
1.924 + TInt aBearerFilter,
1.925 + TInt aSortType
1.926 + );
1.927 +
1.928 +
1.929 + /**
1.930 + * Second-phase constructor.
1.931 + * @param aIspTypeFilter Filtering criteria on ISP type
1.932 + * @param aBearerFilter Filtering criteria on bearer type
1.933 + * @param aSortType Specifies the sort order to use.
1.934 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.935 + * additional VPN filtering.
1.936 + *
1.937 + * @deprecated
1.938 + */
1.939 + IMPORT_C void ConstructL(
1.940 + TInt aIspFilter,
1.941 + TInt aBearerFilter,
1.942 + TInt aSortType,
1.943 + TVpnFilterType aVpnFilterType
1.944 + );
1.945 +
1.946 +
1.947 + /**
1.948 + * Second-phase constructor.
1.949 + * @param aDb A database to work on
1.950 + * @param aIspTypeFilter Filtering criteria on ISP type
1.951 + * @param aBearerFilter Filtering criteria on bearer type
1.952 + * @param aSortType Specifies the sort order to use.
1.953 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.954 + * additional VPN filtering.
1.955 + *
1.956 + * @deprecated
1.957 + */
1.958 + IMPORT_C void ConstructL(
1.959 + CActiveApDb& aDb,
1.960 + TInt aIspFilter,
1.961 + TInt aBearerFilter,
1.962 + TInt aSortType,
1.963 + TVpnFilterType aVpnFilterType
1.964 + );
1.965 +
1.966 +
1.967 +
1.968 +
1.969 + /**
1.970 + * Second-phase constructor.
1.971 + * @param aDb A database to work on
1.972 + * @param aIspTypeFilter Filtering criteria on ISP type
1.973 + * @param aBearerFilter Filtering criteria on bearer type
1.974 + * @param aSortType Specifies the sort order to use.
1.975 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.976 + * additional VPN filtering.
1.977 + * @param aIncludeEasyWlan a TBool indicating whether it should
1.978 + * include the easy wlan AP in the list or not.
1.979 + *
1.980 + * @deprecated
1.981 + */
1.982 + IMPORT_C void ConstructL(
1.983 + CActiveApDb& aDb,
1.984 + TInt aIspFilter,
1.985 + TInt aBearerFilter,
1.986 + TInt aSortType,
1.987 + TVpnFilterType aVpnFilterType,
1.988 + TBool aIncludeEasyWlan
1.989 + );
1.990 +
1.991 +
1.992 + public: // New functions
1.993 + /**
1.994 + * Sets the filtering used in the access point selection.
1.995 + * @param aIspTypeFilter Filtering criteria on ISP type
1.996 + * @param aBearerFilter Filtering criteria on bearer type
1.997 + * @param aSortType Specifies the sort order to use.
1.998 + * @return No return value. Leaves on error.
1.999 + *
1.1000 + * @deprecated
1.1001 + */
1.1002 + IMPORT_C void SetFilterL(
1.1003 + TInt aIspFilter,
1.1004 + TInt aBearerFilter,
1.1005 + TInt aSortType
1.1006 + );
1.1007 +
1.1008 +
1.1009 + /**
1.1010 + * Sets possible overrides of some texts.
1.1011 + * By default, text is read from resources. This provides a way to
1.1012 + * change some of the text to a caller-supplied one. The text must
1.1013 + * be read from resource and must be already localized.
1.1014 + * More than one text can be substituted, they are stored internally
1.1015 + * in an array.
1.1016 + * Currently not supported and supporting it is under discussion.
1.1017 + * @param aText2Change TTextID to identify the text to be replaced with
1.1018 + * @param aNewText Reference to the substitute text.
1.1019 + *
1.1020 + * @deprecated
1.1021 + */
1.1022 + IMPORT_C void SetTextOverrideL( TTextID aText2Change,
1.1023 + const TDesC& aNewText );
1.1024 +
1.1025 +
1.1026 + /**
1.1027 + * Gets possible overrides of a text.
1.1028 + * By default, text is read from resources. This provides a way to
1.1029 + * change some of the text to a caller-supplied one. The text must
1.1030 + * be read from resource and must be already localized.
1.1031 + * More than one text can be substituted, they are stored internally
1.1032 + * in an array.
1.1033 + * Currently not supported and supporting it is under discussion
1.1034 + * @param aTextID TTextID type to identify the text to be replaced with
1.1035 + * @return Reference to the substitute text.
1.1036 + *
1.1037 + * @deprecated
1.1038 + */
1.1039 + IMPORT_C const TDesC& TextOverrideL( TTextID aTextId );
1.1040 +
1.1041 +
1.1042 + /**
1.1043 + * Starts the settings component.
1.1044 + * Creates dialog(s) from scratch, launches and executes them.
1.1045 + * Can leave with error codes.
1.1046 + * @param TUint32 aHighlight The UID of the AP to highlight by default
1.1047 + * @param TUint32 aSelected The UID of the access point selected
1.1048 + * by the user.
1.1049 + * @return The accomplished task's flag-codes:
1.1050 + * <br>
1.1051 + * KApUiEventNone,
1.1052 + * <br>
1.1053 + * KApUiEventSelected,
1.1054 + * <br>
1.1055 + * KApUiEventCreatedBlank,
1.1056 + * <br>
1.1057 + * KApUiEventCreatedUsedOld,
1.1058 + * <br>
1.1059 + * KApUiEventEdited,
1.1060 + * <br>
1.1061 + * KApUiEventDeleted,
1.1062 + * <br>
1.1063 + * KApUiEventExitRequested
1.1064 + * <br>and their combinations. ( Bitwise OR )
1.1065 + * <br>
1.1066 + * aSelected will be modified only if KApUiEventSelected is included
1.1067 + * in the flags.
1.1068 + * <br>
1.1069 + * In case it returns KApUiEventExitRequested, the user had choosen
1.1070 + * the Exit option from the Options menu which means
1.1071 + * that the caller application MUST exit!
1.1072 + * <br>
1.1073 + * Returns after completion!
1.1074 + *
1.1075 + * @deprecated
1.1076 + */
1.1077 + IMPORT_C TInt RunSettingsL( TUint32 aHighLight, TUint32& aSelected );
1.1078 +
1.1079 +
1.1080 + /**
1.1081 + * Component Validation Test.
1.1082 + * @return KErrNone.
1.1083 + *
1.1084 + * @deprecated
1.1085 + */
1.1086 + IMPORT_C static TInt Cvt();
1.1087 +
1.1088 +
1.1089 + protected: // New functions
1.1090 + /**
1.1091 + * @Deprecated
1.1092 + * Starts the settings component.
1.1093 + * Creates dialog(s) from scratch, launches and executes them.
1.1094 + * In case of error, leaves with error codes.
1.1095 + * @param TUint32 aHighlight The UID of the AP to highlight by default
1.1096 + * @param TUint32 aSelected The UID of the AP selected by the user
1.1097 + * @return The accomplished task's flag-codes:
1.1098 + * <br>
1.1099 + * KApUiEventNone,
1.1100 + * <br>
1.1101 + * KApUiEventSelected,
1.1102 + * <br>
1.1103 + * KApUiEventCreatedBlank,
1.1104 + * <br>
1.1105 + * KApUiEventCreatedUsedOld,
1.1106 + * <br>
1.1107 + * KApUiEventEdited,
1.1108 + * <br>
1.1109 + * KApUiEventDeleted
1.1110 + * <br>
1.1111 + * and their combinations. ( Bitwise OR )
1.1112 + * <br>
1.1113 + * aSelected will be modified only if KApUiEventSelected is included
1.1114 + * in the flags.
1.1115 + * <br>
1.1116 + * Returns after completion!
1.1117 + */
1.1118 + TInt DoRunSettingsL( TUint32 aHighLight, TUint32& aSelected );
1.1119 +
1.1120 +
1.1121 + /**
1.1122 + * Starts the viewer component.
1.1123 + * Creates dialog(s) from scratch, launches and executes it.
1.1124 + * In case of error, leaves with error codes.
1.1125 + * @param TUint32 aUid The UID of the AP to view/edit
1.1126 + * @return Returns the completed task's flags
1.1127 + * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank,
1.1128 + * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted,
1.1129 + * KApUiEventExitRequested and their combinations. ( Bitwise OR )
1.1130 + * In case it returns KApUiEventExitRequested, the user had choosen
1.1131 + * the Exit option from the Options menu which means
1.1132 + * that the caller application MUST exit!
1.1133 + * <br>
1.1134 + * Returns after completion!
1.1135 + *
1.1136 + * @deprecated
1.1137 + */
1.1138 + IMPORT_C TInt RunViewerL( TUint32 aUid );
1.1139 +
1.1140 +
1.1141 + /**
1.1142 + * @Deprecated
1.1143 + * Starts the viewer component.
1.1144 + * Creates dialog(s) from scratch, launches and executes it.
1.1145 + * In case of error, leaves with error codes.
1.1146 + * @param TUint32 aUid The UID of the AP to view/edit
1.1147 + * @return Returns the completed task's flags
1.1148 + * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank,
1.1149 + * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted,
1.1150 + * KApUiEventExitRequested and their combinations. ( Bitwise OR )
1.1151 + * Returns after completion!
1.1152 + */
1.1153 + TInt DoRunViewerL( TUint32 aUid );
1.1154 +
1.1155 +
1.1156 + // handles the Delete access Point command.
1.1157 + // @Deprecated
1.1158 + void HandleApDeleteCmdL( TUint32 aUid, TBool aIsLast );
1.1159 +
1.1160 +
1.1161 + // handles the Create blank new access Point command.
1.1162 + // @Deprecated
1.1163 + TUint32 HandleApBlankNewL( TInt aBearers, TInt aIsps );
1.1164 +
1.1165 +
1.1166 + // handles the Create new access Point by using existing one command.
1.1167 + // @Deprecated
1.1168 + TUint32 HandleApUseOldNewL();
1.1169 +
1.1170 +
1.1171 + // handles the Editing of the newly created access Point.
1.1172 + // @Deprecated
1.1173 + TUint32 EditAfterCreateL( TUint32 aUid,
1.1174 + CApAccessPointItem* aItem = NULL );
1.1175 +
1.1176 +
1.1177 + /**
1.1178 + * Second-phase internal constructor.
1.1179 + * @param aDb A database to work on
1.1180 + * @param aIspTypeFilter Filtering criteria on ISP type
1.1181 + * @param aBearerFilter Filtering criteria on bearer type
1.1182 + * @param aSortType Specifies the sort order to use.
1.1183 + * @param aVpnFilterType a TVpnFilterType representing the possible
1.1184 + * additional VPN filtering.
1.1185 + * @param aIncludeEasyWlan a TBool indicating whether it should
1.1186 + * include the easy wlan AP in the list or not.
1.1187 + */
1.1188 + void DoConstructL( CActiveApDb* aDb, TInt aIspFilter,
1.1189 + TInt aBearerFilter, TInt aSortType,
1.1190 + TVpnFilterType aVpnFilterType,
1.1191 + TBool aIncludeEasyWlan );
1.1192 +
1.1193 +
1.1194 + /**
1.1195 + * @Deprecated
1.1196 + * Starts the selector component as a list
1.1197 + * Creates dialog(s) from scratch, launches and executes them.
1.1198 + * In case of error, leaves with error codes.
1.1199 + * @param TUint32 aHighlight The UID of the AP to highlight by default
1.1200 + * @param TUint32 aSelected The UID of the AP selected by the user
1.1201 + * @return The accomplished task's flag-codes:
1.1202 + * <br>
1.1203 + * KApUiEventNone,
1.1204 + * <br>
1.1205 + * KApUiEventSelected,
1.1206 + * <br>
1.1207 + * KApUiEventCreatedBlank,
1.1208 + * <br>
1.1209 + * KApUiEventCreatedUsedOld,
1.1210 + * <br>
1.1211 + * KApUiEventEdited,
1.1212 + * <br>
1.1213 + * KApUiEventDeleted
1.1214 + * <br>
1.1215 + * and their combinations. ( Bitwise OR )
1.1216 + * <br>
1.1217 + * aSelected will be modified only if KApUiEventSelected is included
1.1218 + * in the flags.
1.1219 + * <br>
1.1220 + * Returns after completion!
1.1221 + */
1.1222 + void DoRunListSettingsL( TUint32 aHighLight, TUint32& aSelected );
1.1223 +
1.1224 +
1.1225 + /**
1.1226 + * @Deprecated
1.1227 + * Starts the selector component in a setting page
1.1228 + * Creates dialog(s) from scratch, launches and executes them.
1.1229 + * In case of error, leaves with error codes.
1.1230 + * @param TUint32 aHighlight The UID of the AP to highlight by default
1.1231 + * @param TUint32 aSelected The UID of the AP selected by the user
1.1232 + * @return The accomplished task's flag-codes:
1.1233 + * <br>
1.1234 + * KApUiEventNone,
1.1235 + * <br>
1.1236 + * KApUiEventSelected,
1.1237 + * <br>
1.1238 + * KApUiEventCreatedBlank,
1.1239 + * <br>
1.1240 + * KApUiEventCreatedUsedOld,
1.1241 + * <br>
1.1242 + * KApUiEventEdited,
1.1243 + * <br>
1.1244 + * KApUiEventDeleted
1.1245 + * <br>
1.1246 + * and their combinations. ( Bitwise OR )
1.1247 + * <br>
1.1248 + * aSelected will be modified only if KApUiEventSelected is included
1.1249 + * in the flags.
1.1250 + * <br>
1.1251 + * Returns after completion!
1.1252 + */
1.1253 + void DoRunSetPageSettingsL( TUint32 aHighLight, TUint32& aSelected );
1.1254 +
1.1255 +
1.1256 + /**
1.1257 + * @Deprecated
1.1258 + * handles the Create new access Point by using existing one command.
1.1259 + * Called after user has selected the AP to copy
1.1260 + * Creates the new Ap and offers it for editing.
1.1261 + * @param aSelected The UID of the AP to copy. Shall not be KErrNone.
1.1262 + * @return The UID of the newly created Ap
1.1263 + */
1.1264 + TUint32 DoHandleApUseOldNewL( TUint32 aSelected );
1.1265 +
1.1266 + /**
1.1267 + * @Deprecated
1.1268 + * Selects the Ap to Copy, returns its UID.
1.1269 + * If not selected, KErrNone is returned
1.1270 + */
1.1271 + TUint32 SelectApToCopyL();
1.1272 +
1.1273 +
1.1274 + /**
1.1275 + * @Deprecated
1.1276 + * handles the Create blank new access Point command.
1.1277 + */
1.1278 + TUint32 DoHandleApBlankNewL( TInt aBearers, TInt aIsps );
1.1279 +
1.1280 +
1.1281 + /**
1.1282 + * @Deprecated
1.1283 + * handles the Delete network group command.
1.1284 + * @param aUid The uid of the network to delete
1.1285 + */
1.1286 + void HandleNetworkDeleteCmdL( TUint32 aUid );
1.1287 +
1.1288 +
1.1289 + /**
1.1290 + * @Deprecated
1.1291 + * Gets the local variant value
1.1292 + * @return A TInt stating the variant
1.1293 + */
1.1294 + TInt GetVariantL();
1.1295 +
1.1296 +
1.1297 + /**
1.1298 + * @Deprecated
1.1299 + * Gets confirmation about deleting an access point
1.1300 + * @param aUid A TUint32 holding the WAP access point ID of the
1.1301 + * access point to be deleted.
1.1302 + * @param aIsLast A TBool specifying whether the access point to be
1.1303 + * deleted is the last one or not.
1.1304 + * @return A TInt stating the result
1.1305 + */
1.1306 + TInt ConfirmDeleteL( TUint32 aUid, TBool aIsLast );
1.1307 +
1.1308 +
1.1309 + /**
1.1310 + * @Deprecated
1.1311 + * Wrapper for the public API
1.1312 + */
1.1313 + void HandleRunSettingsL( TUint32 aHighLight, TUint32& aSelected );
1.1314 +
1.1315 +
1.1316 + protected: // Functions from base classes
1.1317 +
1.1318 + friend class CApSettingsDlg;
1.1319 + friend class CApSelectorDialog;
1.1320 + friend class CApSelPopupList;
1.1321 + friend class CApNetSelPopupList;
1.1322 +
1.1323 + private:
1.1324 + /**
1.1325 + * @Deprecated
1.1326 + * Selects an appropriate bearer type for a given item according to
1.1327 + * the current filtering criterias
1.1328 + * @param aBearers The current bearer filter set
1.1329 + * @param aItem The CApAccessPointItem whoose bearer type is to be set.
1.1330 + */
1.1331 + void ChooseBearerTypeL( TInt aBearers, CApAccessPointItem& aItem );
1.1332 +
1.1333 + /**
1.1334 + * @Deprecated
1.1335 + * Duplciates an existing access point identified by the passed WAP ID
1.1336 + * @param aUid The WAP Access Point ID of the access point to duplicate
1.1337 + * @return The WAP Access Point ID of the newly created access point.
1.1338 + */
1.1339 + TUint32 HandleDuplicateL( TUint32 aUid );
1.1340 +
1.1341 +
1.1342 + private: //data
1.1343 + TBool iStartWithSelection;
1.1344 + TSelectionListType iListType;
1.1345 + TSelectionMenuType iSelMenuType;
1.1346 +
1.1347 + TInt iIspFilter;
1.1348 + TInt iBearerFilter;
1.1349 + TApSetHandlerExtra* iExt; // Extra data holder structure
1.1350 +
1.1351 + TInt iReqIpvType; // Default is IPv4
1.1352 +
1.1353 +// replacing iModel with iImpl, no size change
1.1354 +// CApSettingsModel* iModel;
1.1355 + CApSettingsHandlerImpl* iImpl; // owned
1.1356 +
1.1357 + CTextOverrides* iTextOverrides;
1.1358 + TUint32 iEventStore; // to hold the events
1.1359 + TUid iHelpMajor;
1.1360 +
1.1361 +#ifdef __TEST_OOMDEBUG
1.1362 + TBool iMemTestOn;
1.1363 +#endif // __TEST_OOMDEBUG
1.1364 +
1.1365 + };
1.1366 +
1.1367 +#endif
1.1368 +
1.1369 +// End of File