A class that represents a modeless notification banner.
More...
Inherits MSceneWindowView.
List of all members.
Detailed Description
A class that represents a modeless notification banner.
Overview
- Information banners are UI elements that allow the device to communicate information that the foreground UI is not capable of communicating.
- All information banners are modeless and temporal elements, disappearing after a timeout (or a given time period).
- Information banners can include Progress notification elements within themselves.
- Information banners differ from Incoming event banners that they do not appear on the Home screen notification area.
- Information banners are not interactive, any click onto it dismisses the status banner.
- Information banners can include Labels and Images.
- Information banners determine their size by the amount of contents that they need to display.
- Information banner should not overlap the virtual keyboard: if the VKB is open, the status banner should be positioned above the keyboard.
Interactions
Event | Action | Transition | Tactile feedback | Audio feedback |
- | Appear on screen | Appearing from the background ont the foreground on the defined spot on screen | (optional) | (optional) |
Ignore, do nothing | Up to the designer, default: disappear from screen | Fading on to the background | OPEN: tactile feedback? | OPEN: audio feedback? |
Click on the status banner | Disappear from the screen | Fading to the background | No feedback | No feedback |
Interactive information banner
- An interactive information banner extends the status banner by providing a functionality associated with the status banner.
- An interactive information banner can have only one function associated to it. The button can be enabled using MInfoBanner::setButtonText method.
- Interactive information banners determine their size by the amount of contents that they need to display.
- An interactive information banner may also be used for cancellable operations, containing a "Cancel" button for canceling the process.
- Note that the interactive information banner is still modeless: if you need to have a modal progress operation, use a variant of the Dialog component.
- Do not hack the interactive information banner to be modal!
- Interactive information banner should not overlap the virtual keyboard: if the VKB is open, the interactive information banner should be positioned above the keyboard.
Interactions
Event | Action | Transition | Tactile feedback | Audio feedback |
- | Appear on screen (location up to designer) | OPEN: Transition? | OPEN: tactile feedback? | OPEN: audio feedback? |
Ignore, do nothing | Remain in the screen until the process is finished (no defined timeout time) | - | None, or if the process takes long time a tactile feedback is used to show user that it has finished | - |
Single tap on button inside notification | The functionality has to be defined by application designer | Depending on the function | Press, release | Press, release |
Click on the interactive status banner (outside the button) | Disappear from the screen | Fading to the background | No feedback | No feedback |
- See also:
- MNotification
Constructor & Destructor Documentation
MInfoBannerInformationView::MInfoBannerInformationView |
( |
MInfoBanner * |
controller |
) |
|
Constructor.
- Parameters:
-
| controller | Pointer to the banner's controller |
MInfoBannerInformationView::~MInfoBannerInformationView |
( |
|
) |
[virtual] |
MInfoBannerInformationView::MInfoBannerInformationView |
( |
MInfoBannerInformationViewPrivate & |
dd, |
|
|
MInfoBanner * |
controller | |
|
) |
| | [protected] |
Constructor for derived classes.
- Parameters:
-
| dd | Private class implementation |
| controller | Pointer to the banner's controller |
Member Data Documentation