Menu list

Menu lists are used to select one item from a list and do nothing else; the Options command is not available when a menu list is being browsed (the Options menu itself is a menu list).

If a high-priority event, such as an incoming call, occurs when a menu list is open, the list is cancelled and the new event takes control. These lists are often displayed inside a pop-up window.

The default keypad functions in a menu list are the following:

Table: Default key events in a menu list
Key Action

Arrow up / down

Moves the focus in the list.

Arrow left / right

Ignored (unless there is a submenu; see Submenus).

Selection key

Selects the item, does the associated function.

Left softkey (Select)

Selects the item, does the associated function.

Right softkey (Cancel)

Dismisses the menu; returns to the state preceding the opening of the menu.

Call creation key, Edit key

Ignored.

Numeric keypad

Ignored.

Clear key

Ignored.

Other keys

Dismiss the menu and do the default action of the key.

Figure: Options menu

Using menu lists in C++ applications

The API to use for menu lists is the Lists API. For implementation information, see Using the Lists API.