List

List responds to basic touch events as follows:

  • On S60 5th Edition devices, touch down and release on an unfocused list item changes the focus and selection. From Symbian^3 onwards and on Series 40 devices, touch down and release on an item changes only the selection, since no separate focusing is required.

  • For IMPLICIT Lists, on S60 5th Edition devices, touch down and release on a focused list item activates the corresponding select command. From Symbian^3 onwards and on Series 40 devices, the select command is activated on the first touch down and release. In addition, the select command label is never shown, whereas on S60 5th Edition devices the label is shown in the Options menu, provided the label is defined by the MIDlet. The default label is never shown.

    From Symbian^3 onwards, item-specific commands (of type OK and ITEM) are listed in the item-specific menu only. They are not listed the Options menu.

  • If a list item has multiple commands assigned to it, touch down and hold on the item opens a pop-up menu containing the commands. The pop-up menu corresponds to the context-specific Options menu of non-touch devices.

  • On S60 5th Edition devices, dragging scrolls the List with a changing focus highlight. From Symbian^3 onwards and on Series 40 devices, no focus highlight is shown while scrolling the list by dragging or flicking.

On S60 5th Edition devices, a focused list item has a permanent highlight. From Symbian^3 onwards and on Series 40 devices, list items do not have a permanent highlight, since UI elements are not focused separately. Instead, a list item is briefly highlighted when tapped, that is, the item is highlighted on touch down and the highlight disappears on touch release.

Note: For an IMPLICIT List, the getSelectedIndex method returns the index of the last selected item, regardless of whether the highlight is shown. When the IMPLICIT List is first shown on the screen, the getSelectedIndex method returns the index of the first list item. Since IMPLICIT Lists are meant for selecting a single action, do not use multiple commands for item-specific actions.

List supports a scrollbar:

  • On Series 40 devices, a scrollbar is shown only when the list needs scrolling. The scrollbar is purely informational and therefore non-interactive. Dragging or flicking the list scrolls it.

  • On S60 5th Edition devices, a scrollbar is always shown, even when the list does not need scrolling. From Symbian^3 onwards, the scrollbar is shown only when the list needs scrolling. The scrollbar is touch-enabled. Dragging the scrollbar scrolls the list. The list can also be scrolled by directly dragging or flicking the list.

For more information about using List, see section List.