diff -r ae94777fff8f -r 59758314f811 Symbian3/PDK/Source/GUID-5B9F25B5-5FE1-4E38-BC8D-A0273F458C36.dita --- a/Symbian3/PDK/Source/GUID-5B9F25B5-5FE1-4E38-BC8D-A0273F458C36.dita Fri Jun 11 12:39:03 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-5B9F25B5-5FE1-4E38-BC8D-A0273F458C36.dita Fri Jun 11 15:24:34 2010 +0100 @@ -1,91 +1,91 @@ - - - - - -Discreet -pop-up -

Discreet pop-up component displays notifications without blocking ongoing -task flows in the UI. When discreet pop-up is displayed, the background is -not dimmed and the user can continue interacting with the underlying application -normally. Discreet pop-up can contain an icon and a maximum of two rows of -text. Pop-up can have simple touch interaction, for example, tapping the pop-up -can open the application.

-

Discreet pop-up can be used to replace following note types:

Discreet pop-up does not replace wait notes, progress notes or the soft -notifications in the home screen. Application can have soft notification on -the home screen and use discreet pop-up to display information of the events -in other parts of the UI.

-

Discreet pop-ups can be displayed in touch and non-touch devices. For non-touch -devices, the touch functionality of the component is disabled.

- -Discreet pop-up - - -

Based on the purpose of use, there are two types of discreet pop-ups:

- New discreet pop-up always overrides old one except local pop-up can -never override global pop-up. -Default touch -events in Discreet pop-up. - - - -

User action

-

State change

-

Tactile feedback

-
- - - -

Touch down and release on discreet pop-up

-

Performs the pop-up specific action, if any is defined. Else, pop-up -is dismissed.

-

If tap performs an action, then basic list effect and audio feedback -is provided with touch down and basic list effect on release events. If pop-up -is dismissed, then touch down provides pop-up effect.

-
- -

Touch down and release outside Discreet pop-up area

-

Application-specific. No effect on pop-up

-

Context specific

-
- -

Touch down and hold on discreet pop-up

-

Pop-up is displayed on the screen until the user releases the finger -and the pop-up specific action is performed, or pop-up is dismissed if no -action defined. In case pop-up is replaced with another discreet pop-up -while touch down action, touch release has no effect.

-

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

  • -
  • If touch release performs an action, then basic list effect is provided -with it. If it closes the pop-up, then pop-up effect is provided.

  • -
  • If there is no action defined for touch release, then no tactile feedback -on touch release is provided.

  • -

-
- - -
-
Using discreet -pop-ups in C++ applicationsThe API to use for the discreet pop-up -is the Discreet Pop-up API.
-
To use a discreet -pop-up in the application, an instance of CAknDiscreetPopup need -not be created; only a static call is required to display the pop-up. The -UI framework handles the creation and destruction of CAknDiscreetPopup instances.
+ + + + + +Discreet +pop-up +

Discreet pop-up component displays notifications without blocking ongoing +task flows in the UI. When discreet pop-up is displayed, the background is +not dimmed and the user can continue interacting with the underlying application +normally. Discreet pop-up can contain an icon and a maximum of two rows of +text. Pop-up can have simple touch interaction, for example, tapping the pop-up +can open the application.

+

Discreet pop-up can be used to replace following note types:

    +
  • Error note

  • +
  • Warning note

  • +
  • Information note

  • +
  • Confirmation note

  • +
Discreet pop-up does not replace wait notes, progress notes or the soft +notifications in the home screen. Application can have soft notification on +the home screen and use discreet pop-up to display information of the events +in other parts of the UI.

+

Discreet pop-ups can be displayed in touch and non-touch devices. For non-touch +devices, the touch functionality of the component is disabled.

+ +Discreet pop-up + + +

Based on the purpose of use, there are two types of discreet pop-ups:

    +
  • Global discreet pop-ups - displayed irrespective of the active +application (always displayed on the top of any active application).

  • +
  • Local discreet pop-ups - displayed only if the application displaying +the note is on the foreground.

  • +

+ New discreet pop-up always overrides old one except local pop-up can +never override global pop-up. +Default touch +events in Discreet pop-up. + + + +

User action

+

State change

+

Tactile feedback

+
+ + + +

Touch down and release on discreet pop-up

+

Performs the pop-up specific action, if any is defined. Else, pop-up +is dismissed.

+

If tap performs an action, then basic list effect and audio feedback +is provided with touch down and basic list effect on release events. If pop-up +is dismissed, then touch down provides pop-up effect.

+
+ +

Touch down and release outside Discreet pop-up area

+

Application-specific. No effect on pop-up

+

Context specific

+
+ +

Touch down and hold on discreet pop-up

+

Pop-up is displayed on the screen until the user releases the finger +and the pop-up specific action is performed, or pop-up is dismissed if no +action defined. In case pop-up is replaced with another discreet pop-up while +touch down action, touch release has no effect.

+

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

  • +
  • If touch release performs an action, then basic list effect is provided +with it. If it closes the pop-up, then pop-up effect is provided.

  • +
  • If there is no action defined for touch release, then no tactile feedback +on touch release is provided.

  • +

+
+ + +
+
Using discreet +pop-ups in applicationsThe API to use for the discreet pop-up is the +Discreet Pop-up API.
+
To use a discreet +pop-up in the application, an instance of CAknDiscreetPopup need +not be created; only a static call is required to display the pop-up. The +UI framework handles the creation and destruction of CAknDiscreetPopup instances.
\ No newline at end of file