Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Carbide.c++ Tutorial 4 - Creating a Settings view

From Wiki
Jump to: navigation, search

This Symbian C++ code example shows how to create a settings view using the Carbide.c++ UI Designer.

Article Metadata
Code Example
Source file:
Created: vdharankar (20 Sep 2009)
Last edited: hamishwillee (14 Feb 2012)



In tutorial 3 an example demonstration of, how to create a simple list box using View has been give. This tutorial is continuation of the tutorial 3. As in this tutorial we are going to design and create a view using UI designer. The view will show the use of control and editors which can be used in settings view.

The example has a view with one Text Editor control.


Follow Tutorial one in order to understand basics of creating and running an application: Carbide.c++ Tutorial 1 - Helloworld

And follow Carbide.c++ Tutorial 3 - Using List view to see how to create a view based application using UI designer.

Step 1 - Start a new project

Start with a new project using Carbide.c++ IDE, call it "settings" ( or whatever you like). Once you are done with all basic steps you will see this window. In this step you will need to select the settings view type.

Settings demo 1.JPG

After this step select all defaults and end up with the usual UI designer. In UI designer see various controls and Editors which can be added to settings view.

Settings demo 2.JPG

Settings demo 3.JPG

Step 2 - Adding a Text Editor

Now drag a Text Editor from "Editors" to view. The view will look as follows

Settings demo 4.JPG

Now remove the default text from Text Editor as follows

Settings demo 5.JPG

Step 3 - Configuring right softkey

Next step is to change the right softkey, which will trigger an action to show the entered "text" in settings (Text Editor). This will show how you can read the entered settings. This will also give an idea how the overall code generated in background works.

Double click on right softkey and edit it as shown in following image.

Important:When the right menu on CBR (i.e Menu Bar) or softkey is edited, the left softkey title disappears but this is nothing to worry. Simply retype the left softkey title by double clicking on empty space on right side on menu bar.

Settings demo 6.JPG

The menu now has both soft-keys with title.

Settings demo 7.JPG

Step 4 - Handling the softkey event

Now we have an application with all necessary UI designed with UI designer. Lets add the code to make it working. Add the event handler for the right softkey from menu bar. Generating the event handler code has been explained in Tutorial 1.

Select the events section, make sure that the menu bar is selected. Events section will show two events one for right softkey and second for left softkey. Select the right softkey menu event and double click in the empty space in the next column.

Settings demo 8.JPG

Type down the code shown in the following image.

Settings demo 9.JPG

Step 5 - Running the application

Build the code and run the application in emulator. Following will be the output.

Settings demo 10.JPG

Settings demo 11.JPG

Success ! we are done with a basic application which shows how to use settings and related controls/editors.


Several editors and controls are available, which can be used with settings view. This tutorial show how to design the basic settings view with a simple editor.

Source code

This page was last modified on 14 February 2012, at 04:33.
43 page views in the last 30 days.