williamr@2: /* williamr@2: * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). williamr@2: * All rights reserved. williamr@2: * This component and the accompanying materials are made available williamr@2: * 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 williamr@2: * which accompanies this distribution, and is available williamr@2: * at the URL "http://www.symbianfoundation.org/legal/licencesv10.html". williamr@2: * williamr@2: * Initial Contributors: williamr@2: * Nokia Corporation - initial contribution. williamr@2: * williamr@2: * Contributors: williamr@2: * williamr@2: * Description: williamr@2: * Declares the main handler, CApSettingsHandler and public API for the williamr@2: * Access Point settings. williamr@2: * williamr@2: */ williamr@2: williamr@2: williamr@2: #ifndef APSETTINGS_HANDLER_H williamr@2: #define APSETTINGS_HANDLER_H williamr@2: williamr@2: // Deprecation warning williamr@2: #warning This header file has been deprecated. Will be removed in one of the next SDK releases. williamr@2: williamr@2: williamr@2: // INCLUDES williamr@2: #include williamr@2: #include williamr@2: #include williamr@2: williamr@2: // CONSTANTS williamr@2: const TUid KUidApSettingsHandler = { 0x10008d3B }; williamr@2: williamr@2: typedef struct ///< Extra data holder williamr@2: { williamr@2: TInt iResOffset; williamr@2: TBool iIsIpv6Supported; // Default is NO williamr@2: TBool iIsFeatureManagerInitialised; williamr@2: TInt iExtra; williamr@2: TInt iSortType; williamr@2: TVpnFilterType iVpnFilterType; williamr@2: TInt iVariant; /// Local variant value williamr@2: TBool iIncludeEasyWlan; williamr@2: }TApSetHandlerExtra; williamr@2: williamr@2: // FORWARD DECLARATIONS williamr@2: class CActiveApDb; williamr@2: class CApSelector; williamr@2: class CApSettingsModel; williamr@2: class CApSettings; williamr@2: class CTextOverrides; williamr@2: class CApAccessPointItem; williamr@2: williamr@2: class CApSettingsHandlerImpl; williamr@2: williamr@2: // CLASS DECLARATION williamr@2: /** williamr@2: * CApSettingsHandler class: It is the main handler for the Access Point williamr@2: * settings. It contains the only public API for other (sub)systems. williamr@2: * williamr@2: */ williamr@2: class CApSettingsHandler : public CBase williamr@2: { williamr@2: williamr@2: public: // Constructors and destructor williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object. It is customizable through williamr@2: * the parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, williamr@2: * one is list pane used by General Settings which provides the list in williamr@2: * a list-pane. The other layout is for the other applications williamr@2: * requiring access point selection, a popup-list style as the decision williamr@2: * I know about was that General Settings will use list-pane and all williamr@2: * other apps. popup-list style. It is the caller who selects the style williamr@2: * so if spec. says otherwise, this module still can be used. williamr@2: * It is also possible to start the UI without selection, so if any williamr@2: * module has a 'linked/default/etc.' access point and stored it's UID, williamr@2: * the module can simply call the editor part of the UI without having williamr@2: * to select the AP once more. In case of editing only, williamr@2: * (aStartWithSelection is EFalse), all other construction parameters williamr@2: * are ignored and after construction caller can simply call williamr@2: * RunSettingsL(..). In case of selection, a lot of other parameters williamr@2: * can be specified to fulfil all requirements. There are three types williamr@2: * of Options menu available: williamr@2: * EApSettingsSelMenuNormal, williamr@2: * EApSettingsSelMenuSelectOnly, williamr@2: * EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, williamr@2: * no way to edit, delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal: Options menu specified in General williamr@2: * Settings, contains Edit, Delete, williamr@2: * Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. williamr@2: * This one makes it possible to select williamr@2: * an access point and also possible to williamr@2: * edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain williamr@2: * mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, williamr@2: * all types of access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together williamr@2: * the values, filtering will be done in such a way that only access williamr@2: * points with the listed ISP-types will be shown. Second filtering williamr@2: * possibility (aBearerFilter) is the desired bearer type. The possible williamr@2: * values are the values of the TApBearerType enum type and their williamr@2: * combinations, as in case of the ISP type. The ordering of the list williamr@2: * can be specified with the aSortType parameter. It can have the williamr@2: * following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID williamr@2: * of the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID williamr@2: * of the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name williamr@2: * of the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name williamr@2: * of the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the williamr@2: * desired list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the williamr@2: * desired menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object. It is customizable through williamr@2: * the parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create williamr@2: * access points. It has two main parts, Select and Edit. The first williamr@2: * parameter, aStartWithSelection gives whether we would like to select williamr@2: * or edit. In case of selection, there is the possibility to use this williamr@2: * module in many applications. For this, two layouts are implemented, williamr@2: * one is list pane used by General Settings which provides the list williamr@2: * in a list-pane. The other layout is for the other applications williamr@2: * requiring access point selection, a popup-list style as the williamr@2: * decision I know about was that General Settings will use list-pane williamr@2: * and all other apps. popup-list style. It is the caller who selects williamr@2: * the style so if spec. says otherwise, this module still can be used. williamr@2: * It is also possible to start the UI without selection, so if any williamr@2: * module has a 'linked/default/etc.' access point and stored it's UID, williamr@2: * the module can simply call the editor part of the UI without having williamr@2: * to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller williamr@2: * can simply call RunSettingsL(..). williamr@2: * In case of selection, a lot of other parameters can be specified williamr@2: * to fulfil all requirements. There are three types of Options menu williamr@2: * available: williamr@2: * EApSettingsSelMenuNormal, williamr@2: * EApSettingsSelMenuSelectOnly, williamr@2: * EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to williamr@2: * edit, delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal: Options menu specified in General williamr@2: * Settings, contains Edit, Delete, williamr@2: * Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. williamr@2: * This one makes it possible to williamr@2: * select an access point and also williamr@2: * possible to edit, create, williamr@2: * delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that williamr@2: * are capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that williamr@2: * are capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that williamr@2: * are capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that williamr@2: * are capable of WAP access AND contain williamr@2: * mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, williamr@2: * all types of access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. williamr@2: * Second filtering possibility (aBearerFilter) is the desired bearer williamr@2: * type. The possible values are the values of the TApBearerType enum williamr@2: * type and their combinations, as in case of the ISP type. williamr@2: * The ordering of the list can be specified with the aSortType williamr@2: * parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID williamr@2: * of the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID williamr@2: * of the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name williamr@2: * of the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name williamr@2: * of the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aDb A database to work on williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: CActiveApDb& aDb, williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object.It is customizable through the williamr@2: * parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, one is williamr@2: * list pane used by General Settings which provides the list in a williamr@2: * list-pane. The other layout is for the other applications requiring williamr@2: * access point selection, a popup-list style as the decision was that williamr@2: * General Settings will use list-pane and all other apps. popup-list williamr@2: * style. It is the caller who selects the style so if spec. says williamr@2: * otherwise, this module still can be used. williamr@2: * It is also possible to start the UI without selection, so if any williamr@2: * module has a 'linked/default/etc.' access point and stored it's UID, williamr@2: * the module can simply call the editor part of the UI without having williamr@2: * to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller williamr@2: * can simply call RunSettingsL(..). williamr@2: * In case of selection, a lot of other parameters can be specified to williamr@2: * fulfil all requirements. There are three types of Options menu williamr@2: * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly, williamr@2: * EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit, williamr@2: * delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal:Options menu specified in General Settings, williamr@2: * contains Edit, Delete, Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. This one makes it possible to select williamr@2: * an access point and also possible to edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, all types of williamr@2: * access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. williamr@2: * Second filtering possibility (aBearerFilter) is the desired bearer williamr@2: * type. The possible values are the values of the TApBearerType enum williamr@2: * type and their combinations, as in case of the ISP type. williamr@2: * The ordering of the list can be specified with the aSortType williamr@2: * parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID of williamr@2: * the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID of williamr@2: * the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name of williamr@2: * the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name of williamr@2: * the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aReqIpvType Specifies whether the caller would like to williamr@2: * have IPv4, IPv6 or both access points. If it is IPv6 or Both, williamr@2: * in case of IPv6 support is available as a feature, it will be williamr@2: * supported. If IPv6 feature is not supported by the phone, it williamr@2: * simply defaults to the normal IPv4 version. williamr@2: * If it is IPv4, it uses the default IPv4 version independently williamr@2: * from IPv6 feature beeing available or not. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TInt aReqIpvType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object. It is customizable through williamr@2: * the parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, one is list williamr@2: * pane used by General Settings which provides the list in a list-pane. williamr@2: * The other layout is for the other applications requiring access point williamr@2: * selection, a popup-list style as the decision was that General williamr@2: * Settings will use list-pane and all other apps. popup-list style. williamr@2: * It is the caller who selects the style so if spec. says otherwise, williamr@2: * this module still can be used. It is also possible to start the UI williamr@2: * without selection, so if any module has a 'linked/default/etc.' williamr@2: * access point and stored it's UID, the module can simply call the williamr@2: * editor part of the UI without having to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller can williamr@2: * simply call RunSettingsL(..). In case of selection, a lot of other williamr@2: * parameters can be specified to fulfil all requirements. There are williamr@2: * three types of Options menu available: EApSettingsSelMenuNormal, williamr@2: * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit, williamr@2: * delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal:Options menu specified in General Settings, williamr@2: * contains Edit, Delete, Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. This one makes it possible to select williamr@2: * an access point and also possible to edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, all types of williamr@2: * access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. Second filtering possibility williamr@2: * (aBearerFilter) is the desired bearer type. The possible values are williamr@2: * the values of the TApBearerType enum type and their combinations, as williamr@2: * in case of the ISP type. The ordering of the list can be specified williamr@2: * with the aSortType parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID of williamr@2: * the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID of williamr@2: * the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name of williamr@2: * the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name of williamr@2: * the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aDb A database to work on williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aReqIpvType Specifies whether the caller would like to williamr@2: * have IPv4, IPv6 or both access points. If it is IPv6 or Both, williamr@2: * in case of IPv6 support is available as a feature, it will be williamr@2: * supported. If IPv6 feature is not supported by the phone, it williamr@2: * simply defaults to the normal IPv4 version. williamr@2: * If it is IPv4, it uses the default IPv4 version independently williamr@2: * from IPv6 feature beeing available or not. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: CActiveApDb& aDb, williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TInt aReqIpvType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object.It is customizable through the williamr@2: * parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, one is williamr@2: * list pane used by General Settings which provides the list in a williamr@2: * list-pane. The other layout is for the other applications requiring williamr@2: * access point selection, a popup-list style as the decision was that williamr@2: * General Settings will use list-pane and all other apps. popup-list williamr@2: * style. It is the caller who selects the style so if spec. says williamr@2: * otherwise, this module still can be used. williamr@2: * It is also possible to start the UI without selection, so if any williamr@2: * module has a 'linked/default/etc.' access point and stored it's UID, williamr@2: * the module can simply call the editor part of the UI without having williamr@2: * to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller williamr@2: * can simply call RunSettingsL(..). williamr@2: * In case of selection, a lot of other parameters can be specified to williamr@2: * fulfil all requirements. There are three types of Options menu williamr@2: * available: EApSettingsSelMenuNormal, EApSettingsSelMenuSelectOnly, williamr@2: * EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit, williamr@2: * delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal:Options menu specified in General Settings, williamr@2: * contains Edit, Delete, Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. This one makes it possible to select williamr@2: * an access point and also possible to edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, all types of williamr@2: * access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. williamr@2: * Second filtering possibility (aBearerFilter) is the desired bearer williamr@2: * type. The possible values are the values of the TApBearerType enum williamr@2: * type and their combinations, as in case of the ISP type. williamr@2: * The ordering of the list can be specified with the aSortType williamr@2: * parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID of williamr@2: * the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID of williamr@2: * the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name of williamr@2: * the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name of williamr@2: * the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aReqIpvType Specifies whether the caller would like to williamr@2: * have IPv4, IPv6 or both access points. If it is IPv6 or Both, williamr@2: * in case of IPv6 support is available as a feature, it will be williamr@2: * supported. If IPv6 feature is not supported by the phone, it williamr@2: * simply defaults to the normal IPv4 version. williamr@2: * If it is IPv4, it uses the default IPv4 version independently williamr@2: * from IPv6 feature beeing available or not. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TInt aReqIpvType, williamr@2: TVpnFilterType aVpnFilterType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object. It is customizable through williamr@2: * the parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, one is list williamr@2: * pane used by General Settings which provides the list in a list-pane. williamr@2: * The other layout is for the other applications requiring access point williamr@2: * selection, a popup-list style as the decision was that General williamr@2: * Settings will use list-pane and all other apps. popup-list style. williamr@2: * It is the caller who selects the style so if spec. says otherwise, williamr@2: * this module still can be used. It is also possible to start the UI williamr@2: * without selection, so if any module has a 'linked/default/etc.' williamr@2: * access point and stored it's UID, the module can simply call the williamr@2: * editor part of the UI without having to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller can williamr@2: * simply call RunSettingsL(..). In case of selection, a lot of other williamr@2: * parameters can be specified to fulfil all requirements. There are williamr@2: * three types of Options menu available: EApSettingsSelMenuNormal, williamr@2: * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit, williamr@2: * delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal:Options menu specified in General Settings, williamr@2: * contains Edit, Delete, Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. This one makes it possible to select williamr@2: * an access point and also possible to edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, all types of williamr@2: * access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. Second filtering possibility williamr@2: * (aBearerFilter) is the desired bearer type. The possible values are williamr@2: * the values of the TApBearerType enum type and their combinations, as williamr@2: * in case of the ISP type. The ordering of the list can be specified williamr@2: * with the aSortType parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID of williamr@2: * the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID of williamr@2: * the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name of williamr@2: * the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name of williamr@2: * the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aDb A database to work on williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aReqIpvType Specifies whether the caller would like to williamr@2: * have IPv4, IPv6 or both access points. If it is IPv6 or Both, williamr@2: * in case of IPv6 support is available as a feature, it will be williamr@2: * supported. If IPv6 feature is not supported by the phone, it williamr@2: * simply defaults to the normal IPv4 version. williamr@2: * If it is IPv4, it uses the default IPv4 version independently williamr@2: * from IPv6 feature beeing available or not. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: CActiveApDb& aDb, williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TInt aReqIpvType, williamr@2: TVpnFilterType aVpnFilterType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Two-phased constructor. Leaves on failure. williamr@2: * This function shall be used to create the access point williamr@2: * settings/selection handling UI object. It is customizable through williamr@2: * the parameters. This object is a small layer above the UI part and williamr@2: * it provides a standard interface to select, edit, create access williamr@2: * points. It has two main parts, Select and Edit. The first parameter, williamr@2: * aStartWithSelection gives whether we would like to select or edit. williamr@2: * In case of selection, there is the possibility to use this module in williamr@2: * many applications. For this, two layouts are implemented, one is list williamr@2: * pane used by General Settings which provides the list in a list-pane. williamr@2: * The other layout is for the other applications requiring access point williamr@2: * selection, a popup-list style as the decision was that General williamr@2: * Settings will use list-pane and all other apps. popup-list style. williamr@2: * It is the caller who selects the style so if spec. says otherwise, williamr@2: * this module still can be used. It is also possible to start the UI williamr@2: * without selection, so if any module has a 'linked/default/etc.' williamr@2: * access point and stored it's UID, the module can simply call the williamr@2: * editor part of the UI without having to select the AP once more. williamr@2: * In case of editing only, (aStartWithSelection is EFalse), all other williamr@2: * construction parameters are ignored and after construction caller can williamr@2: * simply call RunSettingsL(..). In case of selection, a lot of other williamr@2: * parameters can be specified to fulfil all requirements. There are williamr@2: * three types of Options menu available: EApSettingsSelMenuNormal, williamr@2: * EApSettingsSelMenuSelectOnly, EApSettingsSelMenuSelectNormal. williamr@2: *
williamr@2: *-EApSettingsSelMenuSelectOnly: Only Select is visible, no way to edit, williamr@2: * delete, create, etc. williamr@2: *
williamr@2: * -EApSettingsSelMenuNormal:Options menu specified in General Settings, williamr@2: * contains Edit, Delete, Create new, etc. menu items. williamr@2: *
williamr@2: * -EApSettingsSelMenuSelectNormal: Same as in EApSettingsSelMenuNormal williamr@2: * BUT the first item is Select. This one makes it possible to select williamr@2: * an access point and also possible to edit, create, delete, etc. williamr@2: *
williamr@2: * The following three parameters specify the filtering and ordering williamr@2: * criteria for the selection list creation. First, it is possible to williamr@2: * specify which ISP-type we are looking for. The possible values are: williamr@2: *
williamr@2: * KEApIspTypeInternetOnly: Filter allows only access points that are williamr@2: * capable of only internet access. williamr@2: *
williamr@2: * KEApIspTypeWAPOnly: Filter allows only access points that are williamr@2: * capable of only WAP access. williamr@2: *
williamr@2: * KEApIspTypeInternetAndWAP: Filter allows only access points that are williamr@2: * capable of internet AND WAP access. williamr@2: *
williamr@2: * KEApIspTypeWAPMandatory: Filter allows only access points that are williamr@2: * capable of WAP access AND contain mandatory WAP settings. williamr@2: *
williamr@2: * KEApIspTypeAll: No filtering is done for the isp-type, all types of williamr@2: * access points are shown. williamr@2: *
williamr@2: * It is possible to combine them by simply adding/or-ing together the williamr@2: * values, filtering will be done in such a way that only access points williamr@2: * with the listed ISP-types will be shown. Second filtering possibility williamr@2: * (aBearerFilter) is the desired bearer type. The possible values are williamr@2: * the values of the TApBearerType enum type and their combinations, as williamr@2: * in case of the ISP type. The ordering of the list can be specified williamr@2: * with the aSortType parameter. It can have the following values: williamr@2: * KEApSortUidAscending: The sorting is done according to the ID of williamr@2: * the access points in ascending order. williamr@2: * KEApSortUidDescending: The sorting is done according to the ID of williamr@2: * the access points in descending order. williamr@2: * KEApSortNameAscending: The sorting is done according to the name of williamr@2: * the access points in ascending order. williamr@2: * KEApSortNameDescending: The sorting is done according to the name of williamr@2: * the access points in descending order. williamr@2: * Caution! The ordering values can not be combined! williamr@2: * @param aDb A database to work on williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aReqIpvType Specifies whether the caller would like to williamr@2: * have IPv4, IPv6 or both access points. If it is IPv6 or Both, williamr@2: * in case of IPv6 support is available as a feature, it will be williamr@2: * supported. If IPv6 feature is not supported by the phone, it williamr@2: * simply defaults to the normal IPv4 version. williamr@2: * If it is IPv4, it uses the default IPv4 version independently williamr@2: * from IPv6 feature beeing available or not. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * @param aIncludeEasyWlan a TBool indicating whether it should williamr@2: * include the easy wlan AP in the list or not. williamr@2: * @return The constructed CApSettingsHandler object. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static CApSettingsHandler* NewLC( williamr@2: CActiveApDb& aDb, williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TInt aReqIpvType, williamr@2: TVpnFilterType aVpnFilterType, williamr@2: TBool aIncludeEasyWlan williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Destructor. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C ~CApSettingsHandler(); williamr@2: williamr@2: williamr@2: protected: williamr@2: /** williamr@2: * Constructor. williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C CApSettingsHandler( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType williamr@2: ); williamr@2: williamr@2: /** williamr@2: * Constructor. williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aHelpMajor Major help ID williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C CApSettingsHandler( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TUid aHelpMajor williamr@2: ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Constructor. williamr@2: * @param aStartWithSelection A boolean value indicating whether to williamr@2: * select or edit an ap. williamr@2: * @param aListType A TSelectionListType enum indicating the desired williamr@2: * list type. williamr@2: * @param aSelMenuType A TSelectionMenuType enum indicating the desired williamr@2: * menu type. williamr@2: * @param aNeedIpv6Support Whether IPv6 is supported or not williamr@2: */ williamr@2: CApSettingsHandler( williamr@2: TBool aStartWithSelection, williamr@2: TSelectionListType aListType, williamr@2: TSelectionMenuType aSelMenuType, williamr@2: TBool aNeedIpv6Support williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase constructor. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void ConstructL( williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType williamr@2: ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase constructor. williamr@2: * @param aDb A database to work on williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void ConstructL( williamr@2: CActiveApDb& aDb, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType williamr@2: ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase constructor. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void ConstructL( williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TVpnFilterType aVpnFilterType williamr@2: ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase constructor. williamr@2: * @param aDb A database to work on williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void ConstructL( williamr@2: CActiveApDb& aDb, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TVpnFilterType aVpnFilterType williamr@2: ); williamr@2: williamr@2: williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase constructor. williamr@2: * @param aDb A database to work on williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * @param aIncludeEasyWlan a TBool indicating whether it should williamr@2: * include the easy wlan AP in the list or not. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void ConstructL( williamr@2: CActiveApDb& aDb, williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType, williamr@2: TVpnFilterType aVpnFilterType, williamr@2: TBool aIncludeEasyWlan williamr@2: ); williamr@2: williamr@2: williamr@2: public: // New functions williamr@2: /** williamr@2: * Sets the filtering used in the access point selection. williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @return No return value. Leaves on error. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void SetFilterL( williamr@2: TInt aIspFilter, williamr@2: TInt aBearerFilter, williamr@2: TInt aSortType williamr@2: ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Sets possible overrides of some texts. williamr@2: * By default, text is read from resources. This provides a way to williamr@2: * change some of the text to a caller-supplied one. The text must williamr@2: * be read from resource and must be already localized. williamr@2: * More than one text can be substituted, they are stored internally williamr@2: * in an array. williamr@2: * Currently not supported and supporting it is under discussion. williamr@2: * @param aText2Change TTextID to identify the text to be replaced with williamr@2: * @param aNewText Reference to the substitute text. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C void SetTextOverrideL( TTextID aText2Change, williamr@2: const TDesC& aNewText ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Gets possible overrides of a text. williamr@2: * By default, text is read from resources. This provides a way to williamr@2: * change some of the text to a caller-supplied one. The text must williamr@2: * be read from resource and must be already localized. williamr@2: * More than one text can be substituted, they are stored internally williamr@2: * in an array. williamr@2: * Currently not supported and supporting it is under discussion williamr@2: * @param aTextID TTextID type to identify the text to be replaced with williamr@2: * @return Reference to the substitute text. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C const TDesC& TextOverrideL( TTextID aTextId ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Starts the settings component. williamr@2: * Creates dialog(s) from scratch, launches and executes them. williamr@2: * Can leave with error codes. williamr@2: * @param TUint32 aHighlight The UID of the AP to highlight by default williamr@2: * @param TUint32 aSelected The UID of the access point selected williamr@2: * by the user. williamr@2: * @return The accomplished task's flag-codes: williamr@2: *
williamr@2: * KApUiEventNone, williamr@2: *
williamr@2: * KApUiEventSelected, williamr@2: *
williamr@2: * KApUiEventCreatedBlank, williamr@2: *
williamr@2: * KApUiEventCreatedUsedOld, williamr@2: *
williamr@2: * KApUiEventEdited, williamr@2: *
williamr@2: * KApUiEventDeleted, williamr@2: *
williamr@2: * KApUiEventExitRequested williamr@2: *
and their combinations. ( Bitwise OR ) williamr@2: *
williamr@2: * aSelected will be modified only if KApUiEventSelected is included williamr@2: * in the flags. williamr@2: *
williamr@2: * In case it returns KApUiEventExitRequested, the user had choosen williamr@2: * the Exit option from the Options menu which means williamr@2: * that the caller application MUST exit! williamr@2: *
williamr@2: * Returns after completion! williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C TInt RunSettingsL( TUint32 aHighLight, TUint32& aSelected ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Component Validation Test. williamr@2: * @return KErrNone. williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C static TInt Cvt(); williamr@2: williamr@2: williamr@2: protected: // New functions williamr@2: /** williamr@2: * @Deprecated williamr@2: * Starts the settings component. williamr@2: * Creates dialog(s) from scratch, launches and executes them. williamr@2: * In case of error, leaves with error codes. williamr@2: * @param TUint32 aHighlight The UID of the AP to highlight by default williamr@2: * @param TUint32 aSelected The UID of the AP selected by the user williamr@2: * @return The accomplished task's flag-codes: williamr@2: *
williamr@2: * KApUiEventNone, williamr@2: *
williamr@2: * KApUiEventSelected, williamr@2: *
williamr@2: * KApUiEventCreatedBlank, williamr@2: *
williamr@2: * KApUiEventCreatedUsedOld, williamr@2: *
williamr@2: * KApUiEventEdited, williamr@2: *
williamr@2: * KApUiEventDeleted williamr@2: *
williamr@2: * and their combinations. ( Bitwise OR ) williamr@2: *
williamr@2: * aSelected will be modified only if KApUiEventSelected is included williamr@2: * in the flags. williamr@2: *
williamr@2: * Returns after completion! williamr@2: */ williamr@2: TInt DoRunSettingsL( TUint32 aHighLight, TUint32& aSelected ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Starts the viewer component. williamr@2: * Creates dialog(s) from scratch, launches and executes it. williamr@2: * In case of error, leaves with error codes. williamr@2: * @param TUint32 aUid The UID of the AP to view/edit williamr@2: * @return Returns the completed task's flags williamr@2: * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank, williamr@2: * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted, williamr@2: * KApUiEventExitRequested and their combinations. ( Bitwise OR ) williamr@2: * In case it returns KApUiEventExitRequested, the user had choosen williamr@2: * the Exit option from the Options menu which means williamr@2: * that the caller application MUST exit! williamr@2: *
williamr@2: * Returns after completion! williamr@2: * williamr@2: * @deprecated williamr@2: */ williamr@2: IMPORT_C TInt RunViewerL( TUint32 aUid ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Starts the viewer component. williamr@2: * Creates dialog(s) from scratch, launches and executes it. williamr@2: * In case of error, leaves with error codes. williamr@2: * @param TUint32 aUid The UID of the AP to view/edit williamr@2: * @return Returns the completed task's flags williamr@2: * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank, williamr@2: * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted, williamr@2: * KApUiEventExitRequested and their combinations. ( Bitwise OR ) williamr@2: * Returns after completion! williamr@2: */ williamr@2: TInt DoRunViewerL( TUint32 aUid ); williamr@2: williamr@2: williamr@2: // handles the Delete access Point command. williamr@2: // @Deprecated williamr@2: void HandleApDeleteCmdL( TUint32 aUid, TBool aIsLast ); williamr@2: williamr@2: williamr@2: // handles the Create blank new access Point command. williamr@2: // @Deprecated williamr@2: TUint32 HandleApBlankNewL( TInt aBearers, TInt aIsps ); williamr@2: williamr@2: williamr@2: // handles the Create new access Point by using existing one command. williamr@2: // @Deprecated williamr@2: TUint32 HandleApUseOldNewL(); williamr@2: williamr@2: williamr@2: // handles the Editing of the newly created access Point. williamr@2: // @Deprecated williamr@2: TUint32 EditAfterCreateL( TUint32 aUid, williamr@2: CApAccessPointItem* aItem = NULL ); williamr@2: williamr@2: williamr@2: /** williamr@2: * Second-phase internal constructor. williamr@2: * @param aDb A database to work on williamr@2: * @param aIspTypeFilter Filtering criteria on ISP type williamr@2: * @param aBearerFilter Filtering criteria on bearer type williamr@2: * @param aSortType Specifies the sort order to use. williamr@2: * @param aVpnFilterType a TVpnFilterType representing the possible williamr@2: * additional VPN filtering. williamr@2: * @param aIncludeEasyWlan a TBool indicating whether it should williamr@2: * include the easy wlan AP in the list or not. williamr@2: */ williamr@2: void DoConstructL( CActiveApDb* aDb, TInt aIspFilter, williamr@2: TInt aBearerFilter, TInt aSortType, williamr@2: TVpnFilterType aVpnFilterType, williamr@2: TBool aIncludeEasyWlan ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Starts the selector component as a list williamr@2: * Creates dialog(s) from scratch, launches and executes them. williamr@2: * In case of error, leaves with error codes. williamr@2: * @param TUint32 aHighlight The UID of the AP to highlight by default williamr@2: * @param TUint32 aSelected The UID of the AP selected by the user williamr@2: * @return The accomplished task's flag-codes: williamr@2: *
williamr@2: * KApUiEventNone, williamr@2: *
williamr@2: * KApUiEventSelected, williamr@2: *
williamr@2: * KApUiEventCreatedBlank, williamr@2: *
williamr@2: * KApUiEventCreatedUsedOld, williamr@2: *
williamr@2: * KApUiEventEdited, williamr@2: *
williamr@2: * KApUiEventDeleted williamr@2: *
williamr@2: * and their combinations. ( Bitwise OR ) williamr@2: *
williamr@2: * aSelected will be modified only if KApUiEventSelected is included williamr@2: * in the flags. williamr@2: *
williamr@2: * Returns after completion! williamr@2: */ williamr@2: void DoRunListSettingsL( TUint32 aHighLight, TUint32& aSelected ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Starts the selector component in a setting page williamr@2: * Creates dialog(s) from scratch, launches and executes them. williamr@2: * In case of error, leaves with error codes. williamr@2: * @param TUint32 aHighlight The UID of the AP to highlight by default williamr@2: * @param TUint32 aSelected The UID of the AP selected by the user williamr@2: * @return The accomplished task's flag-codes: williamr@2: *
williamr@2: * KApUiEventNone, williamr@2: *
williamr@2: * KApUiEventSelected, williamr@2: *
williamr@2: * KApUiEventCreatedBlank, williamr@2: *
williamr@2: * KApUiEventCreatedUsedOld, williamr@2: *
williamr@2: * KApUiEventEdited, williamr@2: *
williamr@2: * KApUiEventDeleted williamr@2: *
williamr@2: * and their combinations. ( Bitwise OR ) williamr@2: *
williamr@2: * aSelected will be modified only if KApUiEventSelected is included williamr@2: * in the flags. williamr@2: *
williamr@2: * Returns after completion! williamr@2: */ williamr@2: void DoRunSetPageSettingsL( TUint32 aHighLight, TUint32& aSelected ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * handles the Create new access Point by using existing one command. williamr@2: * Called after user has selected the AP to copy williamr@2: * Creates the new Ap and offers it for editing. williamr@2: * @param aSelected The UID of the AP to copy. Shall not be KErrNone. williamr@2: * @return The UID of the newly created Ap williamr@2: */ williamr@2: TUint32 DoHandleApUseOldNewL( TUint32 aSelected ); williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Selects the Ap to Copy, returns its UID. williamr@2: * If not selected, KErrNone is returned williamr@2: */ williamr@2: TUint32 SelectApToCopyL(); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * handles the Create blank new access Point command. williamr@2: */ williamr@2: TUint32 DoHandleApBlankNewL( TInt aBearers, TInt aIsps ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * handles the Delete network group command. williamr@2: * @param aUid The uid of the network to delete williamr@2: */ williamr@2: void HandleNetworkDeleteCmdL( TUint32 aUid ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Gets the local variant value williamr@2: * @return A TInt stating the variant williamr@2: */ williamr@2: TInt GetVariantL(); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Gets confirmation about deleting an access point williamr@2: * @param aUid A TUint32 holding the WAP access point ID of the williamr@2: * access point to be deleted. williamr@2: * @param aIsLast A TBool specifying whether the access point to be williamr@2: * deleted is the last one or not. williamr@2: * @return A TInt stating the result williamr@2: */ williamr@2: TInt ConfirmDeleteL( TUint32 aUid, TBool aIsLast ); williamr@2: williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Wrapper for the public API williamr@2: */ williamr@2: void HandleRunSettingsL( TUint32 aHighLight, TUint32& aSelected ); williamr@2: williamr@2: williamr@2: protected: // Functions from base classes williamr@2: williamr@2: friend class CApSettingsDlg; williamr@2: friend class CApSelectorDialog; williamr@2: friend class CApSelPopupList; williamr@2: friend class CApNetSelPopupList; williamr@2: williamr@2: private: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Selects an appropriate bearer type for a given item according to williamr@2: * the current filtering criterias williamr@2: * @param aBearers The current bearer filter set williamr@2: * @param aItem The CApAccessPointItem whoose bearer type is to be set. williamr@2: */ williamr@2: void ChooseBearerTypeL( TInt aBearers, CApAccessPointItem& aItem ); williamr@2: williamr@2: /** williamr@2: * @Deprecated williamr@2: * Duplciates an existing access point identified by the passed WAP ID williamr@2: * @param aUid The WAP Access Point ID of the access point to duplicate williamr@2: * @return The WAP Access Point ID of the newly created access point. williamr@2: */ williamr@2: TUint32 HandleDuplicateL( TUint32 aUid ); williamr@2: williamr@2: williamr@2: private: //data williamr@2: TBool iStartWithSelection; williamr@2: TSelectionListType iListType; williamr@2: TSelectionMenuType iSelMenuType; williamr@2: williamr@2: TInt iIspFilter; williamr@2: TInt iBearerFilter; williamr@2: TApSetHandlerExtra* iExt; // Extra data holder structure williamr@2: williamr@2: TInt iReqIpvType; // Default is IPv4 williamr@2: williamr@2: // replacing iModel with iImpl, no size change williamr@2: // CApSettingsModel* iModel; williamr@2: CApSettingsHandlerImpl* iImpl; // owned williamr@2: williamr@2: CTextOverrides* iTextOverrides; williamr@2: TUint32 iEventStore; // to hold the events williamr@2: TUid iHelpMajor; williamr@2: williamr@2: #ifdef __TEST_OOMDEBUG williamr@2: TBool iMemTestOn; williamr@2: #endif // __TEST_OOMDEBUG williamr@2: williamr@2: }; williamr@2: williamr@2: #endif williamr@2: williamr@2: // End of File