Symbian3/SDK/Source/GUID-BFEEECCA-190B-4DDE-8A04-4FE918BE8690.dita
changeset 8 ae94777fff8f
parent 7 51a74ef9ed63
child 13 48780e181b38
equal deleted inserted replaced
7:51a74ef9ed63 8:ae94777fff8f
    14 <p>The <uicontrol>Options</uicontrol> menu is a tool that offers the user
    14 <p>The <uicontrol>Options</uicontrol> menu is a tool that offers the user
    15 a set of possible functions in the current context. Pressing the left softkey
    15 a set of possible functions in the current context. Pressing the left softkey
    16 labeled <uicontrol>Options</uicontrol> opens the <uicontrol>Options</uicontrol> menu.</p>
    16 labeled <uicontrol>Options</uicontrol> opens the <uicontrol>Options</uicontrol> menu.</p>
    17 <fig id="GUID-DE323941-E70E-4169-9F67-6E7A11047481">
    17 <fig id="GUID-DE323941-E70E-4169-9F67-6E7A11047481">
    18 <title>Options menu</title>
    18 <title>Options menu</title>
    19 <image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e65577_href.png" placement="inline"/>
    19 <image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e60154_href.png" placement="inline"/>
    20 </fig>
    20 </fig>
    21 <p>The <uicontrol>Options</uicontrol> menu is a menu list displayed in a pop-up
    21 <p>The <uicontrol>Options</uicontrol> menu is a menu list displayed in a pop-up
    22 window. An item is selected by pressing either the left softkey (<uicontrol>Select</uicontrol>)
    22 window. An item is selected by pressing either the left softkey (<uicontrol>Select</uicontrol>)
    23 or the Selection key. The user must either select an item from the list or
    23 or the Selection key. An item can also be selected directly from the list.
    24 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>
    24 The user must either select an item from the list or cancel the menu; it cannot
    25 <p>The pop-up window is located above the <xref href="GUID-8B137691-7C9E-4085-BFFE-4CFE4A64A091.dita">Control
    25 be left pending during another action (see <xref href="GUID-0BAE2D0E-604B-4A62-B5EB-AC68EAF7F589.dita">Navigating
    26 pane</xref>, and its height is dynamic; the maximum size is approximately
    26 in applications</xref>).</p>
    27 the size of the standard main pane. The content on the screen outside the
    27 <p><uicontrol>Options</uicontrol> menu items that are item-specific and require
    28 menu pop-up is dimmed, except the Control pane.</p>
    28 an item on the screen to be focused, are not displayed in the <b>Options</b> menu
    29 <p>Options menu items that are item-specific and require an item on the screen
    29 unless user has opened the Options menu while navigating the UI with hardware
    30 to be focused, are not displayed in the <b>Options</b> menu unless user has
    30 keys. The item specific commands are hidden in the <b>Options</b> menu while
    31 opened the Options menu while navigating the UI with hardware keys. The item
    31 moving with touch, and are made visible when activating the hardware interaction.
    32 specific commands are hidden in the <b>Options</b> menu while moving with
    32 The item specific commands are not updated or removed, while the <b>Options</b> menu
    33 touch, and are made visible when activating the hardware interaction. The
       
    34 item specific commands are not updated or removed, while the <b>Options</b> menu
       
    35 is open.</p>
    33 is open.</p>
    36 <p>Items in the <uicontrol>Options</uicontrol> menu use the single item layout;
    34 <p>Items in the <uicontrol>Options</uicontrol> menu use the single item layout;
    37 that is, they are text-only. The number of items in the menu is not limited,
    35 that is, they are text-only. The number of items in the menu is not limited,
    38 because the list scrolls as necessary. The <uicontrol>Options</uicontrol> always
    36 because the list scrolls as necessary. The <uicontrol>Options</uicontrol> always
    39 loops, which allows users to easily reach the end of the list.</p>
    37 loops, which allows users to easily reach the end of the list.</p>
    47 <entry valign="top"><p>Feedback</p></entry>
    45 <entry valign="top"><p>Feedback</p></entry>
    48 </row>
    46 </row>
    49 </thead>
    47 </thead>
    50 <tbody>
    48 <tbody>
    51 <row>
    49 <row>
       
    50 
    52 <entry><p>Touch down (no sub-menu for the item)</p></entry>
    51 <entry><p>Touch down (no sub-menu for the item)</p></entry>
    53 <entry><p>No effect <note> Submenu behaves similarly as the main menu.</note></p></entry>
    52 <entry><p>No effect. </p><p><note> Submenu behaves similarly as the main menu.</note></p></entry>
    54 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
    53 <entry><p>Highlight is shown. </p><p>Tactile: Basic list effect and audio
    55 feedback is provided with touch down event.</p></entry>
    54 feedback is provided with touch down event.</p></entry>
    56 </row>
    55 </row>
    57 <row>
    56 <row>
    58 <entry><p>Touch release (no sub-menu for the item)</p></entry>
    57 <entry><p>Touch release (no sub-menu for the item)</p></entry>
    95 </row>
    94 </row>
    96 </tbody>
    95 </tbody>
    97 </tgroup>
    96 </tgroup>
    98 </table>
    97 </table>
    99 <section id="GUID-FF69390C-BA3D-47D5-A0C9-031CBA2464FC"><title>Using
    98 <section id="GUID-FF69390C-BA3D-47D5-A0C9-031CBA2464FC"><title>Using
   100 the Options menu in C++ applications</title><p>The API to use for the <uicontrol>Options</uicontrol> menu
    99 the Options menu in applications</title><p>The API to use for the <uicontrol>Options</uicontrol> menu
   101 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>
   100 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="specs/guides/Options_Menu_API_Specification/Options_Menu_API_Specification.html#Options_Menu_API_Specification.topic3" scope="peer">Using the Options menu API</xref>.</p></section>
   102 </conbody></concept>
   101 </conbody></concept>