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-13DEE42F-3EAB-4EB7-9CE1-C4930BCACE01" xml:lang="en"><title>List query</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    13 <p>A List query offers a list of predefined choices for the user. It can be

    14 used when more than two options must be offered to the user. There is a prompt

    15 text (optional) on top of the window, and a list of options to choose from.</p>

    16 <p>The list in a List query is a menu list: the user can select an item or

    17 dismiss the query; the Options menu is not available. The default softkey

    18 labels are OK on the left and Cancel on the right, the actual texts can be

    19 specific to the context. The Selection key causes the same action as the left

    20 softkey.</p>

    21 <p>Any list item layout suitable for menu lists can be used; see <xref href="GUID-CB548959-A1D6-4585-B8E3-B09E37E0CB43.dita">List

    22 layouts</xref>.</p>

    23 <fig id="GUID-C40BEE37-FF71-442B-A1CF-7E6CCA2157F6">

    24 <title>List query </title>

    25 <image href="GUID-84B088C0-7013-4B6A-BA34-8F022E38E822_d0e86889_href.png" scale="40" placement="inline"/>

    26 </fig>

    27 <p>The number of items in the list should be kept low, so that all items can

    28 be seen without scrolling.</p>

    29 <section><title>Using list queries in

    30 C++ applications</title><p>For implementation information, see <xref href="GUID-7B275129-5EF7-4B27-B603-3BDE2C650A93.dita">Queries</xref>.</p></section>

    31 </conbody></concept>