The NotificationsConstants interface provides constant data values for use
with notification functionality.
There are a number of different sets of constants defined by this interface:
a) CRITICAL, SENSITIVE, IMPORTANT, CASUAL, DEFAULT_LEVEL refer to UI interactivity levels at
which an application can register itself with the notifications framework. New events are
queued up according to these levels, which means that some events may never actually be
seen by the user. This could possibly happen if we have an event at a high priority
which demands user response (e.g., a calendar event) and a transient event at a lower
level (e.g., a notification that a new chess move was received) that is only meant to be
seen for a set amount of time and disappears before the calendar event is handled by the user.
b) OUT_OF_HOLSTER_TRIGGER, MANUAL_TRIGGER refer to how the events are triggered. Out-of-holster
events are triggered automatically by the user action of pulling the device out of the holster.
For example, incoming email messages that arrive while the device is holstered.
Manually-triggered events need to be set off by the interested application. Calendar and alarm
events are good examples.
c) OUT_OF_HOLSTER_ENGINE_STATE, IN_HOLSTER_ENGINE_STATE refer to the
internal state in which the notification engine currently resides. This
should be of interest to implementors of NotificationEngineListener because
it might help the listeners with their event-handling logic to know
which state the engine is currently in.
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Context key to indicate addresscard mapped to incoming message/call
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
CASUAL
public static final int CASUAL
Casual notification level.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
CONTINUOUS_REPEAT
public static final int CONTINUOUS_REPEAT
Repeat the alert continuously. Set _repeatCount to CONTINUOUS_REPEAT
in the AlertEngine to play an alert endlessly.
Since:
JDE 4.3.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
CRITICAL
public static final int CRITICAL
Critical notification level.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
CUSTOM_TUNE_NAME
public static final long CUSTOM_TUNE_NAME
Context key to indicate there is a custom tune for this incoming message/call
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
DEFAULT_LEVEL
public static final int DEFAULT_LEVEL
Default notification level.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
FORCE_NO_REPEAT_NOTIFICATIONS_FLAG
public static final int FORCE_NO_REPEAT_NOTIFICATIONS_FLAG
Flag for forcing repeat notifications to be turned off.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
FORCED
public static final int FORCED
Forced Notification
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
IMPORTANT
public static final int IMPORTANT
Important notification level.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
IN_HOLSTER_ENGINE_STATE
public static final int IN_HOLSTER_ENGINE_STATE
In-holster engine state.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
MANUAL_TRIGGER
public static final int MANUAL_TRIGGER
Manual event trigger.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NO_RELATED_SOURCE
public static final long NO_RELATED_SOURCE
Constant to indicate there is no related source.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NO_SOURCE
public static final long NO_SOURCE
Constant to indicate there is no source.
Since:
JDE 4.2.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NOTIFICATION_LEVEL_KEY
public static final long NOTIFICATION_LEVEL_KEY
Context key to indicate level of notifiation
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NOTIFICATION_PRIVATE_FLAG_KEY
public static final long NOTIFICATION_PRIVATE_FLAG_KEY
Context key to indicate repeat notifications
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NOTIFICATION_REPEAT_COUNT
public static final long NOTIFICATION_REPEAT_COUNT
Context KEY to indicate repeat notifications
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
NOTIFICATION_REPEAT_DELAY
public static final long NOTIFICATION_REPEAT_DELAY
Context KEY to indicate delay between repeat notifications
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
OUT_OF_HOLSTER_ENGINE_STATE
public static final int OUT_OF_HOLSTER_ENGINE_STATE
Out-of-holster engine state.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
OUT_OF_HOLSTER_TRIGGER
public static final int OUT_OF_HOLSTER_TRIGGER
Out-of-holster event trigger.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
SENSITIVE
public static final int SENSITIVE
Sensitive notification level.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
STOP_CONDITIONS
public static final long STOP_CONDITIONS
Context KEY to indicate stop conditions
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.