|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-0E695106-4139-4335-A11F-BD04418DD583" xml:lang="en"><title>Multi-selection |
|
13 list</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Multi-selection lists are used when the purpose is to emphasize that it |
|
15 is possible to select several items from a list at the same time. Typically, |
|
16 there is an on-going operation that expects one or more items as input. An |
|
17 example of this is when the user is creating a group, and a list of names |
|
18 is offered as a multi-selection list.</p> |
|
19 <p>In a multi-selection list, the user can browse the items and check and |
|
20 uncheck any number of them. The state of each item is indicated in a checkbox |
|
21 adjacent to the item. When the user accepts the list, information about the |
|
22 marked items is passed to the application.</p> |
|
23 <p>Items are checked and unchecked using the Selection key, and the list is |
|
24 accepted with the left softkey Done/OK. Note that unlike in a markable list, |
|
25 the Options softkey is not available: one can only check and uncheck items |
|
26 and then accept or cancel the list.</p> |
|
27 <fig id="GUID-5ACB3332-F5FF-4BAD-AC49-2B569DB54378"> |
|
28 <title>Multi-selection lists: in the main pane (left) and in a setting editor |
|
29 (right)</title> |
|
30 <image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e62127_href.png" placement="inline"/> |
|
31 </fig> |
|
32 <p>The keypad functions for multi-selection lists are as follows:</p> |
|
33 <table id="GUID-94AC7390-A39D-48A4-AF4E-FF34EBE44593"><title>Default key event |
|
34 in multi-selection list</title> |
|
35 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
|
36 <thead> |
|
37 <row> |
|
38 <entry>Key</entry> |
|
39 <entry>Action</entry> |
|
40 </row> |
|
41 </thead> |
|
42 <tbody> |
|
43 <row> |
|
44 <entry><p>Arrow up / down</p></entry> |
|
45 <entry><p>Moves the focus in the list.</p></entry> |
|
46 </row> |
|
47 <row> |
|
48 <entry><p>Arrow left / right</p></entry> |
|
49 <entry><p>Ignored (can be used to control tabs).</p></entry> |
|
50 </row> |
|
51 <row> |
|
52 <entry><p>Selection key</p></entry> |
|
53 <entry><p>Marks / unmarks the current item; toggle.</p></entry> |
|
54 </row> |
|
55 <row> |
|
56 <entry><p>Left softkey (Done)</p></entry> |
|
57 <entry><p>Accepts the list, passes the selections to the application.</p></entry> |
|
58 </row> |
|
59 <row> |
|
60 <entry><p>Right softkey (Cancel)</p></entry> |
|
61 <entry><p>Cancels the list, returns to the previous state.</p></entry> |
|
62 </row> |
|
63 <row> |
|
64 <entry><p>Clear, Edit, Call creation</p></entry> |
|
65 <entry><p>Ignored.</p></entry> |
|
66 </row> |
|
67 <row> |
|
68 <entry><p>Numeric keypad</p></entry> |
|
69 <entry><p>Ignored.</p></entry> |
|
70 </row> |
|
71 <row> |
|
72 <entry><p>Other keys</p></entry> |
|
73 <entry><p>Do the default action of the key.</p></entry> |
|
74 </row> |
|
75 </tbody> |
|
76 </tgroup> |
|
77 </table> |
|
78 <p/> |
|
79 <table id="GUID-4F77253E-5688-4642-98DD-04CB7FCF38E1-GENID-1-8-1-6-1-1-5-1-11-1-1-6-1-2-8"><title>The default touch |
|
80 events for multi-selection list</title> |
|
81 <tgroup cols="3"> |
|
82 |
|
83 <colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/> |
|
84 <colspec colname="col3" colwidth="1.19*"/> |
|
85 <thead> |
|
86 <row> |
|
87 <entry valign="top"><p>User action</p></entry> |
|
88 <entry valign="top"><p>State change</p></entry> |
|
89 <entry valign="top"><p>Feedback</p></entry> |
|
90 </row> |
|
91 </thead> |
|
92 <tbody> |
|
93 <row> |
|
94 <entry><p>Touch down</p></entry> |
|
95 <entry><p>No change</p></entry> |
|
96 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio |
|
97 feedback is provided with touch down event.</p></entry> |
|
98 </row> |
|
99 <row> |
|
100 <entry><p>Touch release</p></entry> |
|
101 <entry><p>The item is marked/unmarked.</p></entry> |
|
102 <entry><p>Highlight disappears. </p><p>Tactile: Basic effect is provided with |
|
103 touch release event.</p></entry> |
|
104 </row> |
|
105 <row> |
|
106 <entry><p>Touch down and hold</p></entry> |
|
107 <entry><p>Inactive</p></entry> |
|
108 <entry><p>Tactile: No effect</p></entry> |
|
109 </row> |
|
110 <row> |
|
111 <entry><p>Touch down and move</p></entry> |
|
112 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
113 and flicking</xref> events.</p></entry> |
|
114 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
115 and flicking</xref> events.</p></entry> |
|
116 </row> |
|
117 <row> |
|
118 <entry><p>Touch down, move and touch release within the list</p></entry> |
|
119 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
120 and flicking</xref> events.</p><p>Touch release after movement does not mark/unmark |
|
121 the item.</p></entry> |
|
122 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
123 and flicking</xref> events.</p></entry> |
|
124 </row> |
|
125 </tbody> |
|
126 </tgroup> |
|
127 </table> |
|
128 <section id="GUID-3AF7EE7E-50F2-4714-BFC4-4C4A0033D89D"><title>Using |
|
129 multi-selection lists in C++ applications</title><p>The API to use for multi-selection |
|
130 lists is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. For implementation information, |
|
131 see <xref format="htrml" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic3" scope="peer">Using the Lists API</xref>.</p></section> |
|
132 </conbody></concept> |