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 components 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.