Collapse all Symbian^3 Product Developer Library

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.

Figure 1. 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.

Note: New discreet pop-up always overrides old one except local pop-up can never override global pop-up.

Table 1. 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 applications

The 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.

Parent topic: Pop-ups