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 "Eclipse Public License v1.0" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: |
|
15 * 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 and will be fully removed between weeks 12 and 18 of 2010. See Polonium CR #153 for details. |
|
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 ); |
|
1135 |
|
1136 |
|
1137 /** |
|
1138 * @Deprecated |
|
1139 * Starts the viewer component. |
|
1140 * Creates dialog(s) from scratch, launches and executes it. |
|
1141 * In case of error, leaves with error codes. |
|
1142 * @param TUint32 aUid The UID of the AP to view/edit |
|
1143 * @return Returns the completed task's flags |
|
1144 * KApUiEventNone, KApUiEventSelected, KApUiEventCreatedBlank, |
|
1145 * KApUiEventCreatedUsedOld, KApUiEventEdited, KApUiEventDeleted, |
|
1146 * KApUiEventExitRequested and their combinations. ( Bitwise OR ) |
|
1147 * Returns after completion! |
|
1148 */ |
|
1149 TInt DoRunViewerL( TUint32 aUid ); |
|
1150 |
|
1151 |
|
1152 // handles the Delete access Point command. |
|
1153 // @Deprecated |
|
1154 void HandleApDeleteCmdL( TUint32 aUid, TBool aIsLast ); |
|
1155 |
|
1156 |
|
1157 // handles the Create blank new access Point command. |
|
1158 // @Deprecated |
|
1159 TUint32 HandleApBlankNewL( TInt aBearers, TInt aIsps ); |
|
1160 |
|
1161 |
|
1162 // handles the Create new access Point by using existing one command. |
|
1163 // @Deprecated |
|
1164 TUint32 HandleApUseOldNewL(); |
|
1165 |
|
1166 |
|
1167 // handles the Editing of the newly created access Point. |
|
1168 // @Deprecated |
|
1169 TUint32 EditAfterCreateL( TUint32 aUid, |
|
1170 CApAccessPointItem* aItem = NULL ); |
|
1171 |
|
1172 |
|
1173 /** |
|
1174 * Second-phase internal constructor. |
|
1175 * @param aDb A database to work on |
|
1176 * @param aIspTypeFilter Filtering criteria on ISP type |
|
1177 * @param aBearerFilter Filtering criteria on bearer type |
|
1178 * @param aSortType Specifies the sort order to use. |
|
1179 * @param aVpnFilterType a TVpnFilterType representing the possible |
|
1180 * additional VPN filtering. |
|
1181 * @param aIncludeEasyWlan a TBool indicating whether it should |
|
1182 * include the easy wlan AP in the list or not. |
|
1183 */ |
|
1184 void DoConstructL( CActiveApDb* aDb, TInt aIspFilter, |
|
1185 TInt aBearerFilter, TInt aSortType, |
|
1186 TVpnFilterType aVpnFilterType, |
|
1187 TBool aIncludeEasyWlan ); |
|
1188 |
|
1189 |
|
1190 /** |
|
1191 * @Deprecated |
|
1192 * Starts the selector component as a list |
|
1193 * Creates dialog(s) from scratch, launches and executes them. |
|
1194 * In case of error, leaves with error codes. |
|
1195 * @param TUint32 aHighlight The UID of the AP to highlight by default |
|
1196 * @param TUint32 aSelected The UID of the AP selected by the user |
|
1197 * @return The accomplished task's flag-codes: |
|
1198 * <br> |
|
1199 * KApUiEventNone, |
|
1200 * <br> |
|
1201 * KApUiEventSelected, |
|
1202 * <br> |
|
1203 * KApUiEventCreatedBlank, |
|
1204 * <br> |
|
1205 * KApUiEventCreatedUsedOld, |
|
1206 * <br> |
|
1207 * KApUiEventEdited, |
|
1208 * <br> |
|
1209 * KApUiEventDeleted |
|
1210 * <br> |
|
1211 * and their combinations. ( Bitwise OR ) |
|
1212 * <br> |
|
1213 * aSelected will be modified only if KApUiEventSelected is included |
|
1214 * in the flags. |
|
1215 * <br> |
|
1216 * Returns after completion! |
|
1217 */ |
|
1218 void DoRunListSettingsL( TUint32 aHighLight, TUint32& aSelected ); |
|
1219 |
|
1220 |
|
1221 /** |
|
1222 * @Deprecated |
|
1223 * Starts the selector component in a setting page |
|
1224 * Creates dialog(s) from scratch, launches and executes them. |
|
1225 * In case of error, leaves with error codes. |
|
1226 * @param TUint32 aHighlight The UID of the AP to highlight by default |
|
1227 * @param TUint32 aSelected The UID of the AP selected by the user |
|
1228 * @return The accomplished task's flag-codes: |
|
1229 * <br> |
|
1230 * KApUiEventNone, |
|
1231 * <br> |
|
1232 * KApUiEventSelected, |
|
1233 * <br> |
|
1234 * KApUiEventCreatedBlank, |
|
1235 * <br> |
|
1236 * KApUiEventCreatedUsedOld, |
|
1237 * <br> |
|
1238 * KApUiEventEdited, |
|
1239 * <br> |
|
1240 * KApUiEventDeleted |
|
1241 * <br> |
|
1242 * and their combinations. ( Bitwise OR ) |
|
1243 * <br> |
|
1244 * aSelected will be modified only if KApUiEventSelected is included |
|
1245 * in the flags. |
|
1246 * <br> |
|
1247 * Returns after completion! |
|
1248 */ |
|
1249 void DoRunSetPageSettingsL( TUint32 aHighLight, TUint32& aSelected ); |
|
1250 |
|
1251 |
|
1252 /** |
|
1253 * @Deprecated |
|
1254 * handles the Create new access Point by using existing one command. |
|
1255 * Called after user has selected the AP to copy |
|
1256 * Creates the new Ap and offers it for editing. |
|
1257 * @param aSelected The UID of the AP to copy. Shall not be KErrNone. |
|
1258 * @return The UID of the newly created Ap |
|
1259 */ |
|
1260 TUint32 DoHandleApUseOldNewL( TUint32 aSelected ); |
|
1261 |
|
1262 /** |
|
1263 * @Deprecated |
|
1264 * Selects the Ap to Copy, returns its UID. |
|
1265 * If not selected, KErrNone is returned |
|
1266 */ |
|
1267 TUint32 SelectApToCopyL(); |
|
1268 |
|
1269 |
|
1270 /** |
|
1271 * @Deprecated |
|
1272 * handles the Create blank new access Point command. |
|
1273 */ |
|
1274 TUint32 DoHandleApBlankNewL( TInt aBearers, TInt aIsps ); |
|
1275 |
|
1276 |
|
1277 /** |
|
1278 * @Deprecated |
|
1279 * handles the Delete network group command. |
|
1280 * @param aUid The uid of the network to delete |
|
1281 */ |
|
1282 void HandleNetworkDeleteCmdL( TUint32 aUid ); |
|
1283 |
|
1284 |
|
1285 /** |
|
1286 * @Deprecated |
|
1287 * Gets the local variant value |
|
1288 * @return A TInt stating the variant |
|
1289 */ |
|
1290 TInt GetVariantL(); |
|
1291 |
|
1292 |
|
1293 /** |
|
1294 * @Deprecated |
|
1295 * Gets confirmation about deleting an access point |
|
1296 * @param aUid A TUint32 holding the WAP access point ID of the |
|
1297 * access point to be deleted. |
|
1298 * @param aIsLast A TBool specifying whether the access point to be |
|
1299 * deleted is the last one or not. |
|
1300 * @return A TInt stating the result |
|
1301 */ |
|
1302 TInt ConfirmDeleteL( TUint32 aUid, TBool aIsLast ); |
|
1303 |
|
1304 |
|
1305 /** |
|
1306 * @Deprecated |
|
1307 * Wrapper for the public API |
|
1308 */ |
|
1309 void HandleRunSettingsL( TUint32 aHighLight, TUint32& aSelected ); |
|
1310 |
|
1311 |
|
1312 protected: // Functions from base classes |
|
1313 |
|
1314 friend class CApSettingsDlg; |
|
1315 friend class CApSelectorDialog; |
|
1316 friend class CApSelPopupList; |
|
1317 friend class CApNetSelPopupList; |
|
1318 |
|
1319 private: |
|
1320 /** |
|
1321 * @Deprecated |
|
1322 * Selects an appropriate bearer type for a given item according to |
|
1323 * the current filtering criterias |
|
1324 * @param aBearers The current bearer filter set |
|
1325 * @param aItem The CApAccessPointItem whoose bearer type is to be set. |
|
1326 */ |
|
1327 void ChooseBearerTypeL( TInt aBearers, CApAccessPointItem& aItem ); |
|
1328 |
|
1329 /** |
|
1330 * @Deprecated |
|
1331 * Duplciates an existing access point identified by the passed WAP ID |
|
1332 * @param aUid The WAP Access Point ID of the access point to duplicate |
|
1333 * @return The WAP Access Point ID of the newly created access point. |
|
1334 */ |
|
1335 TUint32 HandleDuplicateL( TUint32 aUid ); |
|
1336 |
|
1337 |
|
1338 private: //data |
|
1339 TBool iStartWithSelection; |
|
1340 TSelectionListType iListType; |
|
1341 TSelectionMenuType iSelMenuType; |
|
1342 |
|
1343 TInt iIspFilter; |
|
1344 TInt iBearerFilter; |
|
1345 TApSetHandlerExtra* iExt; // Extra data holder structure |
|
1346 |
|
1347 TInt iReqIpvType; // Default is IPv4 |
|
1348 |
|
1349 // replacing iModel with iImpl, no size change |
|
1350 // CApSettingsModel* iModel; |
|
1351 CApSettingsHandlerImpl* iImpl; // owned |
|
1352 |
|
1353 CTextOverrides* iTextOverrides; |
|
1354 TUint32 iEventStore; // to hold the events |
|
1355 TUid iHelpMajor; |
|
1356 |
|
1357 #ifdef __TEST_OOMDEBUG |
|
1358 TBool iMemTestOn; |
|
1359 #endif // __TEST_OOMDEBUG |
|
1360 |
|
1361 }; |
|
1362 |
|
1363 #endif |
|
1364 |
|
1365 // End of File |
|