<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

	Nokia Corporation - initial contribution.

Contributors: 

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

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

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

<ul>

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

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

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

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

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

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

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

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

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

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

<li><p><xref href="GUID-1AA32C40-CDE0-4627-A634-7C07BB1ED67B.dita">Forms</xref></p></li>

</ul>

<p>Lists belonging to one category may have different graphical appearances.

See <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List layouts</xref> for

information about different looking list items.</p>

<p>On the whole, list items and command should not be mixed, but in cases

where some command in a list would significantly boost efficiency and user

experience, it is perfectly acceptable to add one command onto the list. It

is important that there is no more than one command per list, and that the

command is placed as the first item on that list.</p>

<section><title>Using different list

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

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

the Hierarchical

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

information, see Using

the Lists API and Using

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

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

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

in Listbox

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

</conbody></concept>