©
本文档使用
php.cn手册 发布
NotificationManager
版本:Android 4.0 r1
结构
继承关系
public class NotificationManager extends Object
java.lang.Object
android.app.NotificationManager
类概述
该类用来向用户通知发生的事情。用来告诉用户在后台发生的某些事情。
通知有下列一些形式:
l 在状态栏中显示一个图片,可以通过launcher来访问(当用户点击该图片会启动一个预先定义好的intent)
l 打开或者闪烁设备上的LED灯
l 或者通知用户通过闪烁的背光灯、播放声音或者震动
每个通知方法接受一个整型的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 一个通知对象用来描述向用户展示什么信息,不能为空。
补充
文章精选
Android中Notification详解【android进化三十五】