diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita --- a/Symbian3/SDK/Source/GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-C4E728B4-3E84-49A4-83CB-DF146420D78A.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,109 +1,107 @@ - - - - - -Stylus -pop-up menu -

Stylus pop-up menu is the primary menu for showing item-specific options. -Item-specific options are placed in the stylus pop-up menu that is activated -with touch down and hold on an item. It can be attached to almost all the -items.

- -Stylus pop-up menu opened from a preview pop-up. A tap on any other -name or even anywhere else on the screen closes the stylus pop-up menu without -moving the focus. - - -

It is a separate pop-up mainly used when a view cannot offer dynamic functions, -and the pop-up only offers tap-enabled functions. The stylus pop-up menu can -also be used directly on top of applications. For example, on an image in -Browser, the stylus pop-up menu can be used for offering Save as… and -similar options.

-

Following are the guidelines to be followed while designing the menu:

- -

Background is not dimmed when the stylus pop-up menu is shown. The menu -disappears automatically after six seconds (or as soon as the user selects -an item or taps outside the pop-up area).

-

The stylus pop-up menu is scrollable and a scrollbar is added if the number -of items exceeds what fits the component.

-Default touch -events for Stylus pop-up menu - - - -

User action

-

State change

-

Feedback

-
- - - -

Touch down

-

No effect

-

Highlight is shown.

Tactile: Basic list effect and audio -feedback is provided with touch down event.

-
- -

Touch release

-

The item is activated.

-

Highlight disappears and stylus pop-up is closed.

Tactile: -Basic list effect is provided with touch release event.

-
- -

Touch down and hold

-

Inactive

-

Tactile: No effect

-
- -

Touch down and move inside the stylus pop-up

-

Refer to Dragging -and flicking events

-

Tactile: Refer to Dragging -and flicking events.

-
- -

Touch down and move out of the stylus pop-up menu

-

Refer to Dragging -and flicking events

-

Tactile: Refer to Dragging -and flicking events.

-
- -

Touch down and release out of menu area

-

Stylus pop-up menu disappears. No selection is made.

-

Tactile: Opens via long touch, provides only the increasing long -touch effect during the touch down and hold event. No additional pop-up effect -is provided when the menu opens.

-
- -

Touch down and move horizontally

-

Inactive

-

Highlight stays on the item that is touched down before moving horizontally.

Tactile: -No effect

-
- - -
-
Using -stylus pop-up menus in C++ applications

The API to use for creating -a stylus pop-up menu is the Stylus -pop-up menu API.

For implementation information, see Displaying -commands in a context menu.

+ + + + + +Stylus +pop-up menu +

Stylus pop-up menu is the primary menu for showing item-specific options. +Application only needs to tag items to be item-specific and the application +framework handles the remaining tasks. Item-specific options can +be attached to almost all the items.

+ +Stylus pop-up menu opened from a list. + + +

Stylus pop-up is mainly used to offer dynamic functions, and the functions +supported by touch-enabled devices. The stylus pop-up menu can also be used +directly on top of applications. For example, on an image in Browser, the +stylus pop-up menu can be used for offering Save as… and +similar options.

+

Following are the guidelines to be followed while designing the menu:

+
    +
  • Item-specific pop-up menu should not be used with buttons and multi-selection +list or grid items.

  • +
  • Stylus pop-up menu should have only six items.

  • +
  • If used for items other than item-specific menu items, it is recommended +to open the pop-up with touch down and hold.

  • +
  • Stylus pop-up menu has no sub-menus.

  • +
  • Functions that are performed via touch down and release are not duplicated +in the stylus pop-up menu. For example, 'Open' or 'Change' should not be in +the stylus pop-up menu.

  • +
+

Background is not dimmed when the stylus pop-up menu is shown. The menu +disappears automatically after six seconds (or as soon as the user selects +an item or taps outside the pop-up area).

+

The stylus pop-up menu is scrollable and a scrollbar is added if the number +of items exceeds what fits the component.

+Default touch +events for Stylus pop-up menu + + + +

User action

+

State change

+

Feedback

+
+ + + +

Touch down

+

No effect

+

Highlight is shown.

Tactile: Basic list effect and audio +feedback is provided with touch down event.

+
+ +

Touch release

+

The item is activated.

+

Highlight disappears and stylus pop-up is closed.

Tactile: +Basic list effect is provided with touch release event.

+
+ +

Touch down and hold

+

Inactive

+

Tactile: No effect

+
+ +

Touch down and move inside the stylus pop-up

+

Refer to Dragging +and flicking events

+

Tactile: Refer to Dragging +and flicking events.

+
+ +

Touch down and move out of the stylus pop-up menu

+

Refer to Dragging +and flicking events

+

Tactile: Refer to Dragging +and flicking events.

+
+ +

Touch down and release out of menu area

+

Stylus pop-up menu disappears. No selection is made.

+

Tactile: Opens via long touch, provides only the increasing long +touch effect during the touch down and hold event. No additional pop-up effect +is provided when the menu opens.

+
+ +

Touch down and move horizontally

+

Inactive

+

Highlight stays on the item that is touched down before moving horizontally.

Tactile: +No effect

+
+ + +
+
Using +stylus pop-up menus in applications

The API to use for creating +a stylus pop-up menu is the Stylus +pop-up menu API.

For implementation information, see Displaying +commands in a context menu.

\ No newline at end of file