Android中文API(145) —— NotificationManager

NotificationManager

 

版本:Android 4.0 r1

 

结构

继承关系

public class NotificationManager extends Object

        

java.lang.Object

android.app.NotificationManager

 

类概述

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

通知有下列一些形式:

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

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

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

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

如果你在通知方法时传递该参数对(tagid)和一些新的通知参数,如果(tagid)对应的通知应经在运行,则对应的通知会被更新。举个例子来说:如果你传递一个新的状态栏图片,状态栏中老的图片会被新的图片所替换。该(tagid)也用来传递给cancelId)或者cancelStringint)方法来清除这些通知。

NotificationManager不用实例化,可以通过getSystemServiceString)方法来获得。

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

 

公共方法

public void cancel (int id)

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

参数

                            id      通知的id

                  

public void cancel (String tagint id)

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

参数

                            tag   通知的标签

                            id      通知的id

public void cancelAll ()

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

public void notify (int idNotification notification)

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

参数

                   id      应用中通知的唯一标识

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

public void notify (String tagint idNotification notification)

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

参数

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

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

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

猜你喜欢

转载自lotuo.iteye.com/blog/1974044