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-6B50C0B9-C3CB-4524-909D-7FD096A3F894" xml:lang="en"><title>Menu

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

    11 <p>Menu lists are used to select one item from a list and do nothing else;

    12 the Options command is not available when a menu list is being browsed (the

    13 Options menu itself is a menu list).</p>

    14 <p>If a high-priority event, such as an incoming call, occurs when a menu

    15 list is open, the list is cancelled and the new event takes control. These

    16 lists are often displayed inside a pop-up window.</p>

    17 <p>The default keypad functions in a menu list are the following:</p>

    18 <table id="GUID-00EF343D-893A-4EDB-987A-DB5FD2D72F40"><title>Default key events

    19 in a menu list</title>

    20 <tgroup cols="2"><colspec colname="col1"></colspec><colspec colname="col2"></colspec>

    21 <thead>

    22 <row>

    23 <entry>Key</entry>

    24 <entry>Action</entry>

    25 </row>

    26 </thead>

    27 <tbody>

    28 <row>

    29 <entry><p>Arrow up / down</p></entry>

    30 <entry><p>Moves the focus in the list.</p></entry>

    31 </row>

    32 <row>

    33 <entry><p>Arrow left / right</p></entry>

    34 <entry><p>Ignored (unless there is a submenu; see <xref href="GUID-75553219-500C-487F-8D7E-0FAF48CF1872.dita">Submenus</xref>).</p></entry>

    35 </row>

    36 <row>

    37 <entry><p>Selection key</p></entry>

    38 <entry><p>Selects the item, does the associated function.</p></entry>

    39 </row>

    40 <row>

    41 <entry><p>Left softkey (Select)</p></entry>

    42 <entry><p>Selects the item, does the associated function.</p></entry>

    43 </row>

    44 <row>

    45 <entry><p>Right softkey (Cancel)</p></entry>

    46 <entry><p>Dismisses the menu; returns to the state preceding the opening of

    47 the menu.</p></entry>

    48 </row>

    49 <row>

    50 <entry><p>Call creation key, Edit key</p></entry>

    51 <entry><p>Ignored.</p></entry>

    52 </row>

    53 <row>

    54 <entry><p>Numeric keypad</p></entry>

    55 <entry><p>Ignored.</p></entry>

    56 </row>

    57 <row>

    58 <entry><p>Clear key</p></entry>

    59 <entry><p>Ignored.</p></entry>

    60 </row>

    61 <row>

    62 <entry><p>Other keys</p></entry>

    63 <entry><p>Dismiss the menu and do the default action of the key.</p></entry>

    64 </row>

    65 </tbody>

    66 </tgroup>

    67 </table>

    68 <fig id="GUID-C7FB4CE3-C252-4BBC-8521-CE23322BDF04">

    69 <title>Options menu</title>

    70 <image href="GUID-C0C1E654-8A7B-4745-A2A9-252B8E57B0E2_d0e54910_href.png" scale="40" placement="inline"></image>

    71 </fig>

    72 <section><title>Using menu lists in C++

    73 applications</title><p>The API to use for menu lists is the Lists

    74 API. For implementation information, see Using

    75 the Lists API.</p></section>

    76 </conbody></concept>