Package net.rim.device.api.notification

Provides functionality to trigger event notifications through Consequence (i.e., tone, vibration or LED) or NotificationEngineListner (i.e., dialogs or interaction screens on the device).

See:
Description

Interface Summary

Consequence	The Consequence interface responds to notification events.
NotificationsConstants	The NotificationsConstants interface provides constant data values for use with notification functionality.
NotificationsEngineListener	The NotificationsEngineListener interface provides the API used to negotiate the pushing and popping of user interfaces from simple dialogs to complex screens in response to notification events.

Class Summary

NotificationsManager

Manages the handling of events between applications and the notification engine.

Package net.rim.device.api.notification Description

Provides functionality to trigger event notifications through Consequence (i.e., tone, vibration or LED) or NotificationEngineListner (i.e., dialogs or interaction screens on the device).

• The NotificationsConstants interface defines the notification levels used within the Notification package.
• Consequence extends NotificationsConstants, allowing the ability to trigger a notification event.
• The NotificationsEngine class controls the flow of Notification events according to their notification level.
• NotificationsEngineListener is used to send notifications to the screen of the device requiring user input.
• The NotificationManager class brings these classes together and manages the NotificationEngine NotificationEngineListener and Consequence events.

This package enables the programmer to set the priority level of an event, allowing events to supersede others and deferring them with a lower priority as required. It also allows the programmer to ensure that critical notifications are received before casual notifications.