android.app
Class NotificationManager

java.lang.Object
  android.app.NotificationManager

public class NotificationManager
extends Object

Class to notify the user of events that happen. This is how you tell the user that something has happened in the background. Notifications can take different forms:

• A persistent icon that goes in the status bar and is accessible through the launcher, (when the user selects it, a designated Intent can be launched),
• Turning on or flashing LEDs on the device, or
• Alerting the user by flashing the backlight, playing a sound, or vibrating.

Each of the notify methods takes an int id parameter. This id identifies this notification from your app to the system, so that id should be unique within your app. If you call one of the notify methods with an id that is currently active and a new set of notification parameters, it will be updated. For example, if you pass a new status bar icon, the old icon in the status bar will be replaced with the new one. This is also the same id you pass to the cancel(int) method to clear this notification.

You do not instantiate this class directly; instead, retrieve it through Context.getSystemService(java.lang.String).

See Also:

Notification, Context.getSystemService(java.lang.String)

Constructor Summary

NotificationManager(Context context, Handler handler)

Method Summary

void	cancel(int id) Cancel a previously shown notification.
void	cancelAll() Cancel all previously shown notifications.
void	notify(int id, Notification notification) Persistent notification on the status bar,

Methods inherited from class java.lang.Object

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

Constructor Detail

NotificationManager

NotificationManager(Context context,
                    Handler handler)

Method Detail

notify

public void notify(int id,
                   Notification notification)

Persistent notification on the status bar,

Parameters:

id - An identifier for this notification unique within your application.

notification - A Notification object describing how to notify the user, other than the view you're providing. If you pass null, there will be no persistent notification and no flashing, vibration, etc.

cancel

public void cancel(int id)

Cancel a previously shown notification. If it's transient, the view will be hidden. If it's persistent, it will be removed from the status bar.

cancelAll

public void cancelAll()

Cancel all previously shown notifications. See cancel(int) for the detailed behavior.