2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
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 |
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, |
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". --> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
6 <!-- Initial Contributors: |
6 <!-- Initial Contributors: |
7 Nokia Corporation - initial contribution. |
7 Nokia Corporation - initial contribution. |
8 Contributors: |
8 Contributors: |
9 --> <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-F149726A-CC79-42A1-8A25-E15AC14ABE9A" xml:lang="en"><title>Setting |
9 --> |
10 list</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody> |
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-F149726A-CC79-42A1-8A25-E15AC14ABE9A" xml:lang="en"><title>Setting |
|
13 list</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
11 <p>A setting list is a specific kind of selection list containing setting |
14 <p>A setting list is a specific kind of selection list containing setting |
12 items that the user can adjust. Setting lists are displayed in the main pane.</p> |
15 items that the user can adjust. Setting lists are displayed in the main pane.</p> |
13 <fig id="GUID-5795DABA-71C7-42DE-B3AF-BA532435416A"> |
16 <fig id="GUID-0CDD9A63-4113-4662-BCBA-502FC7CA8FF4"> |
14 <title>Setting list </title> |
17 <title>Setting list </title> |
15 <image href="GUID-D36660AA-1DC1-49B4-870E-F3BA66A734BC_d0e80402_href.png" scale="33" placement="inline"></image> |
18 <image href="GUID-EC7E0C0E-EEB0-45B5-BE4A-11CAF78EC366_d0e90109_href.png" placement="inline"/> |
16 </fig> |
19 </fig> |
17 <p>A setting item can be adjusted by selecting it in the same way as selection |
20 <p>A setting item can be adjusted by selecting it in the same way as selection |
18 list items are selected in general; that is, by pressing the Selection key, |
21 list items are selected in general; that is, by pressing the Selection key, |
19 or choosing the Change command from the Options menu. The main pane then displays |
22 or choosing the Change command from the Options menu. The main pane then displays |
20 the setting item editor where the value can be changed.</p> |
23 the setting item editor where the value can be changed.</p> |
22 setting list: each item displays an attribute text (the title of the setting) |
25 setting list: each item displays an attribute text (the title of the setting) |
23 on one line and the current value on another line within the item. The adjusting |
26 on one line and the current value on another line within the item. The adjusting |
24 and editing functions differ between the setting item types.</p> |
27 and editing functions differ between the setting item types.</p> |
25 <table id="GUID-212B8C90-F3AC-4893-9AF6-19A8B4845F91"><title>Setting item |
28 <table id="GUID-212B8C90-F3AC-4893-9AF6-19A8B4845F91"><title>Setting item |
26 types</title> |
29 types</title> |
27 <tgroup cols="2"><colspec colname="col1"></colspec><colspec colname="col2"></colspec> |
30 <tgroup cols="2"><colspec colname="col1" colwidth="0.41*"/><colspec colname="col2" colwidth="1.59*"/> |
28 <thead> |
31 <thead> |
29 <row> |
32 <row> |
30 <entry>Setting</entry> |
33 <entry>Setting</entry> |
31 <entry>Description</entry> |
34 <entry>Description</entry> |
32 </row> |
35 </row> |
33 </thead> |
36 </thead> |
34 <tbody> |
37 <tbody> |
35 <row> |
38 <row> |
36 <entry><p>Pop-up setting</p></entry> |
39 <entry><p>Pop-up setting</p></entry> |
37 <entry><p>A pop-up setting allows the user to choose one value from a pre-defined |
40 <entry><p>A pop-up setting allows the user to choose one value from a pre-defined |
38 list. The setting editor displays the available values in a menu list.A pop-up |
41 list. The setting editor displays the available values in a menu list. A pop-up |
39 setting may also allow the user to enter a new textual value in addition to |
42 setting may also allow the user to enter a new textual value in addition to |
40 the pre-defined values. In that case, the last option is named Other (or equivalent), |
43 the pre-defined values. In that case, the last option is named Other (or equivalent), |
41 and selecting it opens a Data query for entering the new value.</p></entry> |
44 and selecting it opens a Data query for entering the new value.</p></entry> |
42 </row> |
45 </row> |
43 <row> |
46 <row> |
60 right keys.</p></entry> |
63 right keys.</p></entry> |
61 </row> |
64 </row> |
62 </tbody> |
65 </tbody> |
63 </tgroup> |
66 </tgroup> |
64 </table> |
67 </table> |
65 <fig id="GUID-D919C463-A143-4C05-AD2E-0983291F4658"> |
68 <fig id="GUID-100ECC17-5370-437D-B356-070DC3F1E785"> |
66 <title>Pop-up setting</title> |
69 <title>Pop-up setting</title> |
67 <image href="GUID-A0FF8339-E322-4D22-A800-E90467E5C952_d0e80485_href.png" scale="33" placement="inline"></image> |
70 <image href="GUID-DFBBA71F-0042-4303-B66F-0D291106B655_d0e90192_href.png" placement="inline"/> |
68 </fig> |
71 </fig> |
69 <fig id="GUID-DB28DFCD-006C-4828-BDAC-CC9594AE4768"> |
72 <fig id="GUID-FE7CEFF0-1929-46D5-906B-B65C4CC909BF"> |
70 <title>Multi-selection setting</title> |
73 <title>Multi-selection setting</title> |
71 <image href="GUID-7E69FAA4-2198-4428-BD26-96C4020E2077_d0e80493_href.png" scale="33" placement="inline"></image> |
74 <image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e90200_href.png" placement="inline"/> |
72 </fig> |
75 </fig> |
73 <fig id="GUID-B3D4C80C-7BD8-441F-AEB6-B186022E6A0A"> |
76 <fig id="GUID-9391502B-9B3E-417C-98D4-9962B88E9C97"> |
74 <title>Text setting</title> |
77 <title>Text setting</title> |
75 <image href="GUID-AA9552C9-6223-459C-A8F9-770ECFCEFBDD_d0e80501_href.png" scale="33" placement="inline"></image> |
78 <image href="GUID-F161C184-2016-4331-A57C-78C753453EFE_d0e90208_href.png" placement="inline"/> |
76 </fig> |
79 </fig> |
77 <fig id="GUID-4A642EAD-6C40-407A-A1C1-408B9331A1DA"> |
80 <fig id="GUID-C8EFE352-7D5B-4199-B6C9-A9F9DEBFEF53"> |
78 <title>Slider setting</title> |
81 <title>Slider setting</title> |
79 <image href="GUID-967E277E-67FC-4F98-B775-06C9BFC09926_d0e80509_href.png" scale="33" placement="inline"></image> |
82 <image href="GUID-D8D65830-CC9D-4E9F-A206-34BB077E89E6_d0e90216_href.png" placement="inline"/> |
80 </fig> |
83 </fig> |
81 <p>By default, in a setting editor, the keypad functions are as follows:</p> |
84 <p>By default, in a setting editor, the keypad functions are as follows:</p> |
82 <table id="GUID-1181AD52-5BAD-4F44-A0A1-EA930F63E1AC"><title>Default key events |
85 <table id="GUID-1181AD52-5BAD-4F44-A0A1-EA930F63E1AC"><title>Default key events |
83 in setting editor</title> |
86 in setting editor</title> |
84 <tgroup cols="2"><colspec colname="col1"></colspec><colspec colname="col2"></colspec> |
87 <tgroup cols="2"><colspec colname="col1" colwidth="0.32*"/><colspec colname="col2" colwidth="1.68*"/> |
85 <thead> |
88 <thead> |
86 <row> |
89 <row> |
87 <entry>Key</entry> |
90 <entry>Key</entry> |
88 <entry>Action</entry> |
91 <entry>Action</entry> |
89 </row> |
92 </row> |
130 ignored; if the value is numeric, it may be adjustable using the Numeric keys.</p></entry> |
133 ignored; if the value is numeric, it may be adjustable using the Numeric keys.</p></entry> |
131 </row> |
134 </row> |
132 <row> |
135 <row> |
133 <entry><p>Other keys</p></entry> |
136 <entry><p>Other keys</p></entry> |
134 <entry><p>Do the default action of the key.</p></entry> |
137 <entry><p>Do the default action of the key.</p></entry> |
|
138 </row> |
|
139 </tbody> |
|
140 </tgroup> |
|
141 </table> |
|
142 <p/> |
|
143 <table id="GUID-02B3DF05-AF93-4E8C-A252-DCACBC02311C"><title>Default touch |
|
144 events to setting list</title> |
|
145 <tgroup cols="3"> |
|
146 |
|
147 <colspec colname="col1" colwidth="0.62*"/><colspec colname="col2" colwidth="1.09*"/> |
|
148 <colspec colname="col3" colwidth="1.28*"/> |
|
149 <thead> |
|
150 <row> |
|
151 <entry valign="top"><p>User action</p></entry> |
|
152 <entry valign="top"><p>State change</p></entry> |
|
153 <entry valign="top"><p>Feedback</p></entry> |
|
154 </row> |
|
155 </thead> |
|
156 <tbody> |
|
157 <row> |
|
158 <entry><p>Touch down</p></entry> |
|
159 <entry><p>No change</p></entry> |
|
160 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio |
|
161 given with touch down event.</p></entry> |
|
162 </row> |
|
163 <row> |
|
164 <entry><p>Touch release</p></entry> |
|
165 <entry><p>The setting item is opened. Exception for only two values in a setting |
|
166 list. Refer to 19.2 Setting item with two available values.</p></entry> |
|
167 <entry><p>Highlight disappears. Tactile: Basic list effect given with touch |
|
168 release event.</p></entry> |
|
169 </row> |
|
170 <row> |
|
171 <entry><p>Touch down and hold</p></entry> |
|
172 <entry><p>Inactive</p></entry> |
|
173 <entry><p>Tactile: No effect</p></entry> |
|
174 </row> |
|
175 <row> |
|
176 <entry><p>Touch down and move</p></entry> |
|
177 <entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
178 and flicking</xref> events</p></entry> |
|
179 <entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging |
|
180 and flicking</xref> events.</p></entry> |
135 </row> |
181 </row> |
136 </tbody> |
182 </tbody> |
137 </tgroup> |
183 </tgroup> |
138 </table> |
184 </table> |
139 <p>In the setting editor, the Navi pane is empty, or in case of a text editor, |
185 <p>In the setting editor, the Navi pane is empty, or in case of a text editor, |
151 then the setting editor (list) must not be displayed when the user presses |
197 then the setting editor (list) must not be displayed when the user presses |
152 the Selection key; the item's value is changed immediately. However, if the |
198 the Selection key; the item's value is changed immediately. However, if the |
153 user opens the setting item via the <b>Options</b> menu, or if an additional |
199 user opens the setting item via the <b>Options</b> menu, or if an additional |
154 procedure is required (for example a password) before the item's value can |
200 procedure is required (for example a password) before the item's value can |
155 be changed, the list is opened normally.</p> |
201 be changed, the list is opened normally.</p> |
156 <section><title>Using setting lists in |
202 <section id="GUID-EDDFFFA4-DFBC-4455-B6DD-D48ED995A3EF"><title>Using |
157 C++ applications</title><p>The APIs to use for setting lists are the Lists |
203 setting lists in C++ applications</title><p>The APIs to use for setting lists |
158 API and the Setting |
204 are the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref> and the <xref format="html" href="specs/guides/Setting_Pages_API_Specification/Setting_Pages_API_Specification.html" scope="peer">Setting pages API</xref>. For implementation information, 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> and <xref format="html" href="specs/guides/Setting_Pages_API_Specification/Setting_Pages_API_Specification.html#Setting_Pages_API_Specification.topic3" scope="peer">Using the Setting pages API</xref>.</p></section> |
159 pages API. For implementation information, see Using |
|
160 the Lists API and Using |
|
161 the Setting pages API.</p></section> |
|
162 </conbody></concept> |
205 </conbody></concept> |