From Forum Nokia Wiki

ID	CS000941	Creation date	May 2, 2008
Platform	S60 3rd Edition, FP2	Tested on devices
Category	S60 Web Runtime	Subcategory

Keywords (APIs, classes, methods, functions):

Purpose

This example Javascript code is intended for re-use and incorporation into larger projects.

Overview

ListBox is a graphical user interface library, written in JavaScript language and designed for the S60 Web Runtime platform. The library can be used mainly in Web widgets for S60 to display text information on a list view.

ListBox is controlled by the “keypress” event of the five-way navigation key (on S60 devices). Therefore, it requires the browsing mode of a widget to be set to “tabbed” mode (vs. “cursor” mode). ListBox, however, does not enforce this requirement automatically. Widgets which use the library will need to set the browsing mode accordingly. This gives the widgets a chance to mixed-use ListBox and other UI components that may require the “cursor” mode.

Public methods

 Constructor ListBox (Element [div] viewElement,
                      Integer maxVisibleLen,
                      Boolean sort)
 
 Void activateListBox ()
 
 Void deactivateListBox ()
 
 Void releaseResources ()
 
 Void setMaxVisible (Integer maxVisibleLen)
 
 Void setDisplayStyle (String unselectedStyle, String selectedStyle)
 
 String getSelectedItem ()
 
 Void addItem (String item)
 
 Void createList (Array newItems)
 
 Void removeItem ()
 
 Void filter (String argument)
 
 Callback function onRightNaviKeyPress()
 
 Callback function onLeftNaviKeyPress()
 
 Callback function onCenterNaviKeyPress ()
 
 Callback function onItemSelected ()

Example application

File:Listbox.zip