Series 60 Developer Platform:
Implementing Settings
Screens
SERIES
60
PLATFORM
Version 1.0
January 23, 2004
Series 60 Developer Platform: Implementing Settings Screens | 2
Legal Notice
Copyright © 2004 Nokia Corporation. All rights reserved.
Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. Other
product and company names mentioned herein may be trademarks or trade names of their
respective owners.
Disclaimer
The information in this document is provided “as is,” with no warranties whatsoever,
including any warranty of merchantability, fitness for any particular purpose, or any warranty
otherwise arising out of any proposal, specification, or sample. Furthermore, information
provided in this document is preliminary, and may be changed substantially prior to final
release. This document is provided for informational purposes only.
Nokia Corporation disclaims all liability, including liability for infringement of any proprietary
rights, relating to implementation of information presented in this document. Nokia
Corporation does not warrant or represent that such use will not infringe such rights.
Nokia Corporation retains the right to make changes to this specification at any time, without
notice.
License
A license is hereby granted to download and print a copy of this specification for personal
use only. No other license to any other intellectual property rights is granted herein.
Version 1.0 | January 23, 2004
Series 60 Developer Platform: Implementing Settings Screens | 3
Contents
1. Introduction ......................................................................................................... 5
1.1 Purpose and Scope.........................................................................................................5
2. How and Why to Handle All Application Settings in a Single View................ 6
2.1 Setting Item Lists.............................................................................................................6
3. Setting Item Lists .............................................................................................. 11
4. Setting Items and Pages................................................................................... 13
4.1 Binary Controls..............................................................................................................13
4.2 Sliders and Volume Controls.........................................................................................14
4.2.1 Sliders...................................................................................................................14
4.2.2 Volume controls....................................................................................................16
4.3 Text and Numeric Editors..............................................................................................16
4.3.1 Text editors...........................................................................................................16
4.3.2 Numeric editors ....................................................................................................18
4.3.3 Secret editors .......................................................................................................18
4.3.4 Date editors ..........................................................................................................19
4.3.5 Time editors..........................................................................................................21
4.3.6 IP address editors.................................................................................................21
4.4 Radio Buttons................................................................................................................23
4.5 Check Boxes .................................................................................................................24
5. The Example Application.................................................................................. 26
5.1 Structure........................................................................................................................26
5.2 Building the Application.................................................................................................26
5.2.1 Emulator Build ......................................................................................................26
5.2.2 Target Build ..........................................................................................................26
5.3 User Interface................................................................................................................26
5.4 Check Boxes and Custom Setting Controls..................................................................27
6. Terms and Abbreviations ................................................................................. 28
Version 1.0 | January 23, 2004
Series 60 Developer Platform: Implementing Settings Screens | 4
Change History
January 23, 2004 1.0 Initial document release
Version 1.0 | January 23, 2004
Series 60 Developer Platform: Implementing Settings Screens | 5
1. Introduction
Settings screens enable a phone end user to view and manipulate application settings. They
are usually implemented with setting item lists. When the user selects a setting item, the
item can be edited either directly or via a setting page.
1.1 Purpose and Scope
This document describes the creation of settings screens for Series 60 applications. First,
an example explains the basic construction of settings screens, including setting item lists,
setting items, and setting pages. Then, the resource structures of these elements are
specified. Finally, most available setting pages as well as pop-up fields and pop-up lists are
described.
The targeted audience for this document is software developers with good knowledge of
C++ and basic knowledge of Symbian OS/Series 60 programming.
Version 1.0 | January 23, 2004
