Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 11 Jun 2010 12:39:03 +0100
changeset 8 ae94777fff8f
parent 0 89d6a7a84779
child 13 48780e181b38
permissions -rw-r--r--
Week 23 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 2714, Bug 462.

<?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-C6E29524-AD59-4EBB-9004-13F731FA1F3C" xml:lang="en"><title>Other
Options menus</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Certain Options menus are accessed in other ways than by using the Options
softkey. The usage of these menus is similar to the normal Options menu. Examples
of such menus are:</p>
<table id="GUID-C1DF65EC-A38D-4799-8856-9BDD810E6F82"><title>Other Options
menus</title>
<tgroup cols="2"><colspec colname="col1" colwidth="0.38*"/><colspec colname="col2" colwidth="1.62*"/>
<thead>
<row>
<entry>Menu</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><p>Context sensitive Options menu</p></entry>
<entry><p>In touch enabled devices, it is possible that touch release can
open a context specific options menu, if the user is browsing, for example,
a form or an editor or application specific layout. The Selection key can
also open this context sensitive <b>Options</b> menu (also known as CS menu)
when there is no single intuitive function (such as opening the item in focus)
for it. </p><p>The context sensitive Options menu only lists functions that: </p><ul>
<li><p>Affect only the item in focus. </p></li>
<li><p>Could be regarded as potentially intuitive. </p></li>
<li><p>Are competing for the topmost place of the menu.</p></li>
</ul><p>The context-sensitive menu is a shorter version of the normal options
menu. It contains only the items that act upon the object touched or items
marked. It does not contain state-specific or application-specific items.
Context specific options menu should be used only if there is more than one
item in it but not more than four. As an example, in a message editor, the
functions in the context sensitive Options menu could be Send and Add recipient.</p><p>Other
functions can be accessed through the Options softkey. </p><p>In case there
are marked items in a list, the context sensitive Options menu should include
the Mark/Unmark functions. When a list is empty, it may make sense to offer
a Create new type of option in the context sensitive Options menu, but only
when it would be an appropriate function in the context.</p></entry>
</row>
<row>
<entry><p>Editing menu</p></entry>
<entry><p>Opened by pressing the Edit key in a text editor. Contains only
editing commands. See <xref href="GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9.dita">Editing
menu</xref>.</p></entry>
</row>
<row>
<entry><p>Menu List</p></entry>
<entry><p>Menu list is a temporary list, and typically displayed in a pop-up
window. Menu lists are used to select an item and do nothing else. Hence,
there are no <b>Options</b> menu available when a menu list is being browsed
(the Options menu itself is a menu list).</p><p>If a high-priority event,
such as an incoming call, occurs when a menu list is open, the list is cancelled
and the new event takes control. </p><fig id="GUID-C9A7253A-5120-4EE9-88D6-3772149F9575">
<title>Menu list</title>
<image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e60783_href.png" placement="inline"/>
</fig><p>The API to use for menu lists is the <xref format="html" href="specs/guides/Lists_API_Specification/Lists_API_Specification.html" scope="peer">Lists API</xref>. 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>.</p></entry>
</row>
</tbody>
</tgroup>
</table>
<p/>
<p>The default keypad functions in a menu list are the following:</p>
<table id="GUID-00EF343D-893A-4EDB-987A-DB5FD2D72F40"><title>Default key events
in a menu list</title>
<tgroup cols="2">

<colspec colname="col1" colwidth="0.56*"/><colspec colname="col2" colwidth="1.44*"/>
<thead>
<row>
<entry>Key</entry>
<entry>Action</entry>
</row>
</thead>
<tbody>
<row>
<entry><p>Arrow up / down</p></entry>
<entry><p>Moves the focus in the list.</p></entry>
</row>
<row>
<entry><p>Arrow left / right</p></entry>
<entry><p>Ignored (unless there is a submenu; see <xref href="GUID-75553219-500C-487F-8D7E-0FAF48CF1872.dita">Submenus</xref>).</p></entry>
</row>
<row>
<entry><p>Selection key</p></entry>
<entry><p>Selects the item, does the associated function.</p></entry>
</row>
<row>
<entry><p>Left softkey (Select)</p></entry>
<entry><p>Selects the item, does the associated function.</p></entry>
</row>
<row>
<entry><p>Right softkey (Cancel)</p></entry>
<entry><p>Dismisses the menu; returns to the state preceding the opening of
the menu.</p></entry>
</row>
<row>
<entry><p>Call creation key, Edit key</p></entry>
<entry><p>Ignored.</p></entry>
</row>
<row>
<entry><p>Numeric keypad</p></entry>
<entry><p>Ignored.</p></entry>
</row>
<row>
<entry><p>Clear key</p></entry>
<entry><p>Ignored.</p></entry>
</row>
<row>
<entry><p>Other keys</p></entry>
<entry><p>Dismiss the menu and do the default action of the key.</p></entry>
</row>
</tbody>
</tgroup>
</table></conbody></concept>