19 <p>In a multi-selection list, the user can browse the items and check and |
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 |
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 |
21 adjacent to the item. When the user accepts the list, information about the |
22 marked items is passed to the application.</p> |
22 marked items is passed to the application.</p> |
23 <p>Items are checked and unchecked using the Selection key, and the list is |
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, |
24 accepted with the left softkey <uicontrol>Done</uicontrol>/<uicontrol>OK</uicontrol>. |
25 the Options softkey is not available: one can only check and uncheck items |
25 Note that unlike in a markable list, the Options softkey is not available: |
26 and then accept or cancel the list.</p> |
26 one can only check and uncheck items and then accept or cancel the list.</p> |
27 <fig id="GUID-5ACB3332-F5FF-4BAD-AC49-2B569DB54378"> |
27 <fig id="GUID-5ACB3332-F5FF-4BAD-AC49-2B569DB54378"> |
28 <title>Multi-selection lists: in the main pane (left) and in a setting editor |
28 <title>Multi-selection lists: in the main pane (left) and in a setting editor |
29 (right)</title> |
29 (right)</title> |
30 <image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e62127_href.png" placement="inline"/> |
30 <image href="GUID-3AA34D0C-539D-4D4E-9337-EB5B83AEF4C1_d0e57765_href.png" placement="inline"/> |
31 </fig> |
31 </fig> |
32 <p>The keypad functions for multi-selection lists are as follows:</p> |
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 |
33 <table id="GUID-94AC7390-A39D-48A4-AF4E-FF34EBE44593"><title>Default key event |
34 in multi-selection list</title> |
34 in multi-selection list</title> |
35 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
35 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/> |
74 </row> |
74 </row> |
75 </tbody> |
75 </tbody> |
76 </tgroup> |
76 </tgroup> |
77 </table> |
77 </table> |
78 <p/> |
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 |
79 <table id="GUID-4F77253E-5688-4642-98DD-04CB7FCF38E1-GENID-1-10-1-6-1-1-5-1-8-1-1-9-1-9-1-2-8"><title>The default touch |
80 events for multi-selection list</title> |
80 events for multi-selection list</title> |
81 <tgroup cols="3"> |
81 <tgroup cols="3"> |
82 |
82 |
83 <colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/> |
83 <colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/> |
84 <colspec colname="col3" colwidth="1.19*"/> |
84 <colspec colname="col3" colwidth="1.19*"/> |
124 </row> |
124 </row> |
125 </tbody> |
125 </tbody> |
126 </tgroup> |
126 </tgroup> |
127 </table> |
127 </table> |
128 <section id="GUID-3AF7EE7E-50F2-4714-BFC4-4C4A0033D89D"><title>Using |
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 |
129 multi-selection lists in applications</title><p>The API to use |
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, |
130 for multi-selection lists is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists 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>.</p></section> |
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> |
131 </conbody></concept> |