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 -->  <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"><concept id="GUID-114C52FE-C8C5-4418-9C73-CEBB228C7542" xml:lang="en"><title>List

    10 types</title><prolog><metadata><keywords></keywords></metadata></prolog><conbody>

    11 <p>Based on the functionality, the following list categories can be identified:</p>

    12 <ul>

    13 <li><p><xref href="GUID-6B50C0B9-C3CB-4524-909D-7FD096A3F894.dita">Menu list</xref> </p></li>

    14 <li><p><xref href="GUID-0822B030-E776-4BD5-B9C9-23D3821BCE1F.dita">Selection list</xref></p></li>

    15 <li><p><xref href="GUID-ED784025-4E65-4BE9-ADA8-A13427B6EA30.dita">Markable list</xref> </p></li>

    16 <li><p><xref href="GUID-0E695106-4139-4335-A11F-BD04418DD583.dita">Multi-selection

    17 list</xref></p></li>

    18 <li><p><xref href="GUID-F149726A-CC79-42A1-8A25-E15AC14ABE9A.dita">Setting list</xref> </p></li>

    19 <li><p><xref href="GUID-16950F22-F5DE-4D52-8414-544105BA3200.dita">Hierarchical

    20 list</xref> </p></li>

    21 <li><p><xref href="GUID-DAF35D49-9630-4186-A350-E8483693D50D.dita">Hierarchical

    22 colum list</xref></p></li>

    23 <li><p><xref href="GUID-1AA32C40-CDE0-4627-A634-7C07BB1ED67B.dita">Forms</xref></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><title>Using different list

    34 types in C++ applications</title><p>The APIs to use for lists are the Lists

    35 API (for menu, selection, markable, and multi-selection lists) and

    36 the Hierarchical

    37 lists API (for hierarchical and hierarchical column lists). For implementation

    38 information, see Using

    39 the Lists API and Using

    40 the Hierarchical lists API.</p><p>For forms, the API is the Form API. For implementation information, see Using

    41 the Form API</p><p>For list types other than the hierarchical lists,

    42 the flags used to create the different list types in resource files, are described

    43 in Listbox

    44 types in listbox resource definition.</p></section>

    45 </conbody></concept>