diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-C6E29524-AD59-4EBB-9004-13F731FA1F3C.dita --- 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 @@ - - - - - -Other -Options menus -

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:

-Other Options -menus - - - -Menu -Description - - - - -

Context sensitive Options menu

-

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:

    -
  • Affect only the item in focus.

  • -
  • Could be regarded as potentially intuitive.

  • -
  • Are competing for the topmost place of the menu.

  • -

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.

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.

-
- -

Editing menu

-

Opened by pressing the Edit key in a text editor. Contains only -editing commands. See Editing -menu.

-
- - + + + + + +Other +Options menus +

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:

+
Other Options +menus + + + +Menu +Description + + + + +

Context sensitive Options menu

+

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 Options menu (also known as CS 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:

    +
  • Affect only the item in focus.

  • +
  • Could be regarded as potentially intuitive.

  • +
  • Are competing for the topmost place of the menu.

  • +

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.

Other +functions can be accessed through the Options softkey.

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.

+
+ +

Editing menu

+

Opened by pressing the Edit key in a text editor. Contains only +editing commands. See Editing +menu.

+
+ +

Menu List

+

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 Options menu available when a menu list is being browsed +(the Options menu itself is a menu list).

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.

+Menu list + +

The API to use for menu lists is the Lists API. For implementation information, see Using the Lists API.

+
+ + +
+

+

The default keypad functions in a menu list are the following:

+Default key events +in a menu list + + + + + +Key +Action + + + + +

Arrow up / down

+

Moves the focus in the list.

+
+ +

Arrow left / right

+

Ignored (unless there is a submenu; see Submenus).

+
+ +

Selection key

+

Selects the item, does the associated function.

+
+ +

Left softkey (Select)

+

Selects the item, does the associated function.

+
+ +

Right softkey (Cancel)

+

Dismisses the menu; returns to the state preceding the opening of +the menu.

+
+ +

Call creation key, Edit key

+

Ignored.

+
+ +

Numeric keypad

+

Ignored.

+
+ +

Clear key

+

Ignored.

+
+ +

Other keys

+

Dismiss the menu and do the default action of the key.

+
+ +
\ No newline at end of file