javax.microedition.lcdui
Class NotificationType

java.lang.Object
  javax.microedition.lcdui.NotificationType

public final class NotificationType
extends java.lang.Object

Represents the Notification type (or category) used for grouping, sorting and filtering Notification objects of the same type. A NotificationType can either be a user defined type, or a standard type (defined as constant fields in this class). Notifications associated with any of the standard types are not required to have a label and image.

The primary purpose of notification types is to make it possible for implementations to group, sort and filter notifications. Additionally, the standard notification types enable localization of Notification labels and/or images.

Note that some standard notification types might not be available for all security domains, depending on the security policy enforced by the implementation.

An implementation MAY :

• display all notifications independent of the NotificationType
• display Notifications grouped and/or sorted by NotificationType
• display the time and date for Notifications of some types
• choose where and how (in the device user interface) each Notification should be displayed, based on NotificationType
• filter whether Notifications should be displayed or not, based on their NotificationType

Notification types have a default image and label associated with the posted Notification. An application can choose to set its own label and/or image for the posted Notification, which will override the default label and/or image. The default label of a standard Notification type SHOULD support localization.

Since:

MIDP 3.0

Field Summary

static NotificationType	CALL The standard notification type for missed calls.
static NotificationType	EMAIL The standard notification type for email messages.
static NotificationType	IM The standard notification type for instant messaging messages.
static NotificationType	MMS The standard notification type for mms messages.
static NotificationType	REMINDER The standard notification type for reminders (typically calendar reminders, or task reminders).
static NotificationType	SMS The standard notification type for sms messages.

Constructor Summary

NotificationType(java.lang.String defaultLabel, Image defaultImage)
Creates a new user defined NotificationType

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CALL

public static final NotificationType CALL

The standard notification type for missed calls.

IM

public static final NotificationType IM

The standard notification type for instant messaging messages.

EMAIL

public static final NotificationType EMAIL

The standard notification type for email messages.

MMS

public static final NotificationType MMS

The standard notification type for mms messages.

SMS

public static final NotificationType SMS

The standard notification type for sms messages.

REMINDER

public static final NotificationType REMINDER

The standard notification type for reminders (typically calendar reminders, or task reminders).

Constructor Detail

NotificationType

public NotificationType(java.lang.String defaultLabel,
                        Image defaultImage)

Creates a new user defined NotificationType

Parameters:

defaultLabel - The default label of this notification type. This label will be used for associated notifications, if no label is set on the notification.

defaultImage - The default image of this notification type. This image will be used for associated notifications, if no image is set on the notification. If the image is mutable, a snapshot of it will be taken.

Throws:

java.lang.NullPointerException - if defaultLabel or defaultImage is null