diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-0E695106-4139-4335-A11F-BD04418DD583.dita --- a/Symbian3/SDK/Source/GUID-0E695106-4139-4335-A11F-BD04418DD583.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-0E695106-4139-4335-A11F-BD04418DD583.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,132 +1,131 @@ - - - - - -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.

+ + + + + +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 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