release_notes.txt

Symbian 中动态生成SettingList

About the DynamicSettingList
----------------------------
This example demonstrates how to load CAknSettingItemList dynamically at run time instead of defining 
the list structure into a 
resource file. In the example, the lists are loaded during application startup.

The example can be used as the basis for many different applications where a list has to be loaded 
dynamically (for instance, based on external
feed from a server).

Note that CAknSettingItemList itself is not ideal for dynamic loading, but it is possible by using dummy 
resource IDs and defining all the required  
list item types in the source code. At run time it is then possible to load multiple instances of each list 
item type (with any 
label and value).


Prerequisites
------------
- Symbian OS key concepts


Important classes
-----------------
CDynamicSettingListAppView
- Loads the setting list dynamically.


Known issues
------------

CAknPasswordSettingItem has known issues in S60 2nd and 3rd Edition.

This example can be modified to support S60 1st Edition by removing all references to 
CAknTimeOffsetSettingItem, which is not supported in S60 1st Edition.

CAknSliderSettingItem has a  fault that occurs at least in S60 2nd Edition emulator debug builds and in 
3rd Edition gcce builds. This fault prevents creating CAknSliderSettingItem dynamically. A workaround is 
to create a proprietary slider setting item and inherit it from CAknSliderSettingItem 
(see CDynamicSettingListSlider.h). Then override 
CAknSliderSettingItem::CreateAndExecuteSettingPageL 
and use the solution pointed out in CDynamicSettingListSlider::CreateAndExecuteSettingPageL.


Installation instructions
-------------------------
-------------------------

MOBILE DEVICE
------------------
Go to /DynamicSettingList/group
bldmake bldfiles
abld build thumb urel
Go to /DynamicSettingList/sis
Edit the DynamicSettingList.pkg's paths to match those on your system.
makesis DynamicSettingList.pkg
Install the .sis file to your device

EMULATOR
------------------
Go to /DynamicSettingList/group
bldmake bldfiles
abld build wins udeb
Start the emulator


COMPATIBILITY
------------------
S60 2nd Edition
S60 3rd Edition 
(S60 1st Edition with minor changes, see Known issues)
TESTED ON Nokia 6600, Nokia 6670, Nokia 6630, Nokia N90, Nokia E60
created / tested with Series 60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2, For C++ 
Supporting Metrowerks CodeWarrior

EVALUATE THIS RESOURCE
----------------------------

Please spare a moment to help us improve documentation quality and recognize the examples you find most 
valuable, by rating this resource at 
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId= 
2e80a6f4-9d9b-45d1-b268-d01b862a7023/S60_Platform_Dynamic_Setting_List_Example_v1_0.zip.