Multi-selection +list

diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-0E695106-4139-4335-A11F-BD04418DD583.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-0E695106-4139-4335-A11F-BD04418DD583.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,132 @@ + + + + + +Multi-selection +list +

Multi-selection lists are used when the purpose is to emphasize that it +is possible to select several items from a list at the same time. Typically, +there is an on-going operation that expects one or more items as input. An +example of this is when the user is creating a group, and a list of names +is offered as a multi-selection list.

In a multi-selection list, the user can browse the items and check and +uncheck any number of them. The state of each item is indicated in a checkbox +adjacent to the item. When the user accepts the list, information about the +marked items is passed to the application.

Items are checked and unchecked using the Selection key, and the list is +accepted with the left softkey Done/OK. Note that unlike in a markable list, +the Options softkey is not available: one can only check and uncheck items +and then accept or cancel the list.

+ +Multi-selection lists: in the main pane (left) and in a setting editor +(right) + + +

The keypad functions for multi-selection lists are as follows:

+Default key event +in multi-selection list + + + +Key +Action + + + + +

Arrow up / down

Moves the focus in the list.

+ + +

Arrow left / right

Ignored (can be used to control tabs).

+ + +

Selection key

Marks / unmarks the current item; toggle.

+ + +

Left softkey (Done)

Accepts the list, passes the selections to the application.

+ + +

Right softkey (Cancel)

Cancels the list, returns to the previous state.

+ + +

Clear, Edit, Call creation

Ignored.

+ + +

Numeric keypad

Ignored.

+ + +

Other keys

Do the default action of the key.

+ + + +

+The default touch +events for multi-selection list + + + + + + +
User action
+
State change
+
Feedback
+ + + + +
Touch down
+
No change
+
Highlight is shown.
Tactile: Basic list effect and audio +feedback is provided with touch down event.
+ + +
Touch release
+
The item is marked/unmarked.
+
Highlight disappears.
Tactile: Basic effect is provided with +touch release event.
+ + +
Touch down and hold
+
Inactive
+
Tactile: No effect
+ + +
Touch down and move
+
Refer to Dragging +and flicking events.
+
Tactile: Refer to Dragging +and flicking events.
+ + +
Touch down, move and touch release within the list
+
Refer to Dragging +and flicking events.
Touch release after movement does not mark/unmark +the item.
+
Tactile: Refer to Dragging +and flicking events.
+ + + +
+

Using +multi-selection lists in C++ applications

The API to use for multi-selection +lists is the Lists API. For implementation information, +see Using the Lists API.

+ \ No newline at end of file