Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita
changeset 8 ae94777fff8f
parent 0 89d6a7a84779
child 13 48780e181b38
--- a/Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita	Wed Mar 31 11:11:55 2010 +0100
+++ b/Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita	Fri Jun 11 12:39:03 2010 +0100
@@ -1,52 +1,124 @@
-<?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"/><colspec colname="col2"/>
-<thead>
-<row>
-<entry>Menu</entry>
-<entry>Description</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry><p>Context sensitive Options menu</p></entry>
-<entry><p>The Selection key opens this context sensitive Options menu when
-there is no single intuitive function (such as opening the item in focus)
-for it. 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>Other functions can be accessed through the Options softkey. The number
-of items in the context sensitive Options menu is usually two or three; it
-should never be 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>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>
-</tbody>
-</tgroup>
+<?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>
\ No newline at end of file