Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita
changeset 8 ae94777fff8f
parent 0 89d6a7a84779
child 13 48780e181b38
equal deleted inserted replaced
7:51a74ef9ed63 8:ae94777fff8f
    14 <p>Certain Options menus are accessed in other ways than by using the Options
    14 <p>Certain Options menus are accessed in other ways than by using the Options
    15 softkey. The usage of these menus is similar to the normal Options menu. Examples
    15 softkey. The usage of these menus is similar to the normal Options menu. Examples
    16 of such menus are:</p>
    16 of such menus are:</p>
    17 <table id="GUID-C1DF65EC-A38D-4799-8856-9BDD810E6F82"><title>Other Options
    17 <table id="GUID-C1DF65EC-A38D-4799-8856-9BDD810E6F82"><title>Other Options
    18 menus</title>
    18 menus</title>
    19 <tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
    19 <tgroup cols="2"><colspec colname="col1" colwidth="0.38*"/><colspec colname="col2" colwidth="1.62*"/>
    20 <thead>
    20 <thead>
    21 <row>
    21 <row>
    22 <entry>Menu</entry>
    22 <entry>Menu</entry>
    23 <entry>Description</entry>
    23 <entry>Description</entry>
    24 </row>
    24 </row>
    25 </thead>
    25 </thead>
    26 <tbody>
    26 <tbody>
    27 <row>
    27 <row>
    28 <entry><p>Context sensitive Options menu</p></entry>
    28 <entry><p>Context sensitive Options menu</p></entry>
    29 <entry><p>The Selection key opens this context sensitive Options menu when
    29 <entry><p>In touch enabled devices, it is possible that touch release can
    30 there is no single intuitive function (such as opening the item in focus)
    30 open a context specific options menu, if the user is browsing, for example,
    31 for it. The context sensitive Options menu only lists functions that: </p><ul>
    31 a form or an editor or application specific layout. The Selection key can
       
    32 also open this context sensitive <b>Options</b> menu (also known as CS menu)
       
    33 when there is no single intuitive function (such as opening the item in focus)
       
    34 for it. </p><p>The context sensitive Options menu only lists functions that: </p><ul>
    32 <li><p>Affect only the item in focus. </p></li>
    35 <li><p>Affect only the item in focus. </p></li>
    33 <li><p>Could be regarded as potentially intuitive. </p></li>
    36 <li><p>Could be regarded as potentially intuitive. </p></li>
    34 <li><p>Are competing for the topmost place of the menu.</p></li>
    37 <li><p>Are competing for the topmost place of the menu.</p></li>
    35 </ul><p>Other functions can be accessed through the Options softkey. The number
    38 </ul><p>The context-sensitive menu is a shorter version of the normal options
    36 of items in the context sensitive Options menu is usually two or three; it
    39 menu. It contains only the items that act upon the object touched or items
    37 should never be more than four. As an example, in a message editor, the functions
    40 marked. It does not contain state-specific or application-specific items.
    38 in the context sensitive Options menu could be Send and Add recipient.</p><p>In
    41 Context specific options menu should be used only if there is more than one
    39 case there are marked items in a list, the context sensitive Options menu
    42 item in it but not more than four. As an example, in a message editor, the
    40 should include the Mark/Unmark functions. When a list is empty, it may make
    43 functions in the context sensitive Options menu could be Send and Add recipient.</p><p>Other
    41 sense to offer a Create new type of option in the context sensitive Options
    44 functions can be accessed through the Options softkey. </p><p>In case there
    42 menu, but only when it would be an appropriate function in the context.</p></entry>
    45 are marked items in a list, the context sensitive Options menu should include
       
    46 the Mark/Unmark functions. When a list is empty, it may make sense to offer
       
    47 a Create new type of option in the context sensitive Options menu, but only
       
    48 when it would be an appropriate function in the context.</p></entry>
    43 </row>
    49 </row>
    44 <row>
    50 <row>
    45 <entry><p>Editing menu</p></entry>
    51 <entry><p>Editing menu</p></entry>
    46 <entry><p>Opened by pressing the Edit key in a text editor. Contains only
    52 <entry><p>Opened by pressing the Edit key in a text editor. Contains only
    47 editing commands. See <xref href="GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9.dita">Editing
    53 editing commands. See <xref href="GUID-2E0F793F-3D80-4303-AF48-C7341F417DC9.dita">Editing
    48 menu</xref>.</p></entry>
    54 menu</xref>.</p></entry>
    49 </row>
    55 </row>
       
    56 <row>
       
    57 <entry><p>Menu List</p></entry>
       
    58 <entry><p>Menu list is a temporary list, and typically displayed in a pop-up
       
    59 window. Menu lists are used to select an item and do nothing else. Hence,
       
    60 there are no <b>Options</b> menu available when a menu list is being browsed
       
    61 (the Options menu itself is a menu list).</p><p>If a high-priority event,
       
    62 such as an incoming call, occurs when a menu list is open, the list is cancelled
       
    63 and the new event takes control. </p><fig id="GUID-C9A7253A-5120-4EE9-88D6-3772149F9575">
       
    64 <title>Menu list</title>
       
    65 <image href="GUID-8BA0D643-5ED1-4DC4-82EC-C8AA392DCBC4_d0e60783_href.png" placement="inline"/>
       
    66 </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>
       
    67 </row>
       
    68 </tbody>
       
    69 </tgroup>
       
    70 </table>
       
    71 <p/>
       
    72 <p>The default keypad functions in a menu list are the following:</p>
       
    73 <table id="GUID-00EF343D-893A-4EDB-987A-DB5FD2D72F40"><title>Default key events
       
    74 in a menu list</title>
       
    75 <tgroup cols="2">
       
    76 
       
    77 <colspec colname="col1" colwidth="0.56*"/><colspec colname="col2" colwidth="1.44*"/>
       
    78 <thead>
       
    79 <row>
       
    80 <entry>Key</entry>
       
    81 <entry>Action</entry>
       
    82 </row>
       
    83 </thead>
       
    84 <tbody>
       
    85 <row>
       
    86 <entry><p>Arrow up / down</p></entry>
       
    87 <entry><p>Moves the focus in the list.</p></entry>
       
    88 </row>
       
    89 <row>
       
    90 <entry><p>Arrow left / right</p></entry>
       
    91 <entry><p>Ignored (unless there is a submenu; see <xref href="GUID-75553219-500C-487F-8D7E-0FAF48CF1872.dita">Submenus</xref>).</p></entry>
       
    92 </row>
       
    93 <row>
       
    94 <entry><p>Selection key</p></entry>
       
    95 <entry><p>Selects the item, does the associated function.</p></entry>
       
    96 </row>
       
    97 <row>
       
    98 <entry><p>Left softkey (Select)</p></entry>
       
    99 <entry><p>Selects the item, does the associated function.</p></entry>
       
   100 </row>
       
   101 <row>
       
   102 <entry><p>Right softkey (Cancel)</p></entry>
       
   103 <entry><p>Dismisses the menu; returns to the state preceding the opening of
       
   104 the menu.</p></entry>
       
   105 </row>
       
   106 <row>
       
   107 <entry><p>Call creation key, Edit key</p></entry>
       
   108 <entry><p>Ignored.</p></entry>
       
   109 </row>
       
   110 <row>
       
   111 <entry><p>Numeric keypad</p></entry>
       
   112 <entry><p>Ignored.</p></entry>
       
   113 </row>
       
   114 <row>
       
   115 <entry><p>Clear key</p></entry>
       
   116 <entry><p>Ignored.</p></entry>
       
   117 </row>
       
   118 <row>
       
   119 <entry><p>Other keys</p></entry>
       
   120 <entry><p>Dismiss the menu and do the default action of the key.</p></entry>
       
   121 </row>
    50 </tbody>
   122 </tbody>
    51 </tgroup>
   123 </tgroup>
    52 </table></conbody></concept>
   124 </table></conbody></concept>