Android中文API（145） —— NotificationManager

 

前言

　　本章內容android.app.NotifacationManager章節，版本為Android 4.0 r1，翻譯來自："liliang1222"，再次感謝他 ！期待你一起參與翻譯Android的相關資料，聯絡我over140@gmail.com。

 

聲明

　　歡迎轉載，但請保留文章原始出處:) 

　　　　部落格園：http://www.cnblogs.com/

　　　　Android中文翻譯組：http://androidbox.sinaapp.com/

 

 

NotificationManager

譯者署名： liliang1222

版本：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       一個通知對象用來描述向使用者展示什麼資訊，不可為空。

 

補充

文章精選

Android中Notification詳解【android進化三十五】