|
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-114C52FE-C8C5-4418-9C73-CEBB228C7542" xml:lang="en"><title>List |
|
13 types</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>Based on the functionality, the following list categories can be identified:</p> |
|
15 <ul> |
|
16 <li><p>Menu list </p></li> |
|
17 <li><p>Selection list</p></li> |
|
18 <li><p>Markable list </p></li> |
|
19 <li><p>Multi-selection list</p></li> |
|
20 <li><p>Setting list </p></li> |
|
21 <li><p>Hierarchical list</p></li> |
|
22 <li><p>Hierarchical column list</p></li> |
|
23 <li><p>Forms</p></li> |
|
24 </ul> |
|
25 <p>Lists belonging to one category may have different graphical appearances. |
|
26 See <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List layouts</xref> for |
|
27 information about different looking list items.</p> |
|
28 <p>On the whole, list items and command should not be mixed, but in cases |
|
29 where some command in a list would significantly boost efficiency and user |
|
30 experience, it is perfectly acceptable to add one command onto the list. It |
|
31 is important that there is no more than one command per list, and that the |
|
32 command is placed as the first item on that list.</p> |
|
33 <section id="GUID-6EF8CB10-EDF4-4457-86D8-F0DDD5ECFEAD"><title>Using |
|
34 different list types in C++ applications</title><p>The APIs to use for lists |
|
35 are the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref> (for menu, selection, markable, and multi-selection |
|
36 lists) and the <xref format="html" href="specs/guides/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html" scope="peer">Hierarchical lists API</xref> (for hierarchical and hierarchical |
|
37 column lists). 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/Hierarchical_Lists_API_Specification/Hierarchical_Lists_API_Specification.html#Hierarchical_Lists_API_Specification.topic3" scope="peer">Using the Hierarchical lists API</xref>.</p><p>For forms, the |
|
38 API is the <xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html" scope="peer">Form API</xref>. For implementation information, see <xref format="html" href="specs/guides/Form_API_Specification/Form_API_Specification.html#Form_API_Specification.topic3" scope="peer">Using the Form API</xref></p><p>For list types other |
|
39 than the hierarchical lists, the flags used to create the different list types |
|
40 in resource files, are described in <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html#Lists_API_Specification.topic2.2.6" scope="peer">Listbox types in listbox resource definition</xref>.</p></section> |
|
41 <example><p/><p><b>See also</b>:</p></example> |
|
42 </conbody></concept> |