Android中文API（145） —— NotificationManager

NotificationManager

 

版本：Android 4.0 r1

 

结构

继承关系

public class NotificationManager extends Object

        

java.lang.Object

android.app.NotificationManager

 

类概述

该类用来向用户通知发生的事情。用来告诉用户在后台发生的某些事情。

通知有下列一些形式：

*   在状态栏中显示一个图片，可以通过launcher来访问（当用户点击该图片会启动一个预先定义好的intent）

*   打开或者闪烁设备上的LED灯

*   或者通知用户通过闪烁的背光灯、播放声音或者震动

每个通知方法接受一个整型的id，还有一个字符串的标签参数可选，该参数可以为空。这两个参数被用来组成一对（tag，id）或者如果标签没有指定则为（null，id）。这对参数用来在应用程序和系统中标识该通知。所以这对参数在你的程序中应该唯一。

如果你在通知方法时传递该参数对（tag，id）和一些新的通知参数，如果（tag，id）对应的通知应经在运行，则对应的通知会被更新。举个例子来说：如果你传递一个新的状态栏图片，状态栏中老的图片会被新的图片所替换。该（tag，id）也用来传递给cancel（Id）或者cancel（String，int）方法来清除这些通知。

NotificationManager不用实例化，可以通过getSystemService（String）方法来获得。

开发者指南：创建一个通知，请阅读Status Bar Notifications开发者指南。

 

公共方法

public void cancel (int id)

      移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。

参数

                            id      通知的id

                  

public void cancel (String tag，int id)

移除一个已经显示的通知，如果该通知是短暂的，会隐藏视图；如果通知是持久的，会从状态栏中移除。        

参数

                            tag   通知的标签

                            id      通知的id

 

public void cancelAll ()

      移除所有的已经显示的通知，详细行为见cancel(int)。

 

public void notify (int id，Notification notification)

      提交一个通知在状态栏中显示。如果拥有相同id的通知已经被提交而且没有被移除，该方法会用新的信息来替换之前的通知。

参数

                   id      应用中通知的唯一标识

notification       一个通知对象用来描述向用户展示什么信息，不能为空

 

public void notify (String tag，int id，Notification notification)

提交一个通知在状态栏中显示。如果拥有相同标签和相同id的通知已经被提交而且没有被移除，该方法会用更新的信息来替换之前的通知。

参数

         tag   用来标识通知的字符串，可以为空。

                            id      应用中通知的唯一标识。

                            notification       一个通知对象用来描述向用户展示什么信息，不能为空。