release_notes.txt

symbian touch 平台动态设置选择框

About the DynamicSettingList v 1.1
----------------------------------
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
------------
CAknSliderSettingItem has a  fault that occurs at least 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.

Touch UI support
----------------
It's important that CExampleSettingList use same window than 
CDynamicSettingListAppView.
In CDynamicSettingListAppView source it's done by 
iItemList->SetContainerWindowL(*this)

CExampleSettingList have to implement virtual method 
void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType);
where must listen EEventItemDoubleClicked event.


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

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

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


COMPATIBILITY
------------------
S60 3rd Edition, MR

Tested with N95, E61i

Created with S60 3rd Edition, MR

--------------------------------------------------------------------------------

VERSION HISTORY        

1.1    TUI support added.
1.0    First release.

--------------------------------------------------------------------------------


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