Nokia Corporation - initial contribution.

-->

<!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>

<image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e93282_href.png" placement="inline"/>

<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>

<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>