Collapse all Symbian^3 Application Developer Library

Choice list

Choice list is a list type, which allows selection from different choices. Choice list can either be closed (by default) state or opened state. In case the choice list is empty, the opening button is dimmed and is inactive.

Choice list displays currently selected value by default in closed state. When the choice list is opened, choice list pop-up displays the list of available options (with currently selected focused). Choice list can contain text, icons or combination of both text and icons. It is recommendation use only text in the choice list.

It is possible to dynamically add and remove items in choice list. The user can browse through the list with scroll keys or with the touch event.

Figure 1. Example of Choice list

Table 1. Default key events in a choice list
Key	Action
Enter	Selects the focused item and closes the choice list.
Left selection key ( Select )	Choice list item is selected.
Right selection key ( Close )	Choice list is closed without making a new selection.
Arrow left / right keys	Closes the choice list, with focused item selected.
Arrow up / down keys	Scrolls through the choice list. Choice list is looping.

Table 2. Default touch events for choice list interaction in closed state
User action	State change	Feedback
Touch down	Inactive, tooltip is shown.	Tactile: Basic tactile feedback is provided with touch down event. Basic list effect given with touch down event.
Touch release	Opens the choice list pop-up	Tactile: Pop-up open effect is given. If pop-up owns NGA effect and they are ON, then increasing long touch effect is provided with touch release.
Touch release	Inactive
Touch down and move out of the list	List continues its movement.	Basic tactile feedback is provided with touch down event. Refer to Dragging and flicking events.

Table 3. Default touch events for choice list interaction in opened state
User action	State change	Feedback
Touch down and release	Touch down moves the focus.	Pressed down highlight. Tactile: Basic tactile feedback is provided with touch down event. Basic list effect is provided with touch down event.
Touch release	Selects the focused item and closes the choice list.	Tactile: Basic list effect is provided with touch release event.
Touch down and move inside the choice list.	The whole list moves along with the finger. Refer to Dragging and flicking events	Tactile: Basic tactile feedback is provided with touch down event. Refer to Dragging and flicking events.
Touch down and move out of the choice list	The list continues its movement according to the finger movements outside the pop-up.	Tactile: Basic tactile feedback is provided with touch down event. Refer to Dragging and flicking events.
Touch down and release outside the opened choice list.	Inactive	Basic tactile feedback given with touch down event. No advanced tactile feedback.

Using choice list in applications

The API to use for choice list is the Choice list API . For implementation information, see Providing a vertical list of selectable items .

Parent topic: List types