Categories: S60 3rd Edition, Feature Pack 2 | Web Runtime (WRT) | Code Examples | JavaScript/ECMAScript

This page was last modified 12:30, 2 May 2008.

From Forum Nokia Wiki

Knowledge Base Home

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

Image:Listbox.zip