SettingExample

S60 Platform: Settings Screen Example v2.1 ------------------------------------------------- This C++ code example explains the basic construction of settings screens, including setting item lists, setting items, and setting pages. The application consists of a single view - a Setting List that has a variety of different types of settings that can be manipulated. Changes to settings are saved when the program exits. Note that no container class is implemented to hold the controls for the view since the only control (the Setting List) is owned directly by the view class. The application has been tested to be compatible with S60 5th Edition and Touch UI. -------------------------------------------------------------------------------- PREREQUISITES Symbian C++ basics -------------------------------------------------------------------------------- IMPORTANT FILES/CLASSES src\SettingExampleSettingList.cpp - Creating setting items CSettingListView (derived from CAKnView): - The only view of this application CSettingsData (derived from CBase): - A data object encapsulating the data represented by the settings. Here the data object is created and owned by the AppUi class, and passed into the constructor of the view class and from there into the Setting List control. Important classes: CAknView, CAknSettingItem, CAknSettingItemList, CAknEnumeratedTextSettingItem, CSelectionItemList -------------------------------------------------------------------------------- KNOWN ISSUES - After launching the setting page for an item of type CAknPasswordSettingItem, changes to the password are not automatically updated for the setting list unless UpdateListBoxTextL() is explicitly called on the setting item. This is already taken care of in this example; see the implementation of EditCurrentItemL() in SettingExampleSettingList.cpp. -------------------------------------------------------------------------------- RUNNING THE EXAMPLE When the application is started, select the setting item and edit it. When the example application is started, you will be presented with a setting list. Using the navigation keys you can move up and down the list selecting items to edit. Pressing the joystick or selecting "edit" from the menu will bring up the relevant Setting Item Page and allows you to edit the value displayed in the Setting List. Data is saved to settings.dat when the program exits. -------------------------------------------------------------------------------- BUILD & INSTALLATION INSTRUCTIONS Steps for building and installing the application to a device depend on the S60 platform version: --Mobile device (S60 3rd Edition) cd to /SettingExample/group bldmake bldfiles abld build gcce urel cd to /SettingExample/sis Edit paths in SettingExample_S60_3_0_v_2_1_0.pkg to match those on your system. makesis SettingExample_S60_3_0_v_2_1_0.pkg Sign the SIS package - See the SDK Help for information about self-signed .sis packages, or www.symbiansigned.com for information about Developer Certificates. Install the signed .sis file to an S60 3rd Edition device. - If you get a "Certificate error" during installation of a self-signed package, check that App.Manager -> Settings -> Software Installation is set to "All". -------------------------------------------------------------------------------- COMPATIBILITY S60 5th Edition S60 3rd Edition, Feature Pack 2 S60 3rd Edition, Feature Pack 1 S60 3rd Edition Tested with Nokia 5800 XpressMusic, Nokia E61i, Nokia E90 Communicator, Nokia N95 Created / tested with S60 3rd Edition, MR SDK and S60 5th Edition SDK -------------------------------------------------------------------------------- TOUCH UI SUPPORT No changes required for S60 5th Edition or Touch UI. NOTE: CAknSettingItemList handles its listbox events in CAknSettingItemList::HandleListBoxEventL() and you should not override it. -------------------------------------------------------------------------------- VERSION HISTORY 2.1 Support for S60 5th Edition and Touch UI ensured. 2.0 Support added for S60 3rd Edition and Scalable UI. 1.0 First release. -------------------------------------------------------------------------------- RELATED DOCUMENTATION S60 Platform: Implementing Settings Screens (document published at forum.nokia.com). -------------------------------------------------------------------------------- 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=89f9c64b-db4c-4ee4-8099-057d2d2d062f/S60_Platform_Settings_Screen_Example_v2_1_en.zip