There are many different controls for displaying content in a list. Here we show an example which makes it easier to choose which kind of list is most appropriate for each scenario and is straightforward to implement. You can download a zip file below, containing an example application as well as source code.

Download ListViews example>>

The application shows an implementation of four different list views.

Column list
CEikColumnListBox

A column list can be displayed with the options of marking a checkbox, having two columns and including one or two icons. During construction, many features can be configured, including text color, font and list position.

Text list
CEikTextListBox

This is a simple control that allows text to be displayed as a list. A few settings can be set during its construction, similar to column list.

Snaking list
CEikSnakingTextListBox

This is a horizontal list box that is intended for displaying text as columns which can be scrolled from right to left.

Hierarchical list
CeikHierarchicalListBox

The main features of this list type are the options to expand or collapse the list, and to reduce or increase the visible data based on its hierarchical structure.

To build the Listviews example for the smartphone, use the following:

$ bldmake bldfiles
$ abld build thumb urel
$ makesis LISTVIEWS.PKG

More information about Controls can be found in the Symbian OS UIQ 2.1 SDK documentation.