1 apsettingshandlerui.h

     1 /*

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

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description: 

    15 *     Declares the main handler, CApSettingsHandler and public API for the 

    16 *     Access Point settings.

    17 *

    18 */

    19 

    20 

    21 #ifndef APSETTINGS_HANDLER_H

    22 #define APSETTINGS_HANDLER_H

    23 

    24 // Deprecation warning

    25 #warning This header file has been deprecated. Will be removed in one of the next SDK releases.

    26  

    27  

    28 // INCLUDES

    29 #include <ApSettingsHandlerCommons.h>

    30 #include <ApEngineConsts.h>

    31 #include <ApSelect.h>

    32 

    33 // CONSTANTS

    34 const   TUid    KUidApSettingsHandler = { 0x10008d3B };

    35 

    36 typedef struct      ///< Extra data holder

    37     {

    38         TInt                iResOffset;

    39         TBool               iIsIpv6Supported;       // Default is NO 

    40         TBool               iIsFeatureManagerInitialised;

    41         TInt                iExtra;

    42         TInt                iSortType;

    43         TVpnFilterType      iVpnFilterType;

    44         TInt                iVariant;               /// Local variant value

    45         TBool               iIncludeEasyWlan;

    46     }TApSetHandlerExtra;

    47 

    48 // FORWARD DECLARATIONS

    49 class CActiveApDb;

    50 class CApSelector;

    51 class CApSettingsModel;

    52 class CApSettings;

    53 class CTextOverrides;

    54 class CApAccessPointItem;

    55 

    56 class CApSettingsHandlerImpl;

    57 

    58 // CLASS DECLARATION

    59 /**

    60 * CApSettingsHandler class: It is the main handler for the Access Point 

    61 * settings. It contains the only public API for other (sub)systems.

    62 *

    63 */

    64 class CApSettingsHandler : public CBase

    65     {

    66 

    67     public: // Constructors and destructor

    68 

    69 

    70         /**

    71         * Two-phased constructor. Leaves on failure.

    72         * This function shall be used to create the access point 

    73         * settings/selection handling UI object. It is customizable through 

    74         * the parameters. This object is a small layer above the UI part and

    75         * it provides a standard interface to select, edit, create access 

    76         * points. It has two main parts, Select and Edit. The first parameter,

    77         * aStartWithSelection gives whether we would like to select or edit.

    78         * In case of selection, there is the possibility to use this module in

    79         * many applications. For this, two layouts are implemented, 

    80         * one is list pane used by General Settings which provides the list in

    81         * a list-pane. The other layout is for the other applications 

    82         * requiring access point selection, a popup-list style as the decision

    83         * I know about was that General Settings will use list-pane and all

    84         * other apps. popup-list style. It is the caller who selects the style

    85         * so if spec. says otherwise, this module still can be used.

    86         * It is also possible to start the UI without selection, so if any 

    87         * module has a 'linked/default/etc.' access point and stored it's UID,

    88         * the module can simply call the editor part of the UI without having

    89         * to select the AP once more. In case of editing only, 

    90         * (aStartWithSelection is EFalse), all other construction parameters 

    91         * are ignored and after construction caller can simply call 

    92         * RunSettingsL(..). In case of selection, a lot of other parameters 

    93         * can be specified to fulfil all requirements. There are three types 

    94         * of Options menu available: 

    95         * EApSettingsSelMenuNormal, 

    96         * EApSettingsSelMenuSelectOnly,

    97         * EApSettingsSelMenuSelectNormal.

    98         * <br>

    99         *-EApSettingsSelMenuSelectOnly: Only Select is visible, 

   100         *                               no way to edit, delete, create, etc.

   101         * <br>

   102         * -EApSettingsSelMenuNormal:    Options menu specified in General 

   103         *                               Settings, contains Edit, Delete, 

   104         *                               Create new, etc. menu items.

   105         * <br>

   106         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal

   107         *                                BUT the first item is Select. 

   108         *                                This one makes it possible to select 

   109         *                                an access point and also possible to 

   110         *                                edit, create, delete, etc.

   111         * <br>

   112         * The following three parameters specify the filtering and ordering 

   113         * criteria for the selection list creation. First, it is possible to

   114         * specify which ISP-type we are looking for. The possible values are:

   115         * <br>

   116         * KEApIspTypeInternetOnly:  Filter allows only access points that are

   117         *                           capable of only internet access.

   118         * <br>

   119         * KEApIspTypeWAPOnly:       Filter allows only access points that are 

   120         *                           capable of only WAP access.

   121         * <br>

   122         * KEApIspTypeInternetAndWAP: Filter allows only access points that are

   123         *                           capable of internet AND WAP access.

   124         * <br>

   125         * KEApIspTypeWAPMandatory:  Filter allows only access points that are

   126         *                           capable of WAP access AND contain 

   127         *                           mandatory WAP settings.

   128         * <br>

   129         * KEApIspTypeAll:           No filtering is done for the isp-type,

   130         *                           all types of access points are shown.

   131         * <br>

   132         * It is possible to combine them by simply adding/or-ing together 

   133         * the values, filtering will be done in such a way that only access 

   134         * points with the listed ISP-types will be shown. Second filtering

   135         * possibility (aBearerFilter) is the desired bearer type. The possible

   136         * values are the values of the TApBearerType enum type and their 

   137         * combinations, as in case of the ISP type. The ordering of the list

   138         * can be specified with the aSortType parameter. It can have the

   139         * following values:

   140         * KEApSortUidAscending:     The sorting is done according to the ID 

   141         *                           of the access points in ascending order.

   142         * KEApSortUidDescending:    The sorting is done according to the ID 

   143         *                           of the access points in descending order.

   144         * KEApSortNameAscending:    The sorting is done according to the name

   145         *                           of the access points in ascending order.

   146         * KEApSortNameDescending:   The sorting is done according to the name

   147         *                           of the access points in descending order.

   148         * Caution! The ordering values can not be combined!

   149         * @param aStartWithSelection    A boolean value indicating whether to 

   150         *                               select or edit an ap.

   151         * @param aListType      A TSelectionListType enum indicating the 

   152         *                       desired list type.

   153         * @param aSelMenuType   A TSelectionMenuType enum indicating the 

   154         *                       desired menu type.

   155         * @param aIspTypeFilter Filtering criteria on ISP type

   156         * @param aBearerFilter Filtering criteria on bearer type

   157         * @param aSortType Specifies the sort order to use.

   158         * @return The constructed CApSettingsHandler object.

   159         *

   160         * @deprecated

   161         */

   162         IMPORT_C static CApSettingsHandler* NewLC(

   163                         TBool aStartWithSelection,

   164                         TSelectionListType aListType,

   165                         TSelectionMenuType aSelMenuType,

   166                         TInt aIspFilter,

   167                         TInt aBearerFilter,

   168                         TInt aSortType

   169                         );

   170 

   171 

   172 

   173         /**

   174         * Two-phased constructor. Leaves on failure.

   175         * This function shall be used to create the access point 

   176         * settings/selection handling UI object. It is customizable through 

   177         * the parameters. This object is a small layer above the UI part and

   178         * it provides a standard interface to select, edit, create 

   179         * access points. It has two main parts, Select and Edit. The first 

   180         * parameter, aStartWithSelection gives whether we would like to select

   181         * or edit. In case of selection, there is the possibility to use this 

   182         * module in many applications. For this, two layouts are implemented,

   183         * one is list pane used by General Settings which provides the list 

   184         * in a list-pane. The other layout is for the other applications 

   185         * requiring access point selection, a popup-list style as the 

   186         * decision I know about was that General Settings will use list-pane 

   187         * and all other apps. popup-list style. It is the caller who selects 

   188         * the style so if spec. says otherwise, this module still can be used.

   189         * It is also possible to start the UI without selection, so if any 

   190         * module has a 'linked/default/etc.' access point and stored it's UID,

   191         * the module can simply call the editor part of the UI without having

   192         * to select the AP once more.

   193         * In case of editing only, (aStartWithSelection is EFalse), all other 

   194         * construction parameters are ignored and after construction caller 

   195         * can simply call RunSettingsL(..).

   196         * In case of selection, a lot of other parameters can be specified 

   197         * to fulfil all requirements. There are three types of Options menu 

   198         * available: 

   199         * EApSettingsSelMenuNormal, 

   200         * EApSettingsSelMenuSelectOnly,

   201         * EApSettingsSelMenuSelectNormal.

   202         * <br>

   203         *-EApSettingsSelMenuSelectOnly:     Only Select is visible, no way to

   204         *                                   edit, delete, create, etc.

   205         * <br>

   206         * -EApSettingsSelMenuNormal:        Options menu specified in General 

   207         *                                   Settings, contains Edit, Delete, 

   208         *                                   Create new, etc. menu items.

   209         * <br>

   210         * -EApSettingsSelMenuSelectNormal:  Same as in EApSettingsSelMenuNormal

   211         *                                   BUT the first item is Select. 

   212         *                                   This one makes it possible to 

   213         *                                   select an access point and also 

   214         *                                   possible to edit, create, 

   215         *                                   delete, etc.

   216         * <br>

   217         * The following three parameters specify the filtering and ordering 

   218         * criteria for the selection list creation. First, it is possible to 

   219         * specify which ISP-type we are looking for. The possible values are:

   220         * <br>

   221         * KEApIspTypeInternetOnly:      Filter allows only access points that

   222         *                               are capable of only internet access.

   223         * <br>

   224         * KEApIspTypeWAPOnly:           Filter allows only access points that 

   225         *                               are capable of only WAP access.

   226         * <br>

   227         * KEApIspTypeInternetAndWAP:    Filter allows only access points that

   228         *                               are capable of internet AND WAP access.

   229         * <br>

   230         * KEApIspTypeWAPMandatory:      Filter allows only access points that

   231         *                               are capable of WAP access AND contain

   232         *                               mandatory WAP settings.

   233         * <br>

   234         * KEApIspTypeAll:               No filtering is done for the isp-type,

   235         *                               all types of access points are shown.

   236         * <br>

   237         * It is possible to combine them by simply adding/or-ing together the

   238         * values, filtering will be done in such a way that only access points

   239         * with the listed ISP-types will be shown.

   240         * Second filtering possibility (aBearerFilter) is the desired bearer 

   241         * type. The possible values are the values of the TApBearerType enum 

   242         * type and their combinations, as in case of the ISP type.

   243         * The ordering of the list can be specified with the aSortType 

   244         * parameter. It can have the following values:

   245         * KEApSortUidAscending:     The sorting is done according to the ID

   246         *                           of the access points in ascending order.

   247         * KEApSortUidDescending:    The sorting is done according to the ID 

   248         *                           of the access points in descending order.

   249         * KEApSortNameAscending:    The sorting is done according to the name 

   250         *                           of the access points in ascending order.

   251         * KEApSortNameDescending:   The sorting is done according to the name

   252         *                           of the access points in descending order.

   253         * Caution! The ordering values can not be combined!

   254         * @param aDb A database to work on

   255         * @param aStartWithSelection A boolean value indicating whether to 

   256         * select or edit an ap.

   257         * @param aListType A TSelectionListType enum indicating the desired

   258         * list type.

   259         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   260         * menu type.

   261         * @param aIspTypeFilter Filtering criteria on ISP type

   262         * @param aBearerFilter Filtering criteria on bearer type

   263         * @param aSortType Specifies the sort order to use.

   264         * @return The constructed CApSettingsHandler object.

   265         *

   266         * @deprecated

   267         */

   268         IMPORT_C static CApSettingsHandler* NewLC(

   269                         CActiveApDb& aDb,

   270                         TBool aStartWithSelection,

   271                         TSelectionListType aListType,

   272                         TSelectionMenuType aSelMenuType,

   273                         TInt aIspFilter,

   274                         TInt aBearerFilter,

   275                         TInt aSortType

   276                         );

   277 

   278 

   279 

   280 

   281 

   282 

   283 

   284 

   285         /**

   286         * Two-phased constructor. Leaves on failure.

   287         * This function shall be used to create the access point 

   288         * settings/selection handling UI object.It is customizable through the

   289         * parameters. This object is a small layer above the UI part and

   290         * it provides a standard interface to select, edit, create access 

   291         * points. It has two main parts, Select and Edit. The first parameter, 

   292         * aStartWithSelection gives whether we would like to select or edit.

   293         * In case of selection, there is the possibility to use this module in

   294         * many applications. For this, two layouts are implemented, one is 

   295         * list pane used by General Settings which provides the list in a 

   296         * list-pane. The other layout is for the other applications requiring 

   297         * access point selection, a popup-list style as the decision was that 

   298         * General Settings will use list-pane and all other apps. popup-list 

   299         * style. It is the caller who selects the style so if spec. says 

   300         * otherwise, this module still can be used.

   301         * It is also possible to start the UI without selection, so if any 

   302         * module has a 'linked/default/etc.' access point and stored it's UID,

   303         * the module can simply call the editor part of the UI without having

   304         * to select the AP once more.

   305         * In case of editing only, (aStartWithSelection is EFalse), all other 

   306         * construction parameters are ignored and after construction caller 

   307         * can simply call RunSettingsL(..).

   308         * In case of selection, a lot of other parameters can be specified to

   309         * fulfil all requirements. There are three types of Options menu 

   310         * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly,

   311         * EApSettingsSelMenuSelectNormal.

   312         * <br>

   313         *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,

   314         *   delete, create, etc.

   315         * <br>

   316         * -EApSettingsSelMenuNormal:Options menu specified in General Settings,

   317         *   contains Edit, Delete, Create new, etc. menu items.

   318         * <br>

   319         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal 

   320         *   BUT the first item is Select. This one makes it possible to select 

   321         *   an access point and also possible to edit, create, delete, etc.

   322         * <br>

   323         * The following three parameters specify the filtering and ordering 

   324         * criteria for the selection list creation. First, it is possible to 

   325         * specify which ISP-type we are looking for. The possible values are:

   326         * <br>

   327         * KEApIspTypeInternetOnly: Filter allows only access points that are 

   328         *   capable of only internet access.

   329         * <br>

   330         * KEApIspTypeWAPOnly: Filter allows only access points that are 

   331         *   capable of only WAP access.

   332         * <br>

   333         * KEApIspTypeInternetAndWAP: Filter allows only access points that are 

   334         *   capable of internet AND WAP access.

   335         * <br>

   336         * KEApIspTypeWAPMandatory: Filter allows only access points that are 

   337         *   capable of WAP access AND contain mandatory WAP settings.

   338         * <br>

   339         * KEApIspTypeAll: No filtering is done for the isp-type, all types of

   340         *   access points are shown.

   341         * <br>

   342         * It is possible to combine them by simply adding/or-ing together the 

   343         * values, filtering will be done in such a way that only access points 

   344         * with the listed ISP-types will be shown.

   345         * Second filtering possibility (aBearerFilter) is the desired bearer 

   346         * type. The possible values are the values of the TApBearerType enum 

   347         * type and their combinations, as in case of the ISP type.

   348         * The ordering of the list can be specified with the aSortType 

   349         * parameter. It can have the following values:

   350         * KEApSortUidAscending: The sorting is done according to the ID of 

   351         *   the access points in ascending order.

   352         * KEApSortUidDescending: The sorting is done according to the ID of 

   353         *   the access points in descending order.

   354         * KEApSortNameAscending: The sorting is done according to the name of 

   355         *   the access points in ascending order.

   356         * KEApSortNameDescending: The sorting is done according to the name of 

   357         *   the access points in descending order.

   358         * Caution! The ordering values can not be combined!

   359         * @param aStartWithSelection A boolean value indicating whether to 

   360         *   select or edit an ap.

   361         * @param aListType A TSelectionListType enum indicating the desired

   362         *   list type.

   363         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   364         *   menu type.

   365         * @param aIspTypeFilter Filtering criteria on ISP type

   366         * @param aBearerFilter Filtering criteria on bearer type

   367         * @param aSortType Specifies the sort order to use.

   368         * @param aReqIpvType Specifies whether the caller would like to 

   369         *   have IPv4, IPv6 or both access points. If it is IPv6 or Both, 

   370         *   in case of IPv6 support is available as a feature, it will be 

   371         *   supported. If IPv6 feature is not supported by the phone, it 

   372         *   simply defaults to the normal IPv4 version.

   373         *   If it is IPv4, it uses the default IPv4 version independently 

   374         *   from IPv6 feature beeing available or not.

   375         * @return The constructed CApSettingsHandler object.

   376         *

   377         * @deprecated

   378         */

   379         IMPORT_C static CApSettingsHandler* NewLC(

   380                         TBool aStartWithSelection,

   381                         TSelectionListType aListType,

   382                         TSelectionMenuType aSelMenuType,

   383                         TInt aIspFilter,

   384                         TInt aBearerFilter,

   385                         TInt aSortType,

   386                         TInt aReqIpvType

   387                         );

   388 

   389 

   390 

   391         /**

   392         * Two-phased constructor. Leaves on failure.

   393         * This function shall be used to create the access point 

   394         * settings/selection handling UI object. It is customizable through 

   395         * the parameters. This object is a small layer above the UI part and

   396         * it provides a standard interface to select, edit, create access 

   397         * points. It has two main parts, Select and Edit. The first parameter,

   398         * aStartWithSelection gives whether we would like to select or edit.

   399         * In case of selection, there is the possibility to use this module in

   400         * many applications. For this, two layouts are implemented, one is list

   401         * pane used by General Settings which provides the list in a list-pane.

   402         * The other layout is for the other applications requiring access point

   403         * selection, a popup-list style as the decision was that General 

   404         * Settings will use list-pane and all other apps. popup-list style. 

   405         * It is the caller who selects the style so if spec. says otherwise,

   406         * this module still can be used. It is also possible to start the UI 

   407         * without selection, so if any module has a 'linked/default/etc.'

   408         * access point and stored it's UID, the module can simply call the 

   409         * editor part of the UI without having to select the AP once more.

   410         * In case of editing only, (aStartWithSelection is EFalse), all other 

   411         * construction parameters are ignored and after construction caller can

   412         * simply call RunSettingsL(..). In case of selection, a lot of other

   413         * parameters can be specified to fulfil all requirements. There are 

   414         * three types of Options menu available: EApSettingsSelMenuNormal, 

   415         * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.

   416         * <br>

   417         *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,

   418         *   delete, create, etc.

   419         * <br>

   420         * -EApSettingsSelMenuNormal:Options menu specified in General Settings,

   421         *   contains Edit, Delete, Create new, etc. menu items.

   422         * <br>

   423         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal 

   424         *   BUT the first item is Select. This one makes it possible to select

   425         *   an access point and also possible to edit, create, delete, etc.

   426         * <br>

   427         * The following three parameters specify the filtering and ordering

   428         * criteria for the selection list creation. First, it is possible to 

   429         * specify which ISP-type we are looking for. The possible values are:

   430         * <br>

   431         * KEApIspTypeInternetOnly: Filter allows only access points that are 

   432         *   capable of only internet access.

   433         * <br>

   434         * KEApIspTypeWAPOnly: Filter allows only access points that are 

   435         *   capable of only WAP access.

   436         * <br>

   437         * KEApIspTypeInternetAndWAP: Filter allows only access points that are 

   438         *   capable of internet AND WAP access.

   439         * <br>

   440         * KEApIspTypeWAPMandatory: Filter allows only access points that are 

   441         *   capable of WAP access AND contain mandatory WAP settings.

   442         * <br>

   443         * KEApIspTypeAll: No filtering is done for the isp-type, all types of

   444         *   access points are shown.

   445         * <br>

   446         * It is possible to combine them by simply adding/or-ing together the

   447         * values, filtering will be done in such a way that only access points

   448         * with the listed ISP-types will be shown. Second filtering possibility

   449         * (aBearerFilter) is the desired bearer type. The possible values are 

   450         * the values of the TApBearerType enum type and their combinations, as

   451         * in case of the ISP type. The ordering of the list can be specified 

   452         * with the aSortType parameter. It can have the following values:

   453         * KEApSortUidAscending: The sorting is done according to the ID of 

   454         *   the access points in ascending order.

   455         * KEApSortUidDescending: The sorting is done according to the ID of 

   456         *   the access points in descending order.

   457         * KEApSortNameAscending: The sorting is done according to the name of

   458         *   the access points in ascending order.

   459         * KEApSortNameDescending: The sorting is done according to the name of

   460         *   the access points in descending order.

   461         * Caution! The ordering values can not be combined!

   462         * @param aDb A database to work on

   463         * @param aStartWithSelection A boolean value indicating whether to 

   464         *   select or edit an ap.

   465         * @param aListType A TSelectionListType enum indicating the desired

   466         *   list type.

   467         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   468         *   menu type.

   469         * @param aIspTypeFilter Filtering criteria on ISP type

   470         * @param aBearerFilter Filtering criteria on bearer type

   471         * @param aSortType Specifies the sort order to use.

   472         * @param aReqIpvType Specifies whether the caller would like to 

   473         *   have IPv4, IPv6 or both access points. If it is IPv6 or Both, 

   474         *   in case of IPv6 support is available as a feature, it will be 

   475         *   supported. If IPv6 feature is not supported by the phone, it 

   476         *   simply defaults to the normal IPv4 version.

   477         *   If it is IPv4, it uses the default IPv4 version independently 

   478         *   from IPv6 feature beeing available or not.

   479         * @return The constructed CApSettingsHandler object.

   480         *

   481         * @deprecated

   482         */

   483         IMPORT_C static CApSettingsHandler* NewLC(

   484                         CActiveApDb& aDb,

   485                         TBool aStartWithSelection,

   486                         TSelectionListType aListType,

   487                         TSelectionMenuType aSelMenuType,

   488                         TInt aIspFilter,

   489                         TInt aBearerFilter,

   490                         TInt aSortType,

   491                         TInt aReqIpvType

   492                         );

   493 

   494 

   495 

   496 

   497         /**

   498         * Two-phased constructor. Leaves on failure.

   499         * This function shall be used to create the access point 

   500         * settings/selection handling UI object.It is customizable through the

   501         * parameters. This object is a small layer above the UI part and

   502         * it provides a standard interface to select, edit, create access 

   503         * points. It has two main parts, Select and Edit. The first parameter, 

   504         * aStartWithSelection gives whether we would like to select or edit.

   505         * In case of selection, there is the possibility to use this module in

   506         * many applications. For this, two layouts are implemented, one is 

   507         * list pane used by General Settings which provides the list in a 

   508         * list-pane. The other layout is for the other applications requiring 

   509         * access point selection, a popup-list style as the decision was that 

   510         * General Settings will use list-pane and all other apps. popup-list 

   511         * style. It is the caller who selects the style so if spec. says 

   512         * otherwise, this module still can be used.

   513         * It is also possible to start the UI without selection, so if any 

   514         * module has a 'linked/default/etc.' access point and stored it's UID,

   515         * the module can simply call the editor part of the UI without having

   516         * to select the AP once more.

   517         * In case of editing only, (aStartWithSelection is EFalse), all other 

   518         * construction parameters are ignored and after construction caller 

   519         * can simply call RunSettingsL(..).

   520         * In case of selection, a lot of other parameters can be specified to

   521         * fulfil all requirements. There are three types of Options menu 

   522         * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly,

   523         * EApSettingsSelMenuSelectNormal.

   524         * <br>

   525         *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,

   526         *   delete, create, etc.

   527         * <br>

   528         * -EApSettingsSelMenuNormal:Options menu specified in General Settings,

   529         *   contains Edit, Delete, Create new, etc. menu items.

   530         * <br>

   531         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal 

   532         *   BUT the first item is Select. This one makes it possible to select 

   533         *   an access point and also possible to edit, create, delete, etc.

   534         * <br>

   535         * The following three parameters specify the filtering and ordering 

   536         * criteria for the selection list creation. First, it is possible to 

   537         * specify which ISP-type we are looking for. The possible values are:

   538         * <br>

   539         * KEApIspTypeInternetOnly: Filter allows only access points that are 

   540         *   capable of only internet access.

   541         * <br>

   542         * KEApIspTypeWAPOnly: Filter allows only access points that are 

   543         *   capable of only WAP access.

   544         * <br>

   545         * KEApIspTypeInternetAndWAP: Filter allows only access points that are 

   546         *   capable of internet AND WAP access.

   547         * <br>

   548         * KEApIspTypeWAPMandatory: Filter allows only access points that are 

   549         *   capable of WAP access AND contain mandatory WAP settings.

   550         * <br>

   551         * KEApIspTypeAll: No filtering is done for the isp-type, all types of

   552         *   access points are shown.

   553         * <br>

   554         * It is possible to combine them by simply adding/or-ing together the 

   555         * values, filtering will be done in such a way that only access points 

   556         * with the listed ISP-types will be shown.

   557         * Second filtering possibility (aBearerFilter) is the desired bearer 

   558         * type. The possible values are the values of the TApBearerType enum 

   559         * type and their combinations, as in case of the ISP type.

   560         * The ordering of the list can be specified with the aSortType 

   561         * parameter. It can have the following values:

   562         * KEApSortUidAscending: The sorting is done according to the ID of 

   563         *   the access points in ascending order.

   564         * KEApSortUidDescending: The sorting is done according to the ID of 

   565         *   the access points in descending order.

   566         * KEApSortNameAscending: The sorting is done according to the name of 

   567         *   the access points in ascending order.

   568         * KEApSortNameDescending: The sorting is done according to the name of 

   569         *   the access points in descending order.

   570         * Caution! The ordering values can not be combined!

   571         * @param aStartWithSelection A boolean value indicating whether to 

   572         *   select or edit an ap.

   573         * @param aListType A TSelectionListType enum indicating the desired

   574         *   list type.

   575         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   576         *   menu type.

   577         * @param aIspTypeFilter Filtering criteria on ISP type

   578         * @param aBearerFilter Filtering criteria on bearer type

   579         * @param aSortType Specifies the sort order to use.

   580         * @param aReqIpvType Specifies whether the caller would like to 

   581         *   have IPv4, IPv6 or both access points. If it is IPv6 or Both, 

   582         *   in case of IPv6 support is available as a feature, it will be 

   583         *   supported. If IPv6 feature is not supported by the phone, it 

   584         *   simply defaults to the normal IPv4 version.

   585         *   If it is IPv4, it uses the default IPv4 version independently 

   586         *   from IPv6 feature beeing available or not.

   587         * @param aVpnFilterType a TVpnFilterType representing the possible 

   588         *   additional VPN filtering.

   589         * @return The constructed CApSettingsHandler object.

   590         *

   591         * @deprecated

   592         */

   593         IMPORT_C static CApSettingsHandler* NewLC(

   594                         TBool aStartWithSelection,

   595                         TSelectionListType aListType,

   596                         TSelectionMenuType aSelMenuType,

   597                         TInt aIspFilter,

   598                         TInt aBearerFilter,

   599                         TInt aSortType,

   600                         TInt aReqIpvType,

   601                         TVpnFilterType aVpnFilterType

   602                         );

   603 

   604 

   605 

   606         /**

   607         * Two-phased constructor. Leaves on failure.

   608         * This function shall be used to create the access point 

   609         * settings/selection handling UI object. It is customizable through 

   610         * the parameters. This object is a small layer above the UI part and

   611         * it provides a standard interface to select, edit, create access 

   612         * points. It has two main parts, Select and Edit. The first parameter,

   613         * aStartWithSelection gives whether we would like to select or edit.

   614         * In case of selection, there is the possibility to use this module in

   615         * many applications. For this, two layouts are implemented, one is list

   616         * pane used by General Settings which provides the list in a list-pane.

   617         * The other layout is for the other applications requiring access point

   618         * selection, a popup-list style as the decision was that General 

   619         * Settings will use list-pane and all other apps. popup-list style. 

   620         * It is the caller who selects the style so if spec. says otherwise,

   621         * this module still can be used. It is also possible to start the UI 

   622         * without selection, so if any module has a 'linked/default/etc.'

   623         * access point and stored it's UID, the module can simply call the 

   624         * editor part of the UI without having to select the AP once more.

   625         * In case of editing only, (aStartWithSelection is EFalse), all other 

   626         * construction parameters are ignored and after construction caller can

   627         * simply call RunSettingsL(..). In case of selection, a lot of other

   628         * parameters can be specified to fulfil all requirements. There are 

   629         * three types of Options menu available: EApSettingsSelMenuNormal, 

   630         * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.

   631         * <br>

   632         *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,

   633         *   delete, create, etc.

   634         * <br>

   635         * -EApSettingsSelMenuNormal:Options menu specified in General Settings,

   636         *   contains Edit, Delete, Create new, etc. menu items.

   637         * <br>

   638         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal 

   639         *   BUT the first item is Select. This one makes it possible to select

   640         *   an access point and also possible to edit, create, delete, etc.

   641         * <br>

   642         * The following three parameters specify the filtering and ordering

   643         * criteria for the selection list creation. First, it is possible to 

   644         * specify which ISP-type we are looking for. The possible values are:

   645         * <br>

   646         * KEApIspTypeInternetOnly: Filter allows only access points that are 

   647         *   capable of only internet access.

   648         * <br>

   649         * KEApIspTypeWAPOnly: Filter allows only access points that are 

   650         *   capable of only WAP access.

   651         * <br>

   652         * KEApIspTypeInternetAndWAP: Filter allows only access points that are 

   653         *   capable of internet AND WAP access.

   654         * <br>

   655         * KEApIspTypeWAPMandatory: Filter allows only access points that are 

   656         *   capable of WAP access AND contain mandatory WAP settings.

   657         * <br>

   658         * KEApIspTypeAll: No filtering is done for the isp-type, all types of

   659         *   access points are shown.

   660         * <br>

   661         * It is possible to combine them by simply adding/or-ing together the

   662         * values, filtering will be done in such a way that only access points

   663         * with the listed ISP-types will be shown. Second filtering possibility

   664         * (aBearerFilter) is the desired bearer type. The possible values are 

   665         * the values of the TApBearerType enum type and their combinations, as

   666         * in case of the ISP type. The ordering of the list can be specified 

   667         * with the aSortType parameter. It can have the following values:

   668         * KEApSortUidAscending: The sorting is done according to the ID of 

   669         *   the access points in ascending order.

   670         * KEApSortUidDescending: The sorting is done according to the ID of 

   671         *   the access points in descending order.

   672         * KEApSortNameAscending: The sorting is done according to the name of

   673         *   the access points in ascending order.

   674         * KEApSortNameDescending: The sorting is done according to the name of

   675         *   the access points in descending order.

   676         * Caution! The ordering values can not be combined!

   677         * @param aDb A database to work on

   678         * @param aStartWithSelection A boolean value indicating whether to 

   679         *   select or edit an ap.

   680         * @param aListType A TSelectionListType enum indicating the desired

   681         *   list type.

   682         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   683         *   menu type.

   684         * @param aIspTypeFilter Filtering criteria on ISP type

   685         * @param aBearerFilter Filtering criteria on bearer type

   686         * @param aSortType Specifies the sort order to use.

   687         * @param aReqIpvType Specifies whether the caller would like to 

   688         *   have IPv4, IPv6 or both access points. If it is IPv6 or Both, 

   689         *   in case of IPv6 support is available as a feature, it will be 

   690         *   supported. If IPv6 feature is not supported by the phone, it 

   691         *   simply defaults to the normal IPv4 version.

   692         *   If it is IPv4, it uses the default IPv4 version independently 

   693         *   from IPv6 feature beeing available or not.

   694         * @param aVpnFilterType a TVpnFilterType representing the possible 

   695         *   additional VPN filtering.

   696         * @return The constructed CApSettingsHandler object.

   697         *

   698         * @deprecated

   699         */

   700         IMPORT_C static CApSettingsHandler* NewLC(

   701                         CActiveApDb& aDb,

   702                         TBool aStartWithSelection,

   703                         TSelectionListType aListType,

   704                         TSelectionMenuType aSelMenuType,

   705                         TInt aIspFilter,

   706                         TInt aBearerFilter,

   707                         TInt aSortType,

   708                         TInt aReqIpvType,

   709                         TVpnFilterType aVpnFilterType

   710                         );

   711 

   712 

   713 

   714 

   715 

   716         /**

   717         * Two-phased constructor. Leaves on failure.

   718         * This function shall be used to create the access point 

   719         * settings/selection handling UI object. It is customizable through 

   720         * the parameters. This object is a small layer above the UI part and

   721         * it provides a standard interface to select, edit, create access 

   722         * points. It has two main parts, Select and Edit. The first parameter,

   723         * aStartWithSelection gives whether we would like to select or edit.

   724         * In case of selection, there is the possibility to use this module in

   725         * many applications. For this, two layouts are implemented, one is list

   726         * pane used by General Settings which provides the list in a list-pane.

   727         * The other layout is for the other applications requiring access point

   728         * selection, a popup-list style as the decision was that General 

   729         * Settings will use list-pane and all other apps. popup-list style. 

   730         * It is the caller who selects the style so if spec. says otherwise,

   731         * this module still can be used. It is also possible to start the UI 

   732         * without selection, so if any module has a 'linked/default/etc.'

   733         * access point and stored it's UID, the module can simply call the 

   734         * editor part of the UI without having to select the AP once more.

   735         * In case of editing only, (aStartWithSelection is EFalse), all other 

   736         * construction parameters are ignored and after construction caller can

   737         * simply call RunSettingsL(..). In case of selection, a lot of other

   738         * parameters can be specified to fulfil all requirements. There are 

   739         * three types of Options menu available: EApSettingsSelMenuNormal, 

   740         * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal.

   741         * <br>

   742         *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit,

   743         *   delete, create, etc.

   744         * <br>

   745         * -EApSettingsSelMenuNormal:Options menu specified in General Settings,

   746         *   contains Edit, Delete, Create new, etc. menu items.

   747         * <br>

   748         * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal 

   749         *   BUT the first item is Select. This one makes it possible to select

   750         *   an access point and also possible to edit, create, delete, etc.

   751         * <br>

   752         * The following three parameters specify the filtering and ordering

   753         * criteria for the selection list creation. First, it is possible to 

   754         * specify which ISP-type we are looking for. The possible values are:

   755         * <br>

   756         * KEApIspTypeInternetOnly: Filter allows only access points that are 

   757         *   capable of only internet access.

   758         * <br>

   759         * KEApIspTypeWAPOnly: Filter allows only access points that are 

   760         *   capable of only WAP access.

   761         * <br>

   762         * KEApIspTypeInternetAndWAP: Filter allows only access points that are 

   763         *   capable of internet AND WAP access.

   764         * <br>

   765         * KEApIspTypeWAPMandatory: Filter allows only access points that are 

   766         *   capable of WAP access AND contain mandatory WAP settings.

   767         * <br>

   768         * KEApIspTypeAll: No filtering is done for the isp-type, all types of

   769         *   access points are shown.

   770         * <br>

   771         * It is possible to combine them by simply adding/or-ing together the

   772         * values, filtering will be done in such a way that only access points

   773         * with the listed ISP-types will be shown. Second filtering possibility

   774         * (aBearerFilter) is the desired bearer type. The possible values are 

   775         * the values of the TApBearerType enum type and their combinations, as

   776         * in case of the ISP type. The ordering of the list can be specified 

   777         * with the aSortType parameter. It can have the following values:

   778         * KEApSortUidAscending: The sorting is done according to the ID of 

   779         *   the access points in ascending order.

   780         * KEApSortUidDescending: The sorting is done according to the ID of 

   781         *   the access points in descending order.

   782         * KEApSortNameAscending: The sorting is done according to the name of

   783         *   the access points in ascending order.

   784         * KEApSortNameDescending: The sorting is done according to the name of

   785         *   the access points in descending order.

   786         * Caution! The ordering values can not be combined!

   787         * @param aDb A database to work on

   788         * @param aStartWithSelection A boolean value indicating whether to 

   789         *   select or edit an ap.

   790         * @param aListType A TSelectionListType enum indicating the desired

   791         *   list type.

   792         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   793         *   menu type.

   794         * @param aIspTypeFilter Filtering criteria on ISP type

   795         * @param aBearerFilter Filtering criteria on bearer type

   796         * @param aSortType Specifies the sort order to use.

   797         * @param aReqIpvType Specifies whether the caller would like to 

   798         *   have IPv4, IPv6 or both access points. If it is IPv6 or Both, 

   799         *   in case of IPv6 support is available as a feature, it will be 

   800         *   supported. If IPv6 feature is not supported by the phone, it 

   801         *   simply defaults to the normal IPv4 version.

   802         *   If it is IPv4, it uses the default IPv4 version independently 

   803         *   from IPv6 feature beeing available or not.

   804         * @param aVpnFilterType a TVpnFilterType representing the possible 

   805         *   additional VPN filtering.

   806         * @param aIncludeEasyWlan a TBool indicating whether it should 

   807         *   include the easy wlan AP in the list or not.

   808         * @return The constructed CApSettingsHandler object.

   809         *

   810         * @deprecated

   811         */

   812         IMPORT_C static CApSettingsHandler* NewLC(

   813                         CActiveApDb& aDb,

   814                         TBool aStartWithSelection,

   815                         TSelectionListType aListType,

   816                         TSelectionMenuType aSelMenuType,

   817                         TInt aIspFilter,

   818                         TInt aBearerFilter,

   819                         TInt aSortType,

   820                         TInt aReqIpvType,

   821                         TVpnFilterType aVpnFilterType,

   822                         TBool aIncludeEasyWlan

   823                         );

   824 

   825 

   826 

   827 

   828         /**

   829         * Destructor.

   830         *

   831         * @deprecated

   832         */

   833         IMPORT_C ~CApSettingsHandler();

   834 

   835 

   836     protected:

   837         /**

   838         * Constructor.

   839         * @param aStartWithSelection A boolean value indicating whether to 

   840         *   select or edit an ap.

   841         * @param aListType A TSelectionListType enum indicating the desired

   842         *   list type.

   843         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   844         *   menu type.

   845         *

   846         * @deprecated

   847         */

   848         IMPORT_C CApSettingsHandler(

   849                                     TBool aStartWithSelection,

   850                                     TSelectionListType aListType,

   851                                     TSelectionMenuType aSelMenuType

   852                                     );

   853 

   854         /**

   855         * Constructor.

   856         * @param aStartWithSelection A boolean value indicating whether to 

   857         *   select or edit an ap.

   858         * @param aListType A TSelectionListType enum indicating the desired

   859         *   list type.

   860         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   861         *   menu type.

   862         * @param aHelpMajor Major help ID

   863         *

   864         * @deprecated

   865         */

   866         IMPORT_C CApSettingsHandler(

   867                                     TBool aStartWithSelection,

   868                                     TSelectionListType aListType,

   869                                     TSelectionMenuType aSelMenuType,

   870                                     TUid aHelpMajor

   871                                     );

   872 

   873 

   874         /**

   875         * Constructor.

   876         * @param aStartWithSelection A boolean value indicating whether to 

   877         *   select or edit an ap.

   878         * @param aListType A TSelectionListType enum indicating the desired

   879         *   list type.

   880         * @param aSelMenuType A TSelectionMenuType enum indicating the desired

   881         *   menu type.

   882         * @param aNeedIpv6Support Whether IPv6 is supported or not

   883         */

   884         CApSettingsHandler(

   885                             TBool aStartWithSelection,

   886                             TSelectionListType aListType,

   887                             TSelectionMenuType aSelMenuType,

   888                             TBool aNeedIpv6Support

   889                             );

   890 

   891 

   892 

   893         /**

   894         * Second-phase constructor.

   895         * @param aIspTypeFilter Filtering criteria on ISP type

   896         * @param aBearerFilter Filtering criteria on bearer type

   897         * @param aSortType Specifies the sort order to use.

   898         *

   899         * @deprecated

   900         */

   901         IMPORT_C void ConstructL(

   902                                 TInt aIspFilter,

   903                                 TInt aBearerFilter,

   904                                 TInt aSortType

   905                                 );

   906 

   907 

   908         /**

   909         * Second-phase constructor.

   910         * @param aDb A database to work on

   911         * @param aIspTypeFilter Filtering criteria on ISP type

   912         * @param aBearerFilter Filtering criteria on bearer type

   913         * @param aSortType Specifies the sort order to use.

   914         *

   915         * @deprecated

   916         */

   917         IMPORT_C void ConstructL(

   918                                 CActiveApDb& aDb,

   919                                 TInt aIspFilter,

   920                                 TInt aBearerFilter,

   921                                 TInt aSortType

   922                                 );

   923 

   924 

   925         /**

   926         * Second-phase constructor.

   927         * @param aIspTypeFilter Filtering criteria on ISP type

   928         * @param aBearerFilter Filtering criteria on bearer type

   929         * @param aSortType Specifies the sort order to use.

   930         * @param aVpnFilterType a TVpnFilterType representing the possible 

   931         *   additional VPN filtering.

   932         *

   933         * @deprecated

   934         */

   935         IMPORT_C void ConstructL(

   936                                 TInt aIspFilter,

   937                                 TInt aBearerFilter,

   938                                 TInt aSortType,

   939                                 TVpnFilterType aVpnFilterType

   940                                 );

   941 

   942 

   943         /**

   944         * Second-phase constructor.

   945         * @param aDb A database to work on

   946         * @param aIspTypeFilter Filtering criteria on ISP type

   947         * @param aBearerFilter Filtering criteria on bearer type

   948         * @param aSortType Specifies the sort order to use.

   949         * @param aVpnFilterType a TVpnFilterType representing the possible 

   950         *   additional VPN filtering.

   951         *

   952         * @deprecated

   953         */

   954         IMPORT_C void ConstructL(

   955                                 CActiveApDb& aDb,

   956                                 TInt aIspFilter,

   957                                 TInt aBearerFilter,

   958                                 TInt aSortType,

   959                                 TVpnFilterType aVpnFilterType

   960                                 );

   961 

   962 

   963 

   964 

   965         /**

   966         * Second-phase constructor.

   967         * @param aDb A database to work on

   968         * @param aIspTypeFilter Filtering criteria on ISP type

   969         * @param aBearerFilter Filtering criteria on bearer type

   970         * @param aSortType Specifies the sort order to use.

   971         * @param aVpnFilterType a TVpnFilterType representing the possible 

   972         *   additional VPN filtering.

   973         * @param aIncludeEasyWlan a TBool indicating whether it should 

   974         *   include the easy wlan AP in the list or not.

   975         *

   976         * @deprecated

   977         */

   978         IMPORT_C void ConstructL(

   979                                 CActiveApDb& aDb,

   980                                 TInt aIspFilter,

   981                                 TInt aBearerFilter,

   982                                 TInt aSortType,

   983                                 TVpnFilterType aVpnFilterType,

   984                                 TBool aIncludeEasyWlan

   985                                 );

   986 

   987 

   988     public: // New functions

   989         /**

   990         * Sets the filtering used in the access point selection.

   991         * @param aIspTypeFilter Filtering criteria on ISP type

   992         * @param aBearerFilter Filtering criteria on bearer type

   993         * @param aSortType Specifies the sort order to use.

   994         * @return No return value. Leaves on error.

   995         *

   996         * @deprecated

   997         */

   998         IMPORT_C void SetFilterL(

   999                                 TInt aIspFilter,

  1000                                 TInt aBearerFilter,

  1001                                 TInt aSortType

  1002                                 );

  1003 

  1004 

  1005         /**

  1006         * Sets possible overrides of some texts.

  1007         * By default, text is read from resources. This provides a way to 

  1008         * change some of the text to a caller-supplied one. The text must 

  1009         * be read from resource and must be already localized.

  1010         * More than one text can be substituted, they are stored internally

  1011         * in an array.

  1012         * Currently not supported and supporting it is under discussion.

  1013         * @param aText2Change TTextID to identify the text to be replaced with

  1014         * @param aNewText Reference to the substitute text.

  1015         *

  1016         * @deprecated

  1017         */

  1018         IMPORT_C void SetTextOverrideL( TTextID aText2Change, 

  1019                                         const TDesC& aNewText );

  1020 

  1021 

  1022         /**

  1023         * Gets possible overrides of a text.

  1024         * By default, text is read from resources. This provides a way to 

  1025         * change some of the text to a caller-supplied one. The text must

  1026         * be read from resource and must be already localized.

  1027         * More than one text can be substituted, they are stored internally

  1028         * in an array.

  1029         * Currently not supported and supporting it is under discussion

  1030         * @param aTextID TTextID type to identify the text to be replaced with

  1031         * @return Reference to the substitute text.

  1032         *

  1033         * @deprecated

  1034         */

  1035         IMPORT_C const TDesC& TextOverrideL( TTextID aTextId );

  1036 

  1037 

  1038         /**

  1039         * Starts the settings component.

  1040         * Creates dialog(s) from scratch, launches and executes them.

  1041         * Can leave with error codes.

  1042         * @param TUint32 aHighlight The UID of the AP to highlight by default

  1043         * @param TUint32 aSelected The UID of the access point selected 

  1044         * by the user.

  1045         * @return The accomplished task's flag-codes:

  1046         * <br>

  1047         * KApUiEventNone,

  1048         * <br>

  1049         * KApUiEventSelected,

  1050         * <br>

  1051         * KApUiEventCreatedBlank,

  1052         * <br>

  1053         * KApUiEventCreatedUsedOld,

  1054         * <br>

  1055         * KApUiEventEdited,

  1056         * <br>

  1057         * KApUiEventDeleted,

  1058         * <br>

  1059         * KApUiEventExitRequested

  1060         * <br>and their combinations. ( Bitwise OR )

  1061         * <br>

  1062         * aSelected will be modified only if KApUiEventSelected is included 

  1063         * in the flags.

  1064         * <br>

  1065         * In case it returns KApUiEventExitRequested, the user had choosen

  1066         * the Exit option from the Options menu which means

  1067         * that the caller application MUST exit!

  1068         * <br>

  1069         * Returns after completion!

  1070         *

  1071         * @deprecated

  1072         */

  1073         IMPORT_C TInt RunSettingsL( TUint32 aHighLight, TUint32& aSelected );

  1074 

  1075 

  1076         /**

  1077         * Component Validation Test.

  1078         * @return KErrNone.

  1079         *

  1080         * @deprecated

  1081         */

  1082         IMPORT_C static TInt Cvt();

  1083 

  1084 

  1085     protected:  // New functions

  1086         /**

  1087         * @Deprecated

  1088         * Starts the settings component.

  1089         * Creates dialog(s) from scratch, launches and executes them.

  1090         * In case of error, leaves with error codes.

  1091         * @param TUint32 aHighlight The UID of the AP to highlight by default

  1092         * @param TUint32 aSelected The UID of the AP selected by the user

  1093         * @return The accomplished task's flag-codes:

  1094         * <br>

  1095         * KApUiEventNone,

  1096         * <br>

  1097         * KApUiEventSelected,

  1098         * <br>

  1099         * KApUiEventCreatedBlank,

  1100         * <br>

  1101         * KApUiEventCreatedUsedOld,

  1102         * <br>

  1103         * KApUiEventEdited,

  1104         * <br>

  1105         * KApUiEventDeleted

  1106         * <br>

  1107         * and their combinations. ( Bitwise OR )

  1108         * <br>

  1109         * aSelected will be modified only if KApUiEventSelected is included 

  1110         * in the flags.

  1111         * <br>

  1112         * Returns after completion!

  1113         */

  1114         TInt DoRunSettingsL( TUint32 aHighLight, TUint32& aSelected );

  1115 

  1116 

  1117         /**

  1118         * Starts the viewer component.

  1119         * Creates dialog(s) from scratch, launches and executes it.

  1120         * In case of error, leaves with error codes.

  1121         * @param TUint32 aUid The UID of the AP to view/edit

  1122         * @return Returns the completed task's flags

  1123         * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank,

  1124         * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted,

  1125         * KApUiEventExitRequested and their combinations. ( Bitwise OR )

  1126         * In case it returns KApUiEventExitRequested, the user had choosen

  1127         * the Exit option from the Options menu which means

  1128         * that the caller application MUST exit!

  1129         * <br>

  1130         * Returns after completion!

  1131         *

  1132         * @deprecated

  1133         */

  1134         IMPORT_C TInt RunViewerL( TUint32 aUid );