diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,102 @@
+<?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-BFEEECCA-190B-4DDE-8A04-4FE918BE8690" xml:lang="en"><title>Options
+menu</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>The <uicontrol>Options</uicontrol> menu is a tool that offers the user
+a set of possible functions in the current context. Pressing the left softkey
+labeled <uicontrol>Options</uicontrol> opens the <uicontrol>Options</uicontrol> menu.</p>
+<fig id="GUID-DE323941-E70E-4169-9F67-6E7A11047481">
+<title>Options menu</title>
+<image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e65577_href.png" placement="inline"/>
+</fig>
+<p>The <uicontrol>Options</uicontrol> menu is a menu list displayed in a pop-up
+window. An item is selected by pressing either the left softkey (<uicontrol>Select</uicontrol>)
+or the Selection key. The user must either select an item from the list or
+cancel the menu; it cannot be left pending during another action (see <xref href="GUID-0BAE2D0E-604B-4A62-B5EB-AC68EAF7F589.dita">Navigating in applications</xref>).</p>
+<p>The pop-up window is located above the <xref href="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita">Control
+pane</xref>, and its height is dynamic; the maximum size is approximately
+the size of the standard main pane. The content on the screen outside the
+menu pop-up is dimmed, except the Control pane.</p>
+<p>Options menu items that are item-specific and require an item on the screen
+to be focused, are not displayed in the <b>Options</b> menu unless user has
+opened the Options menu while navigating the UI with hardware keys. The item
+specific commands are hidden in the <b>Options</b> menu while moving with
+touch, and are made visible when activating the hardware interaction. The
+item specific commands are not updated or removed, while the <b>Options</b> menu
+is open.</p>
+<p>Items in the <uicontrol>Options</uicontrol> menu use the single item layout;
+that is, they are text-only. The number of items in the menu is not limited,
+because the list scrolls as necessary. The <uicontrol>Options</uicontrol> always
+loops, which allows users to easily reach the end of the list.</p>
+<table id="GUID-F71BE5D4-D757-476F-811A-E3364937E3DB"><title>Default touch
+events for Options menu</title>
+<tgroup cols="3"><colspec colname="col1" colwidth="0.80*"/><colspec colname="col2" colwidth="1.01*"/><colspec colname="col3" colwidth="1.19*"/>
+<thead>
+<row>
+<entry valign="top"><p>User action</p></entry>
+<entry valign="top"><p>State change</p></entry>
+<entry valign="top"><p>Feedback</p></entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry><p>Touch down (no sub-menu for the item)</p></entry>
+<entry><p>No effect <note> Submenu behaves similarly as the main menu.</note></p></entry>
+<entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down event.</p></entry>
+</row>
+<row>
+<entry><p>Touch release (no sub-menu for the item)</p></entry>
+<entry><p>The focused item is activated and <b>Options</b> menu closed.</p></entry>
+<entry><p>Highlight disappears. </p><p>Tactile: Basic list effect is provided
+with touch release event.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and release (when sub-menu available for the item)</p></entry>
+<entry><p>A submenu is opened. </p><p>The <b>Options</b> menu item for which
+the submenu was opened from (that is, parent item) must be visible.</p></entry>
+<entry><p>The parent item stays highlighted while the submenu is open to show
+the relation between the two. </p><p>The submenu does not have highlight unless
+it was opened with a hardware key. </p><p>Tactile: Basic list effect and audio
+feedback is provided with touch down and basic list effect with release event.
+For pop-up related tactile feedback, normal pop-up effect when opening and
+closing if the theme effects are OFF. If they are ON, then increasing long
+touch is used when opening and pop-up close effect when closing.</p></entry>
+</row>
+<row>
+<entry><p>Touch down on <b>Options</b> menu and move out of the <b>Options</b> menu</p></entry>
+<entry><p>Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events</p></entry>
+<entry><p>Tactile: Refer to <xref href="GUID-7C61D3D7-8FCB-46AB-B2E9-CE1AC68F86DE.dita">Dragging
+and flicking</xref> events.</p></entry>
+</row>
+<row>
+<entry><p>Touch down and release outside the <b>Options</b> menu</p></entry>
+<entry><p>Inactive</p></entry>
+<entry><p>If there is hardware highlight, it disappears. </p><p>Tactile: No
+effect</p></entry>
+</row>
+<row>
+<entry><p>Touch down and release outside menu area when sub-menu is open</p></entry>
+<entry><p>Only the sub-menu is closed, main menu remains open.</p></entry>
+<entry><p>Highlight disappears from the parent menu item. </p><p>Tactile:
+Pop-up effect and sensitive audio feedback is provided with touch down event.
+If theme effects are ON, pop-up close effect is given with touch release.
+Else, no tactile feedback is provided with touch release.</p></entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+<section id="GUID-FF69390C-BA3D-47D5-A0C9-031CBA2464FC"><title>Using
+the Options menu in C++ applications</title><p>The API to use for the <uicontrol>Options</uicontrol> menu
+is the <xref format="html" href="specs/guides/Options_Menu_API_Specification/Options_Menu_API_Specification.html" scope="peer">Options menu API</xref>. For implementation information, see <xref format="html" href="public_specs/GuidesA/Options_Menu_API_Specification/Options_Menu_API_Specification.html#Options_Menu_API_Specification%2etopic3" scope="peer">Using the Options menu API</xref>.</p></section>
+</conbody></concept>
\ No newline at end of file